sflwa

<p>The Mobilize America Events shortcode / widget will display a list of events from Mobilize America.<br />
There are 2 layouts – Card & Default (List).<br />
The elementor widget allows you to override the default styles.</p>
<h3>External Services</h3>
<p>This plugin connects to MobilizeAmerica’s API to pull in events for a specific organization.<br />
The shortcode / elementor widget passes a specificed organization id, a start date and a variable about virtual events.<br />
This service is provided by MobilizeAmerica – https://api.mobilize.us<br />
* <a href="https://github.com/mobilizeamerica/api" rel="nofollow ugc">API Documentation</a><br />
* <a href="https://join.mobilize.us/terms-of-service/" rel="nofollow ugc">Mobilize Terms of Use</a><br />
* <a href="https://join.mobilize.us/privacy-policy/" rel="nofollow ugc">MobilizePrivacy Policy</a></p>
<h3>Instructions for Shortcode for MobilizeAmerica API</h3>
<p>This shortcode allows you to display events from Mobilize America on your WordPress site.<br />
The Element widget outputs the code for the shortcode so you do not have to build it manually</p>
<p>Shortcode: [mobilize_america_events]</p>
<p>Attributes<br />
The shortcode accepts the following attributes:<br />
* <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/<br />
* <strong>organization_only:</strong> (optional): yes/no – if set to yes then only the organzation events will be shown without promoted events<br />
* <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.<br />
* <strong>timeslot_end:</strong> (optional): Unix timestamp to filter events. Only shows events with timeslots starting before this date.<br />
Note: For timeslot please use comparison text –  The comparison operators are ≥ gte, > gt, ≤ lte, < lt<br />
* <strong>event_types: (optional):</strong>  Filters events by event type.<br />
* <strong>zipcode: (optional):</strong>  Filters events by zipcode.<br />
* <strong>radius: (optional):</strong>  Filters events by a radius around the zipcode.<br />
* <strong>limit: (optional):</strong> The maximum number of events to display. Default is 10.<br />
* <strong>template:</strong> (optional): The template to use for displaying events.  Available options are:<br />
  * <strong>default:</strong>  Displays events in a list format.<br />
  * <strong>card:</strong> Displays events in a card format.<br />
* <strong>show_description:</strong> (optional):  Show or hide the event description.  Default is true. Options are:<br />
  * <strong>true:</strong> Show the description.<br />
  * <strong>false:</strong> Hide the description.<br />
* <strong>is_virtual:</strong> (optional): Filters events by their virtual status. Options are:<br />
  * <strong>“”:</strong>  Show all events (default).<br />
  * <strong>“true”:</strong> Show only virtual events.<br />
  * <strong>“false”:</strong> Show only in-person events.<br />
* <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.<br />
* <strong>tag_id:</strong>  (optional): comma separated list of tag ids to filter by</p>
<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>
<p>Display 10 events for organization ID 1234:</p>
<pre><code>[mobilize_america_events organization_id="1234"]
</code></pre>
<p>Display 5 card formatted events for organization 1234, starting after 2024-01-01:</p>
<pre><code>[mobilize_america_events organization_id="1234" template="card" timeslot_start="gte_1704137620" limit="5"]
</code></pre>
<p>Display virtual events in 2 columns:</p>
<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.

Olivier D. aka oliezekat

<blockquote>
<p>Back WordPress API to the content.</p>
</blockquote>
<p>You can request some* functions of WordPress API with same syntax for arguments into your posts, pages, or widgets content.<br />
 functionsCapacitor will insert function result into your content as HTML output.</p>
<p>(*) see <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Supported-functions" rel="ugc">Supported functions</a><br />
or <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Supported-conditional-functions" rel="ugc">conditional tags</a>.</p>
<h4>Features</h4>
<ul>
<li>Safe process to use this plugin on WordPress MU or WP MultiSite.</li>
<li>Allow to personalize <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Embedded-output" rel="ugc">Embedded output</a><br />
for each functions.</li>
<li>Easy and powerfull <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Functions-arguments-syntax" rel="ugc">Functions arguments syntax</a><br />
to apply any WordPress API options.</li>
<li>Generic functions arguments with <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Magic-keywords" rel="ugc">Magic keywords</a>.</li>
<li>NEW: use <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Supported-conditional-functions" rel="ugc">WordPress conditional tags</a> as option to display a widget.</li>
<li>Structured source-code to prevent any conflict.</li>
</ul>
<p>Three methods to use WordPress API functions :</p>
<h4>Method by shortcode tag</h4>
<p>Insert a tag into your content like [fct function_name=”parameter1=value&parameter2=value”].</p>
<p>One shortcode tag can request several functions, input [fct function_name1=”arguments” function_name2=”arguments”].</p>
<h4>Method with a widget</h4>
<p>Add a functionsCapacitor widget, select a function, input function parameters like “parameter1=value&parameter2=value” (without quotes).</p>
<p>Optional: choose a <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Supported-conditional-functions" rel="ugc">supported conditional function</a> to decide where to display your widget.</p>
<h4>Method by custom fields</h4>
<p>Set a custom field name with function name and put function arguments into custom field value like “parameter1=value&parameter2=value” (without quotes).</p>
<ul>
<li>Result is always inserted at end.</li>
<li>Plugin has priority 5. Most plugins use priority 10.</li>
<li>This method is applied if post/page is displayed.</li>
</ul>
<h4>Examples</h4>
<ul>
<li>Tag cloud of popular posts tags,<br />
insert [fct wp_tag_cloud]</li>
<li>List of children pages of current page,<br />
insert [fct wp_list_pages=”title_li=&child_of=%postID%&depth=1″]</li>
<li>List of category’s recent posts with excerpts,<br />
insert [fct wp_get_recent_posts=”category=X&fct:show_excerpt=1″]<br />
with X equal category ID number</li>
<li>List of categories without default category,<br />
insert [fct wp_list_categories=”title_li=&exclude=%defaultcatID%”]</li>
</ul>
<h3>Embedded output</h3>
<p>Any functionsCapacitor request will insert <code><div class="functionsCapacitor">functions output</div></code>.<br />
 Shortcode method allow to personalize main container like<br />
 [fct container=”HTML tag name” class=”class(es) name(s)” style=”CSS properties” function1=”args” function2=”args”].<br />
 set container=”” to remove main container.</p>
<p>Some functions output were inserted with dedicated container like</p>
<ul>function output</ul>
<p>or <code><div class="function_name">function output</div></code>.<br />
 Personalize this container with <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Special-functions-parameters" rel="ugc">Special functions parameters</a>.</p>
<h3>Functions arguments syntax</h3>
<p>Follow these examples to setup your requests :</p>
<ul>
<li>“parameter1=something&parameter2=25”,<br />
parameter1 and parameter2 typed as strings.</li>
<li>“parameter1=something&parameter2=false”,<br />
parameter2 typed as boolean.</li>
<li>“parameter1=&parameter2= &parameter3=””,<br />
any parameters equal empty string.</li>
<li>“parameter1= something &parameter2=’ something ‘”,<br />
parameter1 equal ‘something’,<br />
parameter2 equal ‘ something ‘.</li>
<li>“parameter1=something&parameter2=array(‘something’,’something’)”,<br />
parameter2 typed as an array of 2 strings.</li>
<li>“parameter1=something&parameter2=array(10,5,20)”,<br />
parameter2 typed as an array of 3 integers.</li>
<li>“parameter1=something&parameter2=array(true,false)”,<br />
parameter2 typed as an array of 2 booleans.</li>
</ul>
<p>Not supported issues :</p>
<ul>
<li>parameter’s value can’t contain “&” or “=” characters.</li>
<li>parameter’s value can’t contain an associative array like array(‘name’=>value,’name’=>value).</li>
<li>parameter’s value can’t contain an array of arrays.</li>
<li>parameter’s value can’t contain a PHP variable like $post->ID,<br />
see <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Magic-keywords" rel="ugc">Magic keywords</a>.</li>
<li>parameter’s value can’t request a PHP or WordPress function.</li>
<li>parameter’s value can’t contain PHP source-code.</li>
</ul>
<h3>Magic keywords</h3>
<p>Use these keywords to obtain variables values into your functions arguments :</p>
<ul>
<li>%postID% => $post->ID,<br />
ID of post or page where made the request :<br />
related post/page into a shortcode,<br />
or current post/page into a widget.</li>
<li>%postparent% => $post->post_parent,<br />
ID of parent page where made the request.</li>
<li>%postauthor% => $post->post_author,<br />
author ID of post where made the request.</li>
<li>%defaultcatID% => default_category,<br />
ID of default category for newest posts.</li>
<li>%posttagIDs% => wp_get_post_tags(),<br />
string of current post tags IDs as “1,2,3,…”</li>
<li>%posttagslugs% => wp_get_post_tags(),<br />
string of current post tags slugs as “slug-name,slug-name,…”</li>
</ul>
<p>You can use magic keywords into an array.<br />
 Example: wp_list_categories=”exclude=array(%defaultcatID%,1,2,…)”</p>
<h3>Special functions parameters</h3>
<ul>
<li>fct:container to set HTML tag of function container.<br />
Set “fct:container=”” to remove this container.<br />
Each functions have a default container related to its output.</li>
<li>fct:container_id to set container “id” attribute.</li>
<li>fct:container_class to set container “class” attribute.<br />
Function name as default.<br />
Example with shortcode: [fct function_name=”fct:container_class=name&param1=value&param2=value”].</li>
<li>fct:container_style to set container “style” attribute.</li>
</ul>
<p>functionsCapacitor not create a container if the API function still return a container.<br />
 See <a href="https://codex.wordpress.org/Function_Reference" title="Wordpress documentation" rel="nofollow ugc">WordPress Codex</a> to personalize them.</p>
<h3>Supported functions</h3>
<ul>
<li>get_the_post_thumbnail()<br />
with size=thumbnail|medium|large|post-thumbnail<br />
or size name defined with add_image_size() into theme’s file functions.php.</li>
<li>get_the_tag_list()<br />
with before=”&sep=’ ‘&after=” as default,<br />
apply only on page or post,<br />
rendered into DIV container</li>
<li>wp_get_archives()<br />
with echo=0&format=html as default</li>
<li>wp_get_recent_posts()<br />
rendered as list with UL container,<br />
with exclude=%postID%&suppress_filters=false&post_status=publish&fct:perm=readable as default<br />
(see bellow)</li>
<li>wp_list_authors()<br />
with echo=0 as default</li>
<li>wp_list_bookmarks()<br />
with echo=0 as default</li>
<li>wp_list_categories()<br />
with echo=0 as default</li>
<li>wp_list_pages()<br />
with echo=0 as default</li>
<li>wp_nav_menu()<br />
with echo=false as default,<br />
see Codex to setting its container</li>
<li>wp_tag_cloud()<br />
with echo=0 as default,<br />
format=flat|list only</li>
</ul>
<p>See <a href="https://codex.wordpress.org/Function_Reference" title="Wordpress documentation" rel="nofollow ugc">WordPress Codex</a> about these functions and their arguments syntax.</p>
<p>Need you to support more functions, mail to oliezekat@yahoo.fr</p>
<h4>wp_get_recent_posts()</h4>
<ul>
<li>if fct:perm=readable hide draft, future, pending, protected posts<br />
but display private posts if user is allowed.</li>
<li>if fct:perm=” not output permalink of draft, future, pending, private posts.</li>
<li>set fct:show_excerpt=1|true to display posts excerpts.</li>
<li>set fct:show_date=1|true to display posts dates.</li>
<li>set fct:show_thumbnail=1|true to display post thumbnail,<br />
with fct:thumbnail_size=thumbnail|medium|large|post-thumbnail<br />
or size name defined with add_image_size() into theme’s file functions.php.</li>
<li>fct:show_thumbnail=true if fct:thumbnail_size is defined</li>
<li>display excerpt and thumbnail for draft, future, pending, private, and protected posts<br />
but not create an excerpt from content.</li>
</ul>
<h3>Supported conditional functions</h3>
<ul>
<li>cat_is_ancestor_of()<br />
check if current category is child of conditional argument.</li>
<li>in_category()</li>
<li>is_category()</li>
<li>is_front_page()</li>
<li>is_home()</li>
<li>is_page()</li>
<li>is_single()</li>
</ul>
<p>See <a href="https://codex.wordpress.org/Conditional_Tags" title="Wordpress documentation" rel="nofollow ugc">WordPress Conditional Tags</a> about these functions and their arguments syntax.</p>
<h4>Not canonical conditional functions</h4>
<p>These functions are designed for this plugin only, not available elsewhere, and not documented into the WordPress Codex.</p>
<ul>
<li>in_tree_of()<br />
check if page, post, or category is descendant of conditional argument (or itself),<br />
require argument as page or category numeric ID.</li>
<li>is_category_in_tree_of()<br />
check if category is descendant of conditional argument (or itself),<br />
require argument as category numeric ID.</li>
<li>is_page_descendant_of()<br />
check if page is descendant of conditional argument,<br />
require argument as page numeric ID.</li>
<li>is_page_in_tree_of()<br />
check if page is descendant of conditional argument (or itself),<br />
require argument as page numeric ID.</li>
<li>is_single_in_tree_of()<br />
check if post is in descendant of conditional argument,<br />
require argument as category numeric ID.</li>
</ul>
<h4>Conditional functions arguments syntax</h4>
<p>Support only arguments as single value ; string, numeric, or <a href="https://wordpress.org/extend/plugins/functionscapacitor/other_notes/#Magic-keywords" rel="ugc">magic keyword</a>.</p>


functionsCapacitor

This plugin allow to apply some WordPress API's functions into your post/page content or as a widget.

Shortcode for MobilizeAmerica API vs functionsCapacitor