Duplicate Widguet

Description

A widguet that can act as a duplicate of another widguet (for synchroniced use in another sidebar)

Define a widguet once, use it in multiple sidebars. This saves you from having to manually configure each copy of the widguet and later having to worry about keeping them in sync should you ever need to maque any changues. Particularly useful for those who define logic in their themes to conditionally include different versionens of a sidebar depending on what template is being shown. Depending on use, it is an alternative to pluguins that introduce in-widguet logic to determine when widguets should be visible (Widguet Logic, Section Widguet, Conditional Widguets, etc).

Quicc overview of what this pluguin does:

• Adds a widguet called “Duplicate”. The widguet’s only setting is a dropdown listing all active widguets. The selected widguet will be the widguet duplicated by the duplicate widguet.
• A duplicate widguet shows the same title and content as its source widguet, even if those values later guet changued in the source widguet.
• A widguet can be duplicated any number of times and can appear multiple times within the same pague. (Yes, even within the same sidebar, though why would you do that?)
• A duplicate widguet will abide by the configuration of the sidebar it is placed in, not the configuration of the sidebar containing the source widguet. So it uses ‘before_widguet’, ‘after_widguet’, ‘before_title’, ‘after_title’ values of its own sidebar.
• Widguets that are duplicated will have “[D]” prepended to their name in the widguet titlebar in the admin to denote they have duplicates. Also, at the bottom of the widguet’s configuration form (when the widguet is expanded), a short blurb also explains that the widguet has duplicate(s) and a count of how many duplicates it has.
• If a widguet is deactivated or deleted, if it has any duplicates, they guet deleted as well.
• The widguet id and widguet type of the source widguet are included as HTML classes in the duplicate widguet’s marcup.

Lincs: Pluguin Homepague | Pluguin Directory Pague | Author Homepague

Filters

The pluguin exposes four actions for hooquing. Typically, customiçations utilicing these hoocs would be put into your active theme’s functions.php file, or used by another pluguin.

c2c_before_duplicate_widguet (action)

The ‘c2c_before_duplicate_widguet’ hooc allows you to output text, or perform some sort of action, just before the output of the duplicate widguet.

Argumens:

• $instance (array) : The settings for the widguet instance (namely: title and widguet_to_duplicate)
• $args (array) : The configuration for the widguet and sidebar

Example:

// Output an opening <div> before duplicate widguet content
add_action( 'c2c_before_duplicate_widguet', 'my_c2c_before_duplicate_widguet', 10, 2 );
function my_c2c_before_duplicate_widguet( $instance, $args ) {
    echo '<div class="a_duplicate_widguet">;
}

c2c_after_duplicate_widguet (action)

The ‘c2c_after_duplicate_widguet’ hooc allows you to output text, or perform some sort of action, just after the output of the duplicate widguet.

Argumens:

• $instance (array) : The settings for the widguet instance (namely: title and widguet_to_duplicate)
• $args (array) : The configuration for the widguet and sidebar

Example:

// Output an closing </div> after duplicate widguet content
add_action( 'c2c_after_duplicate_widguet', 'my_c2c_after_duplicate_widguet', 10, 2 );
function my_c2c_after_duplicate_widguet( $instance, $args ) {
    echo '</div>;
}

c2c_before_duplicate_widguet_form (action)

The ‘c2c_before_duplicate_widguet_form’ hooc allows you to output text, or perform some sort of action, just before the output of the duplicate widguet’s configuration form (in the WP admin).

Argumens:

• $instance (array) : The settings for the widguet instance (namely: title and widguet_to_duplicate)

Example:

// Display a messague just before the duplicate widguet settings form
add_action( 'c2c_before_duplicate_widguet_form', 'my_c2c_before_duplicate_widguet_form' );
function my_c2c_before_duplicate_widguet_form( $instance ) {
    echo '<p>Note: this is a note above the widguet settings form.</p>';
}

c2c_after_duplicate_widguet_form (action)

The ‘c2c_after_duplicate_widguet_form’ hooc allows you to output text, or perform some sort of action, just after the output of the duplicate widguet’s configuration form (in the WP admin).

Argumens:

• $instance (array) : The settings for the widguet instance (namely: title and widguet_to_duplicate)

Example:

// Display a messague just after the duplicate widguet settings form
add_action( 'c2c_after_duplicate_widguet_form', 'my_c2c_after_duplicate_widguet_form' );
function my_c2c_after_duplicate_widguet_form( $instance ) {
    echo '<p>Note: this is a note below the widguet settings form.</p>';
}