Scott Reilly

<p>A widget that can act as a duplicate of another widget (for synchronized use in another sidebar)</p>
<p>Define a widget once, use it in multiple sidebars.  This saves you from having to manually configure each copy of the widget and later having to worry about keeping them in sync should you ever need to make any changes.  Particularly useful for those who define logic in their themes to conditionally include different versions of a sidebar depending on what template is being shown. Depending on use, it is an alternative to plugins that introduce in-widget logic to determine when widgets should be visible (Widget Logic, Section Widget, Conditional Widgets, etc).</p>
<p>Quick overview of what this plugin does:</p>
<ul>
<li>Adds a widget called “Duplicate”. The widget’s only setting is a dropdown listing all active widgets.  The selected widget will be the widget duplicated by the duplicate widget.</li>
<li>A duplicate widget shows the same title and content as its source widget, even if those values later get changed in the source widget.</li>
<li>A widget can be duplicated any number of times and can appear multiple times within the same page. (Yes, even within the same sidebar, though why would you do that?)</li>
<li>A duplicate widget will abide by the configuration of the sidebar it is placed in, not the configuration of the sidebar containing the source widget.  So it uses ‘before_widget’, ‘after_widget’, ‘before_title’, ‘after_title’ values of its own sidebar.</li>
<li>Widgets that are duplicated will have “[D]” prepended to their name in the widget titlebar in the admin to denote they have duplicates.  Also, at the bottom of the widget’s configuration form (when the widget is expanded), a short blurb also explains that the widget has duplicate(s) and a count of how many duplicates it has.</li>
<li>If a widget is deactivated or deleted, if it has any duplicates, they get deleted as well.</li>
<li>The widget id and widget type of the source widget are included as HTML classes in the duplicate widget’s markup.</li>
</ul>
<p>Links: <a href="http://coffee2code.com/wp-plugins/duplicate-widget/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/extend/plugins/duplicate-widget/" rel="ugc">Plugin Directory Page</a> | <a href="http://coffee2code.com" rel="nofollow ugc">Author Homepage</a></p>
<h3>Filters</h3>
<p>The plugin exposes four actions for hooking.  Typically, customizations utilizing these hooks would be put into your active theme’s functions.php file, or used by another plugin.</p>
<h4>c2c_before_duplicate_widget (action)</h4>
<p>The ‘c2c_before_duplicate_widget’ hook allows you to output text, or perform some sort of action, just before the output of the duplicate widget.</p>
<p>Arguments:</p>
<ul>
<li>$instance (array) : The settings for the widget instance (namely: title and widget_to_duplicate)</li>
<li>$args (array) : The configuration for the widget and sidebar</li>
</ul>
<p>Example:</p>
<pre><code>// Output an opening <div> before duplicate widget content
add_action( 'c2c_before_duplicate_widget', 'my_c2c_before_duplicate_widget', 10, 2 );
function my_c2c_before_duplicate_widget( $instance, $args ) {
    echo '<div class="a_duplicate_widget">;
}
</code></pre>
<h4>c2c_after_duplicate_widget (action)</h4>
<p>The ‘c2c_after_duplicate_widget’ hook allows you to output text, or perform some sort of action, just after the output of the duplicate widget.</p>
<p>Arguments:</p>
<ul>
<li>$instance (array) : The settings for the widget instance (namely: title and widget_to_duplicate)</li>
<li>$args (array) : The configuration for the widget and sidebar</li>
</ul>
<p>Example:</p>
<pre><code>// Output an closing </div> after duplicate widget content
add_action( 'c2c_after_duplicate_widget', 'my_c2c_after_duplicate_widget', 10, 2 );
function my_c2c_after_duplicate_widget( $instance, $args ) {
    echo '</div>;
}
</code></pre>
<h4>c2c_before_duplicate_widget_form (action)</h4>
<p>The ‘c2c_before_duplicate_widget_form’ hook allows you to output text, or perform some sort of action, just before the output of the duplicate widget’s configuration form (in the WP admin).</p>
<p>Arguments:</p>
<ul>
<li>$instance (array) : The settings for the widget instance (namely: title and widget_to_duplicate)</li>
</ul>
<p>Example:</p>
<pre><code>// Display a message just before the duplicate widget settings form
add_action( 'c2c_before_duplicate_widget_form', 'my_c2c_before_duplicate_widget_form' );
function my_c2c_before_duplicate_widget_form( $instance ) {
    echo '<p>Note: this is a note above the widget settings form.</p>';
}
</code></pre>
<h4>c2c_after_duplicate_widget_form (action)</h4>
<p>The ‘c2c_after_duplicate_widget_form’ hook allows you to output text, or perform some sort of action, just after the output of the duplicate widget’s configuration form (in the WP admin).</p>
<p>Arguments:</p>
<ul>
<li>$instance (array) : The settings for the widget instance (namely: title and widget_to_duplicate)</li>
</ul>
<p>Example:</p>
<pre><code>// Display a message just after the duplicate widget settings form
add_action( 'c2c_after_duplicate_widget_form', 'my_c2c_after_duplicate_widget_form' );
function my_c2c_after_duplicate_widget_form( $instance ) {
    echo '<p>Note: this is a note below the widget settings form.</p>';
}
</code></pre>


Duplicate Widget

A widget that can act as a duplicate of another widget (for synchronized use in another sidebar)

<p>This plugin provides a template tag which acts a modified version of WordPress’s built-in template tag, <code>the_category()</code>. <code>the_category()</code> lists all categories directly assigned to the specified post. <code>c2c_peer_categories()</code> lists those categories <em>PLUS</em> any categories that are peer to those categories and <em>MINUS</em> categories that are parents to other assigned categories. Peer categories are categories that all share the same category parent.</p>
<p>For example, assume your category structure is hierarchical and looks like this:</p>
<pre><code>Vegetables
|-- Leafy
|   |-- Broccoli
|   |-- Bok Choy
|   |-- Celery
|-- Fruiting
|   |-- Bell Pepper
|   |-- Cucumber
|   |-- Pumpkin
|-- Podded
|   |-- Chickpea
|   |-- Lentil
|   |-- Soybean
</code></pre>
<p>If you directly assigned the categories “Fruiting” and “Pumpkin” to a post, <code>peer_categories()</code> would return a list that consists of: “Bell Pepper”, “Cucumber”, and “Pumpkin”. Notice that since “Fruiting” was a parent to a directly assigned category, it and its peers are not included in the list. If only “Fruiting” were selected as a category, then “Leafy”, “Fruiting”, and “Podded” would have been listed.</p>
<p>By default, categories are listed as an HTML list. The first argument to the template tag allows you to define a custom separator, e.g. to have a simple comma-separated list of peer categories: <code><?php c2c_peer_categories(', '); ?></code>.</p>
<p>As with categories listed via <code>the_category()</code>, categories that are listed are presented as links to the respective category’s archive page.</p>
<p>Example usage (based on preceding example):</p>
<ul>
<li><code><?php c2c_peer_categories(); ?></code></li>
</ul>
<p>Outputs something like:</p>
<pre><code><ul><li><a href="https://example.com/category/fruiting/bell-pepper">Bell Pepper</a></li>
<li><a href="https://example.com/category/fruiting/cucumber">Cucumber</a></li>
<li><a href="https://example.com/category/fruiting/pumpkin">Pumpkin</a></li></ul>
</code></pre>
<ul>
<li><code><?php c2c_peer_categories( ', ' ); ?></ul></code></li>
</ul>
<p>Outputs something like:</p>
<pre><code><a href="https://example.com/category/fruiting/bell-pepper">Bell Pepper</a>, <a href="https://example.com/category/fruiting/cucumber">Cucumber</a>, <a href="https://example.com/category/fruiting/pumpkin">Pumpkin</a>
</code></pre>
<p>Links: <a href="https://coffee2code.com/wp-plugins/peer-categories/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/plugins/peer-categories/" rel="ugc">Plugin Directory Page</a> | <a href="https://github.com/coffee2code/peer-categories/" rel="nofollow ugc">GitHub</a> | <a href="https://coffee2code.com" rel="nofollow ugc">Author Homepage</a></p>
<h3>Developer Documentation</h3>
<p>Developer documentation can be found in <a href="https://github.com/coffee2code/peer-categories/blob/master/DEVELOPER-DOCS.md" rel="nofollow ugc">DEVELOPER-DOCS.md</a>. That documentation covers the template tags and hooks provided by the plugin.</p>
<p>As an overview, these are the template tags provided by the plugin:</p>
<ul>
<li><code>c2c_peer_categories()</code>          : Outputs the peer categories.</li>
<li><code>c2c_get_peer_categories_list()</code> : Returns the list of peer categories.</li>
<li><code>c2c_get_peer_categories()</code>      : Returns the list of peer categories for the specified post.</li>
</ul>
<p>These are the hooks provided by the plugin:</p>
<ul>
<li><code>c2c_peer_categories</code> <em>(action)</em>, <code>c2c_get_peer_categories_list</code>, <code>c2c_get_peer_categories</code> <em>(filters)</em> :<br />
Allows for an alternative approach to safely invoke each of the identically named functions in such a way that if the plugin were deactivated or deleted, then your calls to the functions won’t cause errors on your site.</li>
<li><code>c2c_peer_categories_list</code> <em>(filter)</em> :<br />
Customizes the return value of the <code>c2c_peer_categories_list()</code> function.</li>
<li><code>c2c_get_peer_categories_omit_ancestors</code> <em>(filter)</em> :<br />
Customizes the function argument indicating if ancestor categories of all directly assigned categories (even if directly assigned themselves) should be omitted from the return list of categories.</li>
</ul>


Peer Categories

List the categories that are peer (i.e. share the same category parent) to all lowest-level assigned categories for the specified post.

Duplicate Widget vs Peer Categories