=== Event 4 Me ===
Contributors: yewaung
Tags: events, calendar, event registration, tickets, schedule
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.4.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Events, month calendar and past events with add-to-calendar links. Works with any theme, shortcodes and Elementor.

== Description ==

Events in one plugin: what The Events Calendar and Event Skin did together,
without either of them.

= Features =
* Views: list (upcoming, grouped by month), month calendar, past events,
  category pages, search. Address: /events/ (Events > Settings).
* Event page: banner, notice, programme (sessions), prices in 21 currencies,
  registration button, add to calendar (Google, .ics), venue map (Map 4 Me),
  organiser, listings taking part (Directory 4 Me).
* Status: scheduled, postponed, cancelled, moved online; featured events;
  per-event time zone; all-day events.
* Category colours (Events > Categories).
* Colours, corners and texts: Events > Settings > Appearance.
* Shortcode generator: Events > Settings > Shortcodes.
  [event4me_list layout="list|grid|compact" limit="6" category="" when="upcoming|past"]
  [event4me_calendar category="" month="YYYY-MM"]
* Import from The Events Calendar + Event Skin: Events > Settings > Import,
  or wp e4m import-tec. Re-running updates instead of duplicating.
* Works with any theme, classic or block (uses the theme's header and footer).
* Design event pages and the events list with the free Elementor: make a
  template with "Event part" widgets and choose it in Events > Settings >
  General. Without a template the built-in design is used.
* No front-end JavaScript. One stylesheet, loaded only on event pages and
  pages with an event shortcode.

= For add-ons (Ticket 4 Me and others) =
* e4m_event( $id )             all event data, formatted
* e4m_save_event( $data, $id ) create or update an event
* do_action( 'event4me_registration', $event )         inside the price box
* do_action( 'event4me_single_main_after', $event )
* do_action( 'event4me_single_sidebar_after', $event )
* apply_filters( 'event4me_register_button', $html, $event )
* apply_filters( 'event4me_prices', $prices, $id )
* Meta _e4m_capacity (places) is stored for ticketing.
* Queries: meta _e4m_start_utc / _e4m_end_utc (Unix time) are indexed.

== Installation ==

1. Upload the `event4me` folder to `/wp-content/plugins/`, or install the ZIP in Plugins > Add New > Upload.
2. Activate the plugin.
3. Add events in Events > Add new. They appear at /events/.

== Frequently Asked Questions ==

= Can people register on my site? =

Yes, with Form 4 Me: choose "A form on the event page" under Registration. The form can be paid and use the event's ticket price.

= Can I import from The Events Calendar? =

Yes, in TheStickPress > Event 4 Me > Import. Running it again updates events instead of making copies.

== External services ==

"Add to Google Calendar" is a link to calendar.google.com and directions are a link to Google Maps; nothing is sent until the visitor clicks. Event maps come from Map 4 Me (see its notes).

== Screenshots ==

1. Upcoming events with dates, places and prices.
2. Month calendar.
3. An event page with details, programme and registration.
4. Registration: no button, a link (same or new tab) or a form on the event page.

== Changelog ==


= 1.4.0 =
* Changed: all code names now start with event4me_ instead of the short e4m_, so they cannot clash with other plugins (WordPress.org asks for this). Your settings move to the new names on their own; events and categories are unchanged.
= 1.3.0 =
* Registration per event: no button, a link (same or new tab), or a Form 4 Me form on the event page; paid forms use the lowest ticket price.
* Shared TheStickPress look in the dashboard: the same lime and ink colours, cards, switches and buttons as the other 4 Me plugins.
* Every screen starts with a short card that says what it is for and the steps to follow.
* "You have unsaved changes" bar with Save and Discard on settings pages, and a warning before leaving with unsaved changes.
* Tables of rows work the same everywhere: Remove marks a row (with Undo) and it goes when you save; "+ Add" adds a row; built-in rows show a lock that explains why.
* Event prices and programme: removed rows go when you press Update instead of at once.

= 1.2.0 =
* "Taking part" box uses the directory's wording (no fixed "Doctors and hospitals").
* Works in any theme: sizes include padding even when the theme does not set box-sizing (found on Twenty Twenty-Five).
* New 4ME icon (TheStickPress family) in assets/brand (SVG, 128 and 256 px) and on the TheStickPress overview.

= 1.1.0 =
* Shared "TheStickPress" admin menu: the settings are now under TheStickPress (old addresses redirect).
* Design event pages and the events list with the free Elementor ("Event part" widgets).
* One spacing value between boxes; small labels are at least 12 px.
* Coding standards: class file names follow WordPress rules.

== Upgrade Notice ==


= 1.4.0 =
Code names now use the full event4me_ prefix. Settings move automatically.
= 1.3.0 =
Part of the 4 Me family by TheStickPress. See the changelog for what is new.
