{"id":232638,"date":"2025-05-14T17:32:38","date_gmt":"2025-05-14T17:32:38","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/mobilizeamerica-shortcode\/"},"modified":"2025-11-17T16:05:57","modified_gmt":"2025-11-17T16:05:57","slug":"shortcode-for-mobilizeamerica-api","status":"publish","type":"plugin","link":"https:\/\/tl.wordpress.org\/plugins\/shortcode-for-mobilizeamerica-api\/","author":14122794,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.15","stable_tag":"1.0.15","tested":"6.8.5","requires":"6.7","requires_php":"8.0","requires_plugins":null,"header_name":"Shortcode for MobilizeAmerica API","header_author":"South Florida Web Advisors","header_description":"Displays events from Mobilize America on your WordPress site.","assets_banners_color":"c5ced6","last_updated":"2025-11-17 16:05:57","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/sflwa.net","rating":5,"author_block_rating":0,"active_installs":10,"downloads":676,"num_ratings":3,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","changelog"],"tags":{"1.0.10":{"tag":"1.0.10","author":"sflwa","date":"2025-07-20 14:04:42"},"1.0.11":{"tag":"1.0.11","author":"sflwa","date":"2025-07-20 14:04:42"},"1.0.12":{"tag":"1.0.12","author":"sflwa","date":"2025-08-06 15:49:51"},"1.0.13":{"tag":"1.0.13","author":"sflwa","date":"2025-09-19 13:11:56"},"1.0.14":{"tag":"1.0.14","author":"sflwa","date":"2025-10-23 08:46:24"},"1.0.15":{"tag":"1.0.15","author":"sflwa","date":"2025-11-17 16:05:57"},"1.0.8":{"tag":"1.0.8","author":"sflwa","date":"2025-05-14 23:25:52"},"1.0.9":{"tag":"1.0.9","author":"sflwa","date":"2025-05-19 14:00:02"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":3},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3293583,"resolution":"128x128","location":"assets","locale":""}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3293583,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.10","1.0.11","1.0.12","1.0.13","1.0.14","1.0.15","1.0.8","1.0.9"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3293463,"resolution":"1","location":"assets","locale":""}},"screenshots":{"1":"Sample Output of 3 Column Card Template without Descriptions"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1556,80],"plugin_category":[43],"plugin_contributors":[242288],"plugin_business_model":[],"class_list":["post-232638","plugin","type-plugin","status-publish","hentry","plugin_tags-api","plugin_tags-shortcode","plugin_category-customization","plugin_contributors-sflwa","plugin_committers-sflwa"],"banners":{"banner":"https:\/\/ps.w.org\/shortcode-for-mobilizeamerica-api\/assets\/banner-772x250.png?rev=3293583","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/shortcode-for-mobilizeamerica-api\/assets\/icon-128x128.png?rev=3293583","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/shortcode-for-mobilizeamerica-api\/assets\/screenshot-1.png?rev=3293463","caption":"Sample Output of 3 Column Card Template without Descriptions"}],"raw_content":"<!--section=description-->\n<p>The Mobilize America Events shortcode \/ widget will display a list of events from Mobilize America.\nThere are 2 layouts - Card &amp; Default (List).\nThe elementor widget allows you to override the default styles.<\/p>\n\n<h3>External Services<\/h3>\n\n<p>This plugin connects to MobilizeAmerica's API to pull in events for a specific organization.\nThe shortcode \/ elementor widget passes a specificed organization id, a start date and a variable about virtual events.\nThis service is provided by MobilizeAmerica - https:\/\/api.mobilize.us\n* <a href=\"https:\/\/github.com\/mobilizeamerica\/api\">API Documentation<\/a>\n* <a href=\"https:\/\/join.mobilize.us\/terms-of-service\/\">Mobilize Terms of Use<\/a>\n* <a href=\"https:\/\/join.mobilize.us\/privacy-policy\/\">MobilizePrivacy Policy<\/a><\/p>\n\n<h3>Instructions for Shortcode for MobilizeAmerica API<\/h3>\n\n<p>This shortcode allows you to display events from Mobilize America on your WordPress site.\nThe Element widget outputs the code for the shortcode so you do not have to build it manually<\/p>\n\n<p>Shortcode: [mobilize_america_events]<\/p>\n\n<p>Attributes\nThe shortcode accepts the following attributes:\n* <strong>organization_id (required):<\/strong> The ID of the organization whose events you want to display. You can find this ID on Mobilize America. https:\/\/www.mobilize.us\/dashboard\/YOUR-ORGANIZATION\/settings\/\n* <strong>organization_only:<\/strong> (optional): yes\/no - if set to yes then only the organzation events will be shown without promoted events\n* <strong>timeslot_start:<\/strong> (optional):  Suggested: gte_now which is greater than now - Unix timestamp to filter events.  Only shows events withtimeslots starting after this date.\n* <strong>timeslot_end:<\/strong> (optional): Unix timestamp to filter events. Only shows events with timeslots starting before this date.\nNote: For timeslot please use comparison text -  The comparison operators are \u2265 gte, &gt; gt, \u2264 lte, &lt; lt\n* <strong>event_types: (optional):<\/strong>  Filters events by event type.\n* <strong>zipcode: (optional):<\/strong>  Filters events by zipcode.\n* <strong>radius: (optional):<\/strong>  Filters events by a radius around the zipcode.\n* <strong>limit: (optional):<\/strong> The maximum number of events to display. Default is 10.\n* <strong>template:<\/strong> (optional): The template to use for displaying events.  Available options are:\n  * <strong>default:<\/strong>  Displays events in a list format.\n  * <strong>card:<\/strong> Displays events in a card format.\n* <strong>show_description:<\/strong> (optional):  Show or hide the event description.  Default is true. Options are:\n  * <strong>true:<\/strong> Show the description.\n  * <strong>false:<\/strong> Hide the description.\n* <strong>is_virtual:<\/strong> (optional): Filters events by their virtual status. Options are:\n  * <strong>\"\":<\/strong>  Show all events (default).\n  * <strong>\"true\":<\/strong> Show only virtual events.\n  * <strong>\"false\":<\/strong> Show only in-person events.\n* <strong>columns: (optional, only applies to the card template):<\/strong>  The number of columns to use for the card layout.  Options are 1, 2, 3, or 4. Default is 3.\n* <strong>tag_id:<\/strong>  (optional): comma separated list of tag ids to filter by<\/p>\n\n<h3>Planed Features<\/h3>\n\n<ul>\n<li>Truncate Description <\/li>\n<li>Fix Elementor Widget Style settings <\/li>\n<li>Map Link for Address<\/li>\n<li>Remove Default &amp; Card Layout for single layout - future feature of custom layout<\/li>\n<\/ul>\n\n<h3>Future Feature Ideas<\/h3>\n\n<ul>\n<li>Block to output shortcode content<\/li>\n<li>Single Event Display<\/li>\n<li>Custom Layout in uploads directory <\/li>\n<li>UI for custom layout inside wordpress<\/li>\n<li>Map Layout of events<\/li>\n<li>Events stored locally in database to allow for better search \/ filtering<\/li>\n<\/ul>\n\n<h3>Examples<\/h3>\n\n<p>Display 10 events for organization ID 1234:<\/p>\n\n<pre><code>[mobilize_america_events organization_id=\"1234\"]\n<\/code><\/pre>\n\n<p>Display 5 card formatted events for organization 1234, starting after 2024-01-01:<\/p>\n\n<pre><code>[mobilize_america_events organization_id=\"1234\" template=\"card\" timeslot_start=\"gte_1704137620\" limit=\"5\"]\n<\/code><\/pre>\n\n<p>Display virtual events in 2 columns:<\/p>\n\n<pre><code>[mobilize_america_events organization_id=\"1234\" template=\"card\" is_virtual=\"true\" columns=\"2\"]\n<\/code><\/pre>\n\n<!--section=changelog-->\n<p>2025-11-17 v1.0.15\n* Fixed Single Event Filtering\n* Updated Using Plugin Notice - Option vs Transient\n* Cleanup WordPress Coding Standards \/ Debug Code<\/p>\n\n<p>2025-10-22 v1.0.14\n* Fixed Sort to be in date order regardless of how it is in the API results\n* Fixed event_types - added \"s\" - use INTEREST_FORM to show Interest forms - must be displayed separate from other events<\/p>\n\n<p>2025-09-19 v1.0.13\n* Fixed Timezone issue for time display - uses WP Timezone vs GMT offset - this was only an issue when a future event was after the Daylight Savings Time Switch<\/p>\n\n<p>2025-08-06 v1.0.12\n* Added Let us know you've installed plugin alert<\/p>\n\n<p>2025-07-20 v1.0.11\n*  Added support for tag_id for filtering based on tags\n*  Added support for organization only which will filter to not included promoted events<\/p>\n\n<p>2025-05-29 v1.0.10\n*   Added default timeslot_start as gte_now so that the shortcode will show future event by default<\/p>\n\n<p>2025-05-19 v1.0.9\n*   Added Location to output \n*   Added time to output - adjusted output to local time based on WordPress timezone\n*   Added Sponsor Name \/ Link<\/p>\n\n<p>2025-05-11 v1.0.8\n* Added API Information to Readme\n* Adjusted prefix per WordPress standards<\/p>\n\n<p>2025-05-10 v1.0.7\n* UPDATE Slug \/ Name based on WordPress Requirements\n* FIX PHP Warning on Card Template<\/p>\n\n<p>2025-05-04 v1.0.6\n* FIX: PHP Function issue in Template<\/p>\n\n<p>2025-05-03 v1.0.5\n* Moved Template Code to separate file\n* Added column feature to card template\n* Checked Plugin to WordPress Standards<\/p>\n\n<p>2025-05-03 v1.0.4\n* Added Elementor Widget<\/p>\n\n<p>2025-05-01 v1.0.3\n* WordPress Plugin Header Standards<\/p>\n\n<p>2025-05-01 v1.0.2\n* Update name &amp; files to match WordPress Standards<\/p>\n\n<p>2025-05-01 v1.0.1\n* Added \"is_virutal\" to Shortcode<\/p>\n\n<p>2025-04-28 - v1.0.0 - Initial Release<\/p>","raw_excerpt":"A shortcode to display events from Mobilize.us with and an Elementor Widget.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/232638","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=232638"}],"author":[{"embeddable":true,"href":"https:\/\/tl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/sflwa"}],"wp:attachment":[{"href":"https:\/\/tl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=232638"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=232638"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=232638"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=232638"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=232638"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=232638"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}