bmltenabled

radius314

Pronounced “my-oh”. Referring to the Spanish word “mayo” which means “May” in English. Mayo Event Manager is a comprehensive WordPress plugin designed to facilitate the management of events with a focus on community engagement and administrative oversight. This plugin allows users to submit events for approval, supports recurring event schedules, and integrates seamlessly with WordPress’s native features like featured images and custom post types. Mayo is meant to be simple, and does not provide all the functionality of a typical event management system. It is designed to be used in conjunction with a BMLT server to provide a simple way to submit events for a specific service body. Also we will not be implementing a calendar view, but rather a list view. There are plenty of other plugins that provide calendar views, and you can make use of the calendar RSS to import the feeds you want.
Dependency on Pretty Permalinks: The REST API utilizes the same URL rewriting functionalities that pretty permalinks employ to map its human-readable routes (like /wp-json/wp/v2/posts) to the appropriate internal processes. If your site uses the “Plain” permalink setting (which is the default in some cases), the REST API endpoint may not function correctly, leading to 404 errors when attempting to access /wp-json/.
<ol>
<li>
Event Submission and Approval:
<ul>
<li>Users can submit events through a public-facing form.</li>
<li>Submitted events are saved as pending, requiring admin approval before they are published.</li>
<li>Admins receive email notifications upon new event submissions, ensuring timely review and approval.</li>
</ul>
</li>
<li>
Recurring Events:
<ul>
<li>Supports daily, weekly, and monthly recurring event patterns.</li>
<li>Users can specify recurrence intervals and end dates.</li>
<li>Recurring events are automatically generated based on the specified pattern.</li>
</ul>
</li>
<li>
Event Details and Customization:
<ul>
<li>Events can include detailed information such as event type, start and end dates, times, and location details.</li>
<li>Supports the use of WordPress’s featured image functionality to visually represent events.</li>
<li>Allows categorization and tagging of events for better organization and filtering.</li>
</ul>
</li>
<li>
Service Body Integration:
<ul>
<li>Integrates with external service bodies, allowing users to associate events with specific service organizations.</li>
<li>Fetches and displays service body information dynamically.</li>
</ul>
</li>
<li>
Email Notifications:
<ul>
<li>Sends email notifications to the site admin when a new event is submitted.</li>
<li>Ensures that admins are promptly informed of new submissions for review.</li>
</ul>
</li>
<li>
REST API Integration:
<ul>
<li>Provides REST API endpoints for submitting events, retrieving event details, and managing settings.</li>
<li>Facilitates integration with other systems and custom front-end applications.</li>
</ul>
</li>
<li>
User-Friendly Interface:
<ul>
<li>Intuitive form interface for event submission, including validation for required fields like email.</li>
<li>Admin interface for managing events, including viewing, editing, and approving submissions.</li>
</ul>
</li>
<li>
Event Announcements:
<ul>
<li>Display event-based announcements as banners or modals to highlight important information.</li>
<li>Use events to announce meeting closures, moves, new meetings, or promote upcoming events.</li>
<li>Events show as announcements when today’s date falls between the event’s start and end dates.</li>
<li>Supports filtering by categories and tags to control which events appear as announcements.</li>
<li>Dismissable with 24-hour persistence – users can re-open via a bell icon.</li>
</ul>
</li>
</ol>
<h3>Announcement Feature</h3>
The announcement feature allows you to display event-based announcements prominently on your site. This is useful for: 
* Meeting closures or changes 
* New meeting announcements 
* Breaking news or important updates 
* Promoting upcoming events
Shortcode Usage:
<pre><code>[mayo_announcement] - Display announcements with default settings (banner mode)

[mayo_announcement mode="modal"] - Display as a modal popup instead of banner

[mayo_announcement categories="announcements,alerts"] - Filter by category slugs

[mayo_announcement tags="urgent,featured"] - Filter by tag slugs

[mayo_announcement time_format="24hour"] - Use 24-hour time format

[mayo_announcement background_color="#ff6600" text_color="#ffffff"] - Custom colors

[mayo_announcement background_color="#dc3545" text_color="#fff" categories="alerts"] - Red alert style
</code></pre>
Parameters: 
* mode – “banner” (sticky top bar) or “modal” (popup). Default: “banner” 
* categories – Comma-separated category slugs to filter events 
* tags – Comma-separated tag slugs to filter events 
* time_format – “12hour” or “24hour”. Default: “12hour” 
* background_color – Custom background color (hex, e.g., “#ff6600”). Default: CSS default 
* text_color – Custom text color (hex, e.g., “#ffffff”). Default: CSS default
Widget Usage:
For site-wide announcements without editing templates, use the “Mayo Event Announcements” widget: 
1. Go to Appearance > Widgets 
2. Add the “Mayo Event Announcements” widget to any widget area (footer recommended for site-wide display) 
3. Configure the display mode, categories, tags, and time format
How It Works: 
* Events appear as announcements when today’s date is between the event’s start_date and end_date 
* Banner mode shows a fixed bar at the top of the viewport with carousel navigation for multiple events 
* Modal mode shows a centered popup with a list of all matching events 
* When dismissed, announcements stay hidden for 24 hours but can be re-opened via a bell icon in the bottom-right corner
<h3>Additional Information</h3>
Mayo WordPress Plugin
A WordPress plugin for managing and displaying events from a BMLT root server.
CSS Documentation
The plugin includes documentation for the dynamic CSS classes used in the Event Card component. This helps developers understand and customize the appearance of events on their site.
Important Note About Styling
This plugin does not include a built-in CSS editor. To style the event cards, you need to use another plugin like “Simple Custom CSS” or add CSS to your theme’s stylesheet. The documentation is provided to help you understand which CSS classes are available for styling.
Viewing the Documentation
The CSS documentation is available in the WordPress admin area under the Mayo menu. It includes:
<ul>
<li>Dynamic classes generated based on event properties</li>
<li>Examples of how to customize the appearance</li>
</ul>
Customization
You can customize the appearance of events by adding CSS rules to your theme or using a custom CSS plugin. The documentation provides examples of common customizations, such as:
<ul>
<li>Styling specific categories or tags</li>
<li>Customizing the appearance of different event types</li>
<li>Adding styles for specific service bodies</li>
</ul>
Recommended CSS Plugins
<ul>
<li>Simple Custom CSS (https://wordpress.org/plugins/simple-custom-css/)</li>
<li>Custom CSS and JS (https://wordpress.org/plugins/custom-css-js/)</li>
<li>Advanced Custom CSS (https://wordpress.org/plugins/advanced-custom-css/)</li>
</ul>
Development
Prerequisites
<ul>
<li>Node.js (v14 or higher)</li>
<li>npm (v6 or higher)</li>
</ul>
Installation
<ol>
<li>Clone the repository</li>
<li>
Install dependencies:
npm install
</li>
<li>
Build the plugin:
npm run build
</li>
</ol>
Development Workflow
<ol>
<li>
Start the development server:
npm run dev
</li>
<li>
Make changes to the code
</li>
<li>Rebuild the plugin as needed</li>
</ol>
License
This project is licensed under the GPL v2 or later.
<h3>Technical Details</h3>
<ul>
<li>Custom Post Type: Utilizes a custom post type <code>mayo_event</code> to store and manage events.</li>
<li>JavaScript Components: Built with React and integrated into the WordPress admin and front-end using Gutenberg components.</li>
<li>Email Handling: Uses WordPress’s <code>wp_mail</code> function to send notifications.</li>
<li>Data Storage: Stores event metadata using WordPress’s post meta system, ensuring compatibility and scalability.</li>
</ul>

Mayo Events Manager

Pronounced "my-oh".  Referring to the Spanish word "mayo" which means "May" in English.  Mayo Event Manager is a compreh …

pjaudiomv

Upcoming Meetings BMLT is a plugin that displays the next ‘N’ number of meetings from the current time on your page or in a widget using the upcoming_meetings shortcode.
SHORTCODE 
Basic: [upcoming_meetings] 
Attributes: root_server, services, recursive, grace_period, num_results, display_type, timezone, location_text, time_format, weekday_language, limit_to_today, custom_query
Meeting Formats: [meeting_formats] 
Attributes: root_server, display_type, show_description, language
— Shortcode parameters can be combined
<h3>Usage</h3>
A minimum of root_server, and services attributes are required, which would return the next 5 meetings in simple view with a 15minute grace period.
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" services="50"]
recursive to recurse service bodies add recursive="1" 
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" services="50" recursive="1"]
services to add multiple service bodies just seperate by a comma. 
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" services="50,37,26"]
grace_period To add a grace period to meeting lookup add grace_period="15" this would add a 15 minute grace period. 
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" services="50" grace_period="15"]
num_results To limit the number of results add num_results="5" this would limit results to 5. 
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" services="50" state="1" num_results="5"]
display_type To change the display type add display_type="table" there are three different types simple, table, block 
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" display_type="table"]
timezone By default we use your WordPress sites timezone setting, this will overwrite that. add timezone="America/New_York" you can set this in the admin setting or short code. A complete list of timezones can be found here http://php.net/manual/en/timezones.php 
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" timezone="America/New_York"]
location_text to display the location nam,e using the simple display add location_text="1" 
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" services="50" location_text="1"]
show_header to display header info for Table/Block display add show_header="1" 
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" services="50" show_header="1"]
time_format This allows you to be able to switch between 12 and 24 hour. the default is 12. To switch to 24 hour add time_format="24" 
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" time_format="24"]
weekday_language This allows you to change the language of the weekday names. To change language to danish set weekday_language="dk". Currently supported languages are da,de,en,es,fa,fr,it,pl,pt,ru,sv, the default is English. 
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" weekday_language="dk"]
limit_to_today To limit results to only today’s meetings (will not show tomorrow’s meetings even if there aren’t enough results) add limit_to_today="1" 
Ex. [upcoming_meetings root_server="https://www.domain.org/main_server" services="50" limit_to_today="1"]
custom_query You can add a custom query from semantic api to filter results, for ex by format <code>&formats=54</code>. 
Ex. [upcoming_meetings root_server=”https://www.domain.org/main_server” custom_query=”&formats=54″]
<h3>Meeting Formats Shortcode</h3>
The meeting_formats shortcode displays all available meeting formats from a BMLT root server.
Basic: [meeting_formats]
root_server (optional) The BMLT root server URL. Uses plugin settings if not specified. 
Ex. [meeting_formats root_server=”https://bmlt.sezf.org/main_server”]
display_type (optional, default: “table”) Options: “table” or “list” 
Ex. [meeting_formats display_type=”list”]
show_description (optional, default: “1”) Show format descriptions. Options: “1” or “0” 
Ex. [meeting_formats show_description=”0″]
language (optional, default: “en”) Language code for format names (en, es, fr, de, etc.) 
Ex. [meeting_formats language=”es”]
<h3>EXAMPLES</h3>
<a href="https://www.southcoastalna.org/" rel="nofollow ugc">https://www.southcoastalna.org/</a>
<h3>MORE INFORMATION</h3>
<a href="https://github.com/bmlt-enabled/upcoming-meetings-bmlt" rel="nofollow ugc">https://github.com/bmlt-enabled/upcoming-meetings-bmlt</a>

Upcoming Meetings BMLT

Upcoming Meetings BMLT is a plugin that displays the next 'N' number of meetings from the current time on your page or in a widget using the …

Mayo Events Manager vs Upcoming Meetings BMLT