Comfort Events User Guide

The Comfort Events plugin is designed to simplify event management within WordPress. It provides features for event listings, event builder related functionalities.

File Structure

event/
├── assets/
│   ├── css/
│   ├── js/
│   ├── vendors/
├── includes/
│   ├── Api/
│   ├── Controllers/
│   ├── Helpers/
│   ├── Models/
│   ├── ComfortEvent.php
│   ├── ComfortEventAdmin.php
│   ├── ComfortEventHooks.php
│   ├── ComfortEventPublic.php
│   ├── ComfortEventShortcode.php
│   └── ComfortEventUninstall.php
├── templates/
│   ├── admin/
│   ├── emails/
│   ├── global/
│   ├── loop/
│   ├── event/
│   └── shortcodes/
├── comfortevents.php
└── readme.txt

Key Files and Directories

  • assets/: Contains CSS, JavaScript, and vendor files.
  • includes/: Contains core PHP files for the plugin, including API routes, controllers, helpers, models, and main plugin classes.
  • templates/: Contains template files for the plugin's frontend and admin views.
  • comfortevents.php: The main plugin file that initializes the plugin.

ComfortEvent

The main class for the plugin, located in wp-content/plugins/comfortevents/includes/ComfortEvent.php.

class ComfortEvent {
    public static function instance() {
        // Returns the main instance of ComfortEvent.
    }

    public function __construct() {
        // Constructor method.
    }

    private function include_files() {
        // Includes necessary files.
    }
}

ComfortEventAdmin

Handles the admin functionalities of the plugin, located in ComfortEventAdmin.php.

<?php
class ComfortEventAdmin {
    public function create_menus() {
        // Creates admin menus.
    }

    public function display_event_listing_page() {
        // Displays the event listing page.
    }
}

ComfortEventPublic

Handles the public-facing functionalities of the plugin, located in ComfortEventPublic.php.

<?php
class ComfortEventPublic {
    public function enqueue_scripts() {
        // Enqueues public scripts and styles.
    }
}

ComfortEventShortcode

Handles the public-facing functionalities of the plugin, located in ComfortEventShortcode.php.

<?php
class ComfortEventShortcode {
    public function init_shortcode() {
        // Initializes shortcodes.
    }

    public function event_event_details_shortcode($atts) {
        // Handles the event details shortcode.
    }
}

Event Details

To display event details, use the following shortcode:

[comfortevent_event_details]

Event Archive

To display a list of event listings, use the following shortcode:

[comfortevent_event_archive]

Event Dashboard

To display the event dashboard, use the following shortcode:

[comfortevent_event_dashboard]

Frontend Event Management

  1. Create a new page in WordPress.
  2. Add the [comfortevent_event_manager] shortcode to the page content.
  3. Publish the page.
  4. Users can now submit event listings from the frontend.

Uninstallation

The uninstallation script is located in ComfortEventUninstall.php.

<?php
ComfortEventUninstall::uninstall();