{"id":249785,"date":"2025-10-01T12:32:38","date_gmt":"2025-10-01T12:32:38","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/atomic-events-calendar\/"},"modified":"2025-10-01T19:08:37","modified_gmt":"2025-10-01T19:08:37","slug":"atomic-events-calendar","status":"publish","type":"plugin","link":"https:\/\/az.wordpress.org\/plugins\/atomic-events-calendar\/","author":17593361,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.3","stable_tag":"1.0.3","tested":"6.8.5","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Atomic Events Calendar","header_author":"Arpad Lehel Matyus","header_description":"A lightweight WordPress events framework that gives developers and agencies full control without the bloat.","assets_banners_color":"c23d1e","last_updated":"2025-10-01 19:08:37","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/matyus.me\/","header_plugin_uri":"https:\/\/matyus.me\/atomicevents-io","header_author_uri":"https:\/\/matyus.me\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":235,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.3":{"tag":"1.0.3","author":"lehelm","date":"2025-10-01 19:08:37"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3371095,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3371095,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3371426,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3371426,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.3"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Event Post type","2":"Event List"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[416,2431,1486],"plugin_category":[40],"plugin_contributors":[177617],"plugin_business_model":[],"class_list":["post-249785","plugin","type-plugin","status-publish","hentry","plugin_tags-calendar","plugin_tags-event","plugin_tags-events","plugin_category-calendar-and-events","plugin_contributors-lehelm","plugin_committers-lehelm"],"banners":{"banner":"https:\/\/ps.w.org\/atomic-events-calendar\/assets\/banner-772x250.png?rev=3371426","banner_2x":"https:\/\/ps.w.org\/atomic-events-calendar\/assets\/banner-1544x500.png?rev=3371426","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/atomic-events-calendar\/assets\/icon-128x128.png?rev=3371095","icon_2x":"https:\/\/ps.w.org\/atomic-events-calendar\/assets\/icon-256x256.png?rev=3371095","generated":false},"screenshots":[],"raw_content":"\n

Atomic Events Calendar is built for developers and agencies who need events in WordPress without the overhead of full event management plugins.<\/p>\n\n

Instead of starting from scratch on every project, Atomic Events Calendar gives you:<\/p>\n\n

\u2013 A ready-to-use Events post type<\/strong>
\n\u2013 Essential event fields (date, venue, type, etc.)
\n\u2013 Developer-friendly shortcodes<\/strong> to display and filter events
\n\u2013 A robust theming structure<\/strong> for easy overrides and custom designs<\/p>\n\n

\u2728 Think of it as a lightweight framework disguised as a plugin<\/strong>: everything you need to set up events quickly, with the freedom to extend and customize as you like.<\/p>\n\n

Perfect for agencies that want full control over their event implementations\u2014without the bloat.<\/p>\n\n

Features<\/h3>\n\n
    \n
  • Developer-Friendly<\/strong> \u2013 Clean code structure with services architecture<\/li>\n
  • Responsive Design<\/strong> \u2013 Built with Tailwind CSS for modern, responsive layouts<\/li>\n
  • Structured Data for Search Engines<\/strong> \u2013 Automatic JSON-LD schema markup for better SEO and rich snippets<\/li>\n
  • Custom Post Type<\/strong> \u2013 Dedicated 'atomic-event' post type with all necessary fields<\/li>\n
  • Template Override System<\/strong> \u2013 Easy theme integration with template hierarchy<\/li>\n
  • Shortcode Support<\/strong> \u2013 Display events anywhere with [atomic-events]<\/code> shortcode<\/li>\n
  • Featured Events<\/strong> \u2013 Mark and display featured events prominently<\/li>\n
  • Location Management<\/strong> \u2013 Complete address fields (street, city, state, country, postcode)<\/li>\n
  • Date & Time Support<\/strong> \u2013 Start\/end dates with time support<\/li>\n
  • Image Support<\/strong> \u2013 Featured images with captions<\/li>\n
  • Member-Only Events<\/strong> \u2013 Restrict events to members only<\/li>\n
  • Performance Caching<\/strong> \u2013 Automatic shortcode caching with smart invalidation<\/li>\n<\/ul>\n\n

    Basic usage is through shortcode:<\/p>\n\n

    [atomic-events filter max='10' columns='3' featured='0' \n    skip_first_x='0' skip_first_x_featured='1' order='ASC']\n<\/code><\/pre>\n\n
    How can I customize the event template?<\/h3>\n\n
    The plugin provides a default template for single events, but you can override it in your theme:<\/p>\n\n
      \n
    1. Child Theme<\/strong> (recommended): Copy the template to child-theme\/atomic-events\/single\/single-atomic-event.php<\/code><\/li>\n
    2. Parent Theme<\/strong>: Copy the template to parent-theme\/atomic-events\/single\/single-atomic-event.php<\/code><\/li>\n<\/ol>\n\n
      The plugin will automatically use your theme's version instead of the default.<\/p>\n\n
      See the example template in templates\/theme-override-example.php<\/code> for reference.<\/p>\n\n
      My event pages show 404 errors<\/h4>\n\n
      If you experience 404 errors when viewing event pages:\n1. Go to WordPress Admin \u2192 Events \u2192 Settings\n2. Click \"Flush Rewrite Rules\"\n3. If that doesn't work, go to Settings \u2192 Permalinks and click \"Save Changes\"<\/p>\n\n
      Template Structure<\/h3>\n\n
      The plugin provides a comprehensive template override system. You can override any template by creating files in your theme:<\/p>\n\n
      \n    your-theme\/\n    \u2514\u2500\u2500 atomic-events\/\n    \u2502   \u251c\u2500\u2500 cards\/\n    \u2502   \u2502   \u251c\u2500\u2500 card-item-default.php\n    \u2502   \u2502   \u251c\u2500\u2500 card-item-featured.php\n    \u2502   \u2502   \u251c\u2500\u2500 card-list-header-default.php\n    \u2502   \u2502   \u2514\u2500\u2500 card-list-footer-default.php\n    \u2502   \u251c\u2500\u2500 single\/\n    \u2502   \u2502   \u2514\u2500\u2500 single-atomic-event.php\n    \u2502   \u251c\u2500\u2500 content\/\n    \u2502   \u2502   \u2514\u2500\u2500 single-event.php\n    \u2502   \n<\/pre>\n\n
      Template Hierarchy<\/h3>\n\n
      The plugin follows WordPress template hierarchy for single event pages. Templates are loaded in this order of priority:<\/p>\n\n
        \n
      1. Child Theme<\/strong>: child-theme\/atomic-events\/single\/single-atomic-event.php<\/code><\/li>\n
      2. Parent Theme<\/strong>: parent-theme\/atomic-events\/single\/single-atomic-event.php<\/code><\/li>\n
      3. Plugin Default<\/strong>: plugin\/templates\/single\/single-atomic-event.php<\/code><\/li>\n<\/ol>\n\n
        Template Override System<\/h3>\n\n
        The plugin uses a custom template loader that checks for theme templates first, then falls back to the plugin's default template. This ensures:<\/p>\n\n
        \u2013 Theme compatibility<\/strong>: Works with any WordPress theme\n\u2013 Customization flexibility<\/strong>: Easy to override in themes\n\u2013 Update safety<\/strong>: Plugin updates won't break custom templates\n\u2013 Developer-friendly<\/strong>: Clear hierarchy and fallback system<\/p>\n\n
        Template Hierarchy Priority:<\/strong><\/p>\n\n
          \n
        1. Child Theme<\/strong>: child-theme\/atomic-events\/[template-name].php<\/code><\/li>\n
        2. Parent Theme<\/strong>: parent-theme\/atomic-events\/[template-name].php<\/code><\/li>\n
        3. Plugin Default<\/strong>: plugin\/templates\/[template-name].php<\/code><\/li>\n<\/ol>\n\n
          Available Templates:<\/strong>\n\u2013 Shortcode Templates<\/strong>: Override how events appear in lists and grids\n\u2013 Single Event Templates<\/strong>: Customize individual event page layouts\n\u2013 Content Templates<\/strong>: Modify event content display<\/p>\n\n
          The default template includes:\n\u2013 WordPress header\/footer integration\n\u2013 Event model for accessing custom fields\n\u2013 Template loader for modular content parts\n\u2013 Proper WordPress loop structure<\/p>\n\n
          Custom Fields Available<\/h3>\n\n
          When creating custom templates, you have access to these event fields:<\/p>\n\n
          \n$event_model = new AtomicEventModel(get_the_ID());\n\n\/\/ Basic event data\n$event_model->get_title();\n$event_model->get_event_start_date();\n$event_model->get_event_end_date();\n$event_model->get_event_venue();\n$event_model->get_event_location_city();\n$event_model->get_event_country();\n$event_model->get_event_location_state();\n$event_model->get_event_location_region();\n\n\/\/ Event settings\n$event_model->is_featured();\n$event_model->is_member_only();\n$event_model->get_event_all_day();\n\n\/\/ Additional data\n$event_model->get_event_outbound_link();\n$event_model->get_event_tag();\n$event_model->get_event_image_id();\n$event_model->get_permalink();\n<\/pre>\n\n
          Creating Custom Templates<\/h3>\n\n
            \n
          1. Copy the example template<\/strong> from templates\/theme-override-example.php<\/code><\/li>\n
          2. Place it in your theme<\/strong> at the appropriate path<\/li>\n
          3. Customize the template<\/strong> as needed<\/li>\n
          4. Test thoroughly<\/strong> to ensure proper functionality<\/li>\n<\/ol>\n\n
            Hooks and Filters<\/h3>\n\n
            The plugin provides several hooks for customization:<\/p>\n\n
            \n\/\/ Filter the template path\nadd_filter('atomic_events_template_path', 'my_custom_template_path', 10, 2);\n\n\/\/ Filter event data before display\nadd_filter('atomic_events_event_data', 'my_custom_event_data', 10, 2);\n\n\/\/ Filter whether to show event in lists\nadd_filter('atomic_events_should_show_in_list', 'my_custom_visibility_logic', 10, 2);\n<\/pre>\n\n
            Shortcode Parameters<\/h3>\n\n
            The [atomic-events]<\/code> shortcode supports these parameters:<\/p>\n\n
            \u2013 filter<\/code>: \"future\" or \"past\" (default: \"future\")\n\u2013 max<\/code>: Maximum number of events (default: 20)\n\u2013 columns<\/code>: Number of columns (default: 3)\n\u2013 featured<\/code>: Show only featured events (true\/false)\n\u2013 skip_first_x<\/code>: Skip first X events\n\u2013 skip_first_x_featured<\/code>: Skip first X featured events\n\u2013 order<\/code>: \"ASC\" or \"DESC\" (default: \"ASC\")<\/p>\n\n
            Best Practices<\/h3>\n\n
              \n
            1. Always use child themes<\/strong> for customizations<\/li>\n
            2. Test with different themes<\/strong> to ensure compatibility<\/li>\n
            3. Use the event model<\/strong> for accessing custom fields<\/li>\n
            4. Follow WordPress coding standards<\/strong><\/li>\n
            5. Document custom modifications<\/strong><\/li>\n
            6. Test thoroughly<\/strong> before deployment<\/li>\n<\/ol>\n\n\n
                \n
              1. Upload the Atomic Events Calendar plugin to your blog<\/li>\n
              2. Activate it<\/li>\n
              3. Create Event post types<\/li>\n
              4. Place [atomic-events]<\/code> in your templates<\/li>\n<\/ol>\n\n\n
                \n
                How can I print out Events<\/h3><\/dt>\n
                Simply place a shortcode in your page content area like so:<\/p>\n\n
                [atomic-events filter=\"future\" max=\"10\" columns=\"3\" featured=\"0\" skip_first_x=\"0\" skip_first_x_featured=\"1\" order=\"ASC\"]\n<\/code><\/pre><\/dd>\n\n<\/dl>\n\n\n
                1.0.3<\/h4>\n\n
                  \n
                • Fixed remaining class name references after renaming<\/li>\n
                • Updated general settings tab with developer-focused information<\/li>\n
                • Resolved all \"Class not found\" errors<\/li>\n
                • Improved plugin stability and compatibility<\/li>\n<\/ul>\n\n
                  1.0.2<\/h4>\n\n
                    \n
                  • Fixed WordPress.org plugin review naming convention issues<\/li>\n
                  • Updated all class names to use unique ATMCEVNTS_ prefix<\/li>\n
                  • Updated all function names to use unique atmcevnts_ prefix<\/li>\n
                  • Fixed JSON escaping issues in structured data service<\/li>\n
                  • Removed non-permitted files for WordPress.org submission<\/li>\n<\/ul>\n\n
                    1.0.1<\/h4>\n\n
                      \n
                    • Fixed deprecated FILTER_SANITIZE_STRING usage for PHP 8.1+ compatibility<\/li>\n
                    • Improved input sanitization and validation<\/li>\n
                    • Enhanced security with proper nonce handling<\/li>\n
                    • Fixed WordPress.org plugin checker compliance issues<\/li>\n
                    • Removed hidden files (.DS_Store) for WordPress.org submission<\/li>\n
                    • Added proper escaping for all output<\/li>\n
                    • Improved JSON-LD structured data handling<\/li>\n<\/ul>\n\n
                      1.0.0<\/h4>\n\n
                        \n
                      • Initial release<\/li>\n
                      • Custom post type for events<\/li>\n
                      • Shortcode support with filtering options<\/li>\n
                      • Template override system<\/li>\n
                      • Structured data (JSON-LD) for SEO<\/li>\n
                      • Featured events functionality<\/li>\n
                      • Member-only events support<\/li>\n
                      • Location management with address fields<\/li>\n
                      • Date and time support with all-day events<\/li>\n
                      • Performance caching system<\/li>\n
                      • Theme integration with template hierarchy<\/li>\n<\/ul>","raw_excerpt":"Atomic Events Calendar: A lightweight WordPress events framework that gives agencies full control without the bloat.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/249785","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=249785"}],"author":[{"embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/lehelm"}],"wp:attachment":[{"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=249785"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=249785"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=249785"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=249785"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=249785"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/az.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=249785"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}