MasterWish WordPress Plugin

I am pleased to announce the arrival of the MasterWish WordPress plugin! Anyone that has an account on MasterWish and runs a WordPress blog can aggregate their publicly viewable lists. For an example of how I have it set up, check here.

Get the MasterWish WordPress plugin v1.1!

Setup Instructions:
Installing the Plugin:

1. Download and unzip wp-masterwish.zip

2. Place masterwish.php in your wp-content/plugins directory
3. Log in to your WordPress admin panel and activate the plugin, then visit the MasterWish submenu of the options tab.
4. Enter your MasterWish username and click ‘Update Options’
5. If you want a default list to be selected, select a list from the List drop-down menu and click ‘Update Options.’
6. Create a new Template for your wishlist in your wp-content/themes directory.

In the body section of that template, we suggest you place the following function calls:

<h2><a href=”<?php masterwish_list_url($_GET['list_id']); ?>”><?php masterwish_list_title($_GET['list_id']); ?></a></h2>
<strong>My Lists</strong>: <?php masterwish_lists(”,’[','] ‘); ?><br/><br/>
<?php masterwish_get_list(); ?>

7. Create a new Page in WordPress and set its template to the template you just created in the previous step!

MasterWish Plugin Functions:

  • masterwish_get_list

    retrieves items from a list

    Usage:

    masterwish_get_list({list_id},{display_images},{maxresults},{random});

    list_id is the wishlist id number that is being browsed. Leaving this with a blank string ” pulls the default list set in the MasterWish Plugin’s options tab.
    display_images specifies whether the item images are displayed. Default is false. Available options: (true/false).
    maxresults is the maximum number of items you want displayed in a given list. Setting this value to 0 displays all items in a list.
    random shuffles your item list around.

  • masterwish_list_title

    retrieves the current list title

    Usage:

    masterwish_list_title({list_id},{return},{before},{after});

    list_id is the wishlist id number that is being browsed. Leaving this with a blank string ” pulls the default list set in the MasterWish Plugin’s options tab.
    return specifies whether you want the title returned or echoed. Default value is false, available options (true/false).
    before is what you want prepended to the wishlist title.
    after is what you want appended to the wishlist title.

  • masterwish_list_url

    retrieves the current list url

    Usage:

    masterwish_list_url({list_id},{return});

    list_id is the wishlist id number that is being browsed. Leaving this with a blank string ” pulls the default list set in the MasterWish Plugin’s options tab.
    return specifies whether you want the title returned or printed on the screen. Default value is false, available options (true/false).

  • masterwish_lists

    retrieves the user’s publicly viewable lists

    Usage:

    masterwish_lists({list_id},{before},{after},{return});

    list_id is the wishlist id number that is being browsed. Leaving this with a blank string ” pulls the default list set in the MasterWish Plugin’s options tab.
    before is what you want prepended to each wishlist title.
    after is what you want appended to each wishlist title.

    return specifies whether you want the lists returned or printed on the screen. Default value is false, available options (true/false).