sflwa

The Mobilize America Events shortcode / widget will display a list of events from Mobilize America. 
There are 2 layouts – Card & Default (List). 
The elementor widget allows you to override the default styles.
<h3>External Services</h3>
This plugin connects to MobilizeAmerica’s API to pull in events for a specific organization. 
The shortcode / elementor widget passes a specificed organization id, a start date and a variable about virtual events. 
This service is provided by MobilizeAmerica – https://api.mobilize.us 
* <a href="https://github.com/mobilizeamerica/api" rel="nofollow ugc">API Documentation</a> 
* <a href="https://join.mobilize.us/terms-of-service/" rel="nofollow ugc">Mobilize Terms of Use</a> 
* <a href="https://join.mobilize.us/privacy-policy/" rel="nofollow ugc">MobilizePrivacy Policy</a>
<h3>Instructions for Shortcode for MobilizeAmerica API</h3>
This shortcode allows you to display events from Mobilize America on your WordPress site. 
The Element widget outputs the code for the shortcode so you do not have to build it manually
Shortcode: [mobilize_america_events]
Attributes 
The shortcode accepts the following attributes: 
* organization_id (required): 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/ 
* organization_only: (optional): yes/no – if set to yes then only the organzation events will be shown without promoted events 
* timeslot_start: (optional): Suggested: gte_now which is greater than now – Unix timestamp to filter events. Only shows events withtimeslots starting after this date. 
* timeslot_end: (optional): Unix timestamp to filter events. Only shows events with timeslots starting before this date. 
Note: For timeslot please use comparison text – The comparison operators are ≥ gte, > gt, ≤ lte, < lt 
* event_types: (optional): Filters events by event type. 
* zipcode: (optional): Filters events by zipcode. 
* radius: (optional): Filters events by a radius around the zipcode. 
* limit: (optional): The maximum number of events to display. Default is 10. 
* template: (optional): The template to use for displaying events. Available options are: 
 * default: Displays events in a list format. 
 * card: Displays events in a card format. 
* show_description: (optional): Show or hide the event description. Default is true. Options are: 
 * true: Show the description. 
 * false: Hide the description. 
* is_virtual: (optional): Filters events by their virtual status. Options are: 
 * “”: Show all events (default). 
 * “true”: Show only virtual events. 
 * “false”: Show only in-person events. 
* columns: (optional, only applies to the card template): The number of columns to use for the card layout. Options are 1, 2, 3, or 4. Default is 3. 
* tag_id: (optional): comma separated list of tag ids to filter by
<h3>Planed Features</h3>
<ul>
<li>Truncate Description </li>
<li>Fix Elementor Widget Style settings </li>
<li>Map Link for Address</li>
<li>Remove Default & Card Layout for single layout – future feature of custom layout</li>
</ul>
<h3>Future Feature Ideas</h3>
<ul>
<li>Block to output shortcode content</li>
<li>Single Event Display</li>
<li>Custom Layout in uploads directory </li>
<li>UI for custom layout inside wordpress</li>
<li>Map Layout of events</li>
<li>Events stored locally in database to allow for better search / filtering</li>
</ul>
<h3>Examples</h3>
Display 10 events for organization ID 1234:
<pre><code>[mobilize_america_events organization_id="1234"]
</code></pre>
Display 5 card formatted events for organization 1234, starting after 2024-01-01:
<pre><code>[mobilize_america_events organization_id="1234" template="card" timeslot_start="gte_1704137620" limit="5"]
</code></pre>
Display virtual events in 2 columns:
<pre><code>[mobilize_america_events organization_id="1234" template="card" is_virtual="true" columns="2"]
</code></pre>

Shortcode for MobilizeAmerica API

A shortcode to display events from Mobilize.us with and an Elementor Widget.

miunosoft

Michael Uno

<h4>Generate Custom Outputs with HTML Comments</h4>
Commentcode API lets you generate custom outputs with HTML comment-like codes.
It is similar to the <a href="https://codex.wordpress.org/Shortcode_API" rel="nofollow ugc">Shortcode API</a> except it takes a form of HTML comments and some few features.
Since it takes a form of HTML comments, even the user disables your plugin, the embedded code will not be visible, on contrary to shortcodes that remain in posts when their plugins are deactivated.
<h4>Does not leave a mess in posts</h4>
Say, you have been using a plugin that converts a plugin specific shortcode into custom outputs. Later you found something else that is more useful and uninstalled it.
But the shortcodes used by that plugin remained in hundreds of posts and it was too much work to manually delete them so you have to ask somebody to run SQL commands.
That’s a problem. What if the shortcode takes a form of an HTML comment? It won’t leave such a mess.
<h4>Syntax</h4>
It looks like this.
<pre><code>



Some outputs.
</code></pre>
Notice that tripe dashes are used in the both opening and closing part. So it won’t hardly conflict with generic HTML comments.
<h4>Supports Multi-dimensional Array Arguments</h4>
The shortcode cannot pass multi-dimensional arguments to the callback function.
The below attributes won’t be parsed.
<pre><code>[my_shortcode foo[1]="one" foo[2]="two"]
</code></pre>
However, commentcode can handle it.
<pre><code>
</code></pre>
The attributes are interpreted as
<pre><code>array(
 'foo' => array(
 1 => 'one',
 2 => 'two',
 )
)
</code></pre>
<h4>Preserved Letter Cases</h4>
The shortcode does not allow capitalized attribute names.
<pre><code>[my_shortcode CapitalName="I need it to be capitalized"]
</code></pre>
The attribute is interpreted as
<pre><code>array(
 'capitalname' => 'I need it to be capitalized',
)
</code></pre>
This is not useful when you need to perform remote API requests which require argument names with capital letters.
However, the commentcode API preserves those argument names.
<pre><code>
</code></pre>
will be
<pre><code>array(
 'CapitalName' => 'Please keep capitalization!',
)
</code></pre>
<h4>Register a Commentcode</h4>
Use the <code>add_commentcode()</code> function. It accepts two parameters. 
1. (string) the commentcode tag. 
2. (callable) a callback function which gets called when the commentcode of the specified tag is processed.
The callback function receives three parameters. 
1. (string) The filtered text, usually an empty string. 
2. (array) The attributes set in the commentcode. 
3. (string) The commentcode tag name.
<pre><code>function get_my_commentcode( $text, $arguments, $tag ) {
 return "<pre>" . htmlspecialchars( print_r( $arguments, true ) ) . "</pre>";
}
add_commentcode( 'my_commentcode', 'get_my_commentcode' );
</code></pre>
For a test, while running the above code, try inserting <code></code> in a post.
It will produce this output,
<pre><code>Array
(
 [Foo] => bar
 [numbers] => Array
 (
 [1] => one
 [2] => two
 )

)
</code></pre>

Shortcode for MobilizeAmerica API vs Commentcode API