Urgent! - 20080921

Should be stable now.

Introduction:

SmugWP started off simple enough; create a gallery for the client, give the client the Gallery ID, the client enters the ID into a simple interface and is redirected to the correct gallery. It is functionality similar to the DigiProofs interface. And things just got a touch out of hand from there.

At this point I would almost call SmugWP the WPG2 of SmugMug.

You can now browse your SmugMug galleries, preview images, and insert them into your Post or Page. Also, if you have WP Lightbox 2 installed, it can pre-format the insertion to properly display the linked image in a lightbox.

The original purpose of the plug-in remains.

It still displays a form to evaluate Gallery IDs (which are, unfortunately global), confirms that you own the ID, and redirects the user to YOUR Gallery. It now fully supports and confirms both the Gallery ID and the Key (the entire NNNNNNN_XXXXX string).

Simply hide all proofing and delivery galleries, and only display your sample galleries. This keeps your SmugMug interface clean, and ensures that proofing galleries are private and secure. It especially helps if you have a fully customized SmugMug template to match your WordPress site.

Usage:

Configuration

• Username - This is the username you use to log in to your Smug Mug Account (this is usually an email address).
• Password - Like above, this is your password you use to access your SmugMug account.
• Display Key - Place this text in on one of your Posts or Pages, and during the display process SmugWP will replace this key with the form code you enter in the Form Code field.
• Request Key - This is the name of the field that will contain the Gallery ID to be confirmed when the form is submitted (<input type="text" name="this_is_the_Request_key" />).
• Form Code - This is the HTML that makes up the form that will be displayed in place of the Display Key in your Posts or Pages.
• WP lightbox 2 Support - Turn WP Lightbox 2 support/alerts on or off.

Browse and Insert

Styling

Once images are inserted into your Post/Page, it is easy to style the appearance of your images.

Images are assigned Classes based on their Float, Image ID and Group, with the prefix “swpFL_,” “swpID_,” and “swpGR_” respectively. Further, images with a Float to Center are enclosed in a DIV tag with the same classes.

For example, an image with a Float to the Left, an ID of 285311744, and in a group of “Awesome,” will have the classes of “swpFL_Left,” “swpID_285311744,” and “swpGR_Awesome.” If you want to see how it works, just check out the SmugWP.css file in the SmugWP folder. But be careful what you change there, as your changes may be overwritten if you ever update SmugWP.

The Form and Gallery Confirm/Redirect

This is where it all started. This works by displaying the Form Code (designated on the SmugWP Options page) in place of “[ smugWPform ]” (minus the quotes and spaces) in any Post of Page in your blog.

The plugin will then evaluate the contents of the designated field in the form (again, you set this to match the form field on the SmugWP Options page) when it is submitted, to confirm that the Gallery ID (the entire NNNNNNN_XXXXX string) supplied is owned by YOU, the blog owner. If you do own the Gallery, the plugin then redirects the user to the Gallery.

Why do this? Well, a simple redirect would KIND of do the trick, but if the Gallery ID did not exist, or wasn’t owned by you, the user would land either on the SmugMug Home Page, or inside someone else’s gallery. Not so good.

If you have your SmugMug account fully customized to match your website, this makes for a seamless transition, that conveys professionalism and continuity.

Websites using Smug WP

• Trotamundo Travel Tales - Requires Log-In

Frequently Asked Questions

I get an error when I try to access my galleries through SmugWP.

Check your Username and Password. Better yet, check your Dashboard, any crazy red messages popping up? Read them.

Can I display the SmugWP form inside a PHP template?

Yes, simply call the function sWP_displayForm(); anywhere where you can execute PHP. This function does not hook for displaying CSS, as it is too far into the execution of the document, but as long as it is on a WordPress page (template) you should have no problems, as the CSS is hooked to the head of all WordPress pages automatically.

Installation:

• Download and unzip the latest version of the plug-in.
• If you have a previous version of SmugWP installed, disable it on the WordPress Plugins page.
• Place the “SmugWP” folder in your “wp-content/plugins/” directory (over write the old folder if it exists).
• Activate SmugWP on the WordPress Plugins page.
• Enter your Username and Password on SmugWP Options page, under the Options tab.
• Designate a page to check for form display (enter the page ID on the SmugWP Options page).
• Insert “[ smugWPform ]” (minus the quotes and spaces) in the source of any page or post you want to display the form on.

Versions:

• SmugWP v3.1 - (in the oven)
  • Support for SmugMug Video. -> (planned)
  • Random Image Widget. -> (planned)
  • Recent Images Widget (by Album or Account). -> (planned)
  • Recent Images in Album ShortCode (for Recent Images display in Post/Page). -> (planned)
  • Current Recent Images block insert (to insert a block element of recent images at-time-of-posting into Post/Page). -> (planned)
• SmugWP v3.04 - (released September 21st, 2008)
  • Fixed pertinent issues in WP v2.6
  • Fixed Username and Password issues.