You are here: Home » PhotoSmash » How-to » Getting Started

Getting Started

Using PhotoSmash is extremely simple:

  1. Download PhotoSmash and unzip…you should wind up with a folder named: bwb-photosmash
  2. Upload the bwb-photosmash plugin folder to your /wp-content/plugins/ folder
  3. In the Plugins page of your WordPress Admin, activate PhotoSmash
  4. There are 3 ways to add new galleries to your posts:
    1. Under settings, go to the PhotoSmash options page and turn on Auto-adding of galleries.  You can auto-add galleries to the top of each post or the bottom of each post by changing the drop down to the correct selection.  Click Update Defaults button to save changes
    2. Also in the PhotoSmash options page, scroll down below the PhotoSmash defaults section and select New in the gallery drop down.  Fill in the details you want to use for the new gallery, and click the Save Gallery button to create the new gallery.  After the save is complete, select your new gallery from the Gallery drop down and click the Edit button to retrieve it.  The code (like [\photosmash id=1\]  (without the slashes))for adding this specific gallery to any post or page will be beneath the Gallery drop down.  Cut and past the code anywhere you like in your posts or pages.  You can also specify multiple specific galleries within a single post or page by putting the tags with their ids in as needed.
    3. PhotoSmash can also create galleries on the fly for specific posts.  Simply enter the following code anywhere you like in posts or pages and a gallery will be automatically created:   [\photosmash\] (withouth the slashes) The code should include everything in red, including the braces and the = sign.
  5. To add photos to your galleries, go to the post or page and click Add Photos link.  I’m not sure what the size limit is right now.  It may vary based on your php.ini settings.
  6. If you choose to let Registered users upload photos, their photos will be visible to Admins and the themselves only.  Admins will be presented with buttons for Approve or Bury.  Approve is self explanatory.  Bury simply deletes the record from the database and deletes (unlinks in PHP terms) the files from the bwbps and bwbps/thumbs/ folders in the wp-content/uploads/ folder
  7. You will receive an email alert for photos requiring moderation.  These alerts use a pseudo-cron like scheduling scheme that is triggered whenever someone views one of your blog’s pages.  You can set the alert program to check every 10 minutes, 1 hour, or 1  day, or not at all.
  8. To edit a photo’s caption, go to the PhotoSmash options page in wp-admin.  Select the desired gallery from the drop down and click Edit.  When the page comes back, the images for that gallery will show up at the bottom of the page.  There will be text boxes beneath image allowing you to edit captions.  Click save to save caption edits.  Approve buttons will be present for images needing moderation.  Delete will be available for all images.
  9. To integrate with Lightbox or Shadowbox, simply include the correct “rel” information in the Gallery specific options on the PhotoSmash options page.  You can set your general PhotoSmash default rel in PhotoSmash Defaults section so that any newly created galleries will automatically get the rel.   For Lightbox, set the rel to lightbox.  Shadowbox can use lightbox or shadowbox.  To group a galleries images together as an album for Shadowbox, use something like:  shadowbox[album] as the gallery’s rel.
  10. To prevent a post from receiving a gallery when Auto-add is activated, simply enter the following tag anywhere in the post’s content:  [\ps-skip\] (without the slashes)
  11. To use with Role Manager plugin:  the Role Manager plugin lets you give specific subscribers additional capabilities.  PhotoSmash supports these capabilities by allowing you to give users additional access to galleries that their roles do not allow (e.g. a Subscriber could upload to a gallery that is set to Admins only).  Here are the steps:
    1. Install the Role Manager Plugin (see link above)
    2. In the Users menu box in Admin, click on Capabilities
    3. Add a capability called:  Upload to PhotoSmash
    4. To assign this capability to a user, click Authors & Users
    5. Edit the user you are targeting
    6. At bottom of user profile screen, check the Upload to PhotoSmash checkbox in the Assign extra capabilities section and Save (Update) user…this user can now upload to any gallery regardless of the minimum role you have specified for those galleries.
    7. To target a specific gallery, in #3, create the capability:  Photosmash ? (where ? is the gallery ID #, e.g.  Photosmash 10 ).  You can find the gallery ID # in the Gallery Settings screen in PhotoSmash admin section.  It is the same number that is used in the shortcode that can be used to specify a gallery.  Choose this capability in #6 instead of the Upload to Photosmash capability.  Assigning both would be redundant since Upload to Photosmash gives access to all galleries.  You can assign as many specific galleries to a user as you like.
    8. To add the URL field to the upload form and use the user submitted URLs as the link for your captions, there are 2 settings needed to use feature: 1) you must turn on the field to show up in the Upload Form. Do this in PhotoSmash Settings / Gallery Defaults tab, the checkbox at the bottom of form. 2) There are 2 options in Gallery Settings and PhotoSmash Settings pages under the Viewing tab and in the Image caption style that will use the User submitted URL as the caption link…look at option #3 and the last one.
  12. Whew…that’s about it….I think.