Create online announce - nicho92/MtgDesktopCompanion GitHub Wiki

Announces User Guide

Overview

Announces module is the desktop screen used to create, review, update, and delete marketplace announces.

The screen is split into two zones:

  • Top/Left: the announces list (table).
  • Bottom/Right: tabbed details for the selected announce.

Main Toolbar

The toolbar at the top provides the main actions:

Action Purpose Shortcut key
Reload announces from the configured DAO source. U
Create a new announce draft using the default webshop contact. N
Persist all modified announces (only rows marked as updated are saved). S
Delete the selected announce (with confirmation). D
Extend end date of selected announces by 10 days and reactivate if still valid. A

Notes:

  • Save and Delete are enabled only when an announce is selected.
  • A busy indicator is shown while loading/saving in background workers.

Announces Table

The table displays one row per announce with these columns:

  1. id
  2. type
  3. categorie
  4. title
  5. totalPrice
  6. contact
  7. startDate
  8. endDate
  9. status

Selection behavior

Selecting a row automatically populates the right-side tabs:

  • Details tab with announce metadata.
  • Products tab with announce stock items.
  • Contact tab with seller/contact information.
  • GED tab with attached files/images.

Tabs

1) Details

Use this tab to edit the core announce data:

  • Type (transaction direction)
  • Title
  • Description (HTML-capable editor)
  • Start/End dates
  • Total price
  • Currency
  • Category
  • Reduction (%)
  • Contact selector
  • Condition
  • Status

When you click Save, values from this form are written back to the current announce.

2) Products

Manage attached stock items:

  • Add card items
  • Add sealed products
  • Remove selected products

If products are edited and you leave the tab without saving, a warning notification reminds you to save.

3) Contact

Shows editable contact identity and communication fields for the selected announce (name, address, email, phone, website, etc.), including email opt-in and active flags.

4) GED

Attach and manage announce media/documents:

  • Drag-and-drop files
  • Import from URL
  • Import from webcam snapshots

Typical Workflows

Create a new announce

  1. Click New.
  2. Fill data in Details.
  3. Add items in Products.
  4. Optionally adjust Contact and add files in GED.
  5. Click Save.

Refresh announce expiration

  1. Select one or more announces in the table.
  2. Click Update X days.
  3. Click Save to persist the new end dates.

Remove an announce

  1. Select the announce.
  2. Click Delete.
  3. Confirm deletion.

Operational Notes

  • Announces are loaded automatically when the tab is first shown.
  • Long operations (load/save/media upload) run in background workers to keep the UI responsive.
  • Save action persists only announces flagged as updated.

Online website

  • MTGCompanion embbed a web service to expose your announce online. Just launch the webtrader server :