=== PCIO VIS Member Event ===
Contributors:      pcio
Author:            PCIO
Author URI:        https://www.pcio.dk
Plugin URI:        https://www.pcio.dk/vis-plugins
Tags:              members, events, signup, newsletter, documents
Requires at least: 6.2
Tested up to:      7.0
Requires PHP:      8.1
Stable tag:        1.0.0
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Member and event management for voluntary organizations: members register, event calendar with signups, mailings, newsletters, documents and finance.

== Description ==

PCIO VIS Member Event turns your WordPress site into a complete back office for a voluntary organization or association.

It provides a members register, an event calendar with public sign-ups, e-mail and newsletter tools, a document library and a simple finance journal — all built on native WordPress capabilities so access control works with the roles you already use.

Public pages are served automatically under `/vis/`; no WordPress pages or shortcodes are required to get started:

* **Home** (`/vis/`) — landing page for members.
* **Members** (`/vis/members`) — searchable members directory.
* **Calendar** (`/vis/calendar`) — upcoming events with sign-up.
* **Event** (`/vis/events/{id}`) — event detail page with banner, description and sign-up box.
* **Mails** (`/vis/mails`) — member mailings.
* **Newsletters** (`/vis/newsletters`) — public newsletter archive.
* **Documents** (`/vis/documents`) — document library grouped by type.
* **Finance** (`/vis/finance`) — finance overview for authorized users.

**Roles and capabilities.** The plugin defines a cumulative set of logical roles — Member, Volunteer, Event Manager, Publisher and System Admin — that map to standard WordPress capabilities. Assign them per WordPress role from **Vis → Roles**:

* Register for events
* Create own events
* Edit own events
* Edit all events
* Publish / manage documents
* Manage members
* Manage settings & mails
* Manage finance

**Shortcodes.** For themes that prefer to embed content in ordinary pages, the plugin also ships shortcodes: `[pcio_me_members]`, `[pcio_me_documents]`, `[pcio_me_event]`, `[pcio_me_events]`, `[pcio_me_event_roller]` and `[pcio_me_newsletters]`.

**Extensions.** PCIO VIS Member Event is the core plugin for a family of optional add-ons (gallery, products, tickets, project management, home-owner association tools and Conventus sync). The bundled Dompdf and php-qrcode libraries are shared with those extensions for PDF and QR generation.

== Installation ==

1. Upload the `pcio-vis-member-event` directory to `/wp-content/plugins/`.
2. Activate the plugin in **Plugins** in the WordPress admin.
3. Assign capabilities to your WordPress roles under **Vis → Roles**.
4. Configure plugin options under the **Vis** admin menu.

After activation, if `/vis/` or an event page returns a 404, go to **Settings → Permalinks** and click **Save Changes** to flush the rewrite rules.

== Frequently Asked Questions ==

= Where are the public pages? =

The plugin registers pages automatically under `/vis/` — for example `https://yoursite.com/vis/members` and `https://yoursite.com/vis/calendar`. Individual events are available at `https://yoursite.com/vis/events/{id}`.

= How do I control who can do what? =

Access is based on native WordPress capabilities. Open **Vis → Roles** and grant the plugin's capabilities to your existing WordPress roles. The logical roles (Member, Volunteer, Event Manager, Publisher, System Admin) are cumulative — each level includes the capabilities of the level below.

= A public page returns a 404. =

Go to **Settings → Permalinks** and click **Save Changes** to flush the rewrite rules. This registers the `/vis/` routes.

= Does this require any third-party services? =

No. The core plugin runs entirely on your WordPress site. Optional extensions (such as ticket sales) may integrate with external services.

= How do I uninstall? =

Deactivate and delete the plugin from the WordPress admin. To also remove the data, open your database admin tool and drop these tables (replace `wp_` with your actual table prefix):

* `wp_me_members`
* `wp_me_member_meta`
* `wp_me_member_roles`
* `wp_me_vis_roles`
* `wp_me_events`
* `wp_me_event_signups`
* `wp_me_mails`
* `wp_me_newsletters`
* `wp_me_documents`
* `wp_me_document_types`
* `wp_me_finance_journal`
* `wp_me_sync`

== Upgrade Notice ==
Currently there are no updates available. New releases will be announced on pcio.dk.

== Screenshots ==

1. Landing page with tiles for each section in the application
2. The calendar page
3. Member list page.
4. Vis admin menues in WordPress admin section.

== Changelog ==

= 1.0.0 =
* Initial release.
* Members register with custom member fields and roles.
* Event calendar with public sign-ups and per-event banner/thumbnail images.
* Member mailings and public newsletter archive.
* Document library grouped by type, backed by the WordPress media library.
* Finance journal.
* Capability-based access control with cumulative logical roles (Vis → Roles).
* Automatic public pages under `/vis/` plus shortcodes for embedding in themes.
