# Instructions

This theme is a child theme for Modularity, a multimedia theme framework for Wordpress. The theme design was developed with users who appreciate visual browsing and prefer a minimal layout, with their photos and multimedia featured front and center. But, the theme can been used to create everything from e-commerce sites, music review sites, portfolio sites, and everything in between. Homepage designs can be turned on and off at the click of a button on the Theme Options panel. Subscribe to Graph Paper Press' feed or follow us on the bleeding edge of development by following us on Twitter.

Here is a brief list of the major features:

- Theme options panel to configure homepage design, easy logo insertion, css style over-ride, insert ads and more
- Automatic thumbnail generator with the ability to override the automated thumbnails
- Built-in HD video player for self-hosting HD quality video, multiple videos in a post
- Ability to embed any kind of Flash media via custom fields.
- Three footer widgets
- Multi-tier drop-down navigation to maximize homepage space
- Built atop CSS frameworks to speed customization
- Forward and backward compatibility with previous versions of Wordpress
- XHTML: This theme has been tested on Firefox, Safari, IE 8, 7, 6.

### Best Practices

If you want to make changes to how this theme looks and feels, than create a child theme. Never make changes to the original theme files. Why? Because when a new version of this theme is released, all of your changes will be lost when you update. Plus, making a child theme is incredibly easy. Here is how you do it.

1. ### Installation

   1. Unzip the folder contained in the archive to your computer
   2. Upload the folder and its contents to the themes directory of your blog, located in "wp-content/themes" where WordPress is installed.
   3. Click on Appearance - Themes menu from the WP admin panel, then select the theme to activate.
   4. Click on View Site at the top of the page. Bam. Hot site!

2. ### Initial setup

   This theme is a 950px wide, one or two column theme, depending on options you have chosen. We need to set up your default image and thumbnail sizes to allow for easy posting and consistent design structure. Click Settings - Media and set your thumbnail size to 310px wide by 150px tall. Set your medium size images to 590px wide. Do not set the height. Set your large size images to 950px wide. Do not set the height. Post thumbnails are generated automatically by the functions contained in this theme. By default, the theme pulls in the latest image uploaded to the post. There is no need to use custom fields for adding post thumbnails. Simply upload your images using Wordpress' new Add Media button, write a caption and description and click save. While the theme will pull in the thumbnail automatically, it will not add the medium or large sized image to your post automatically. For that, just click the insert image button just as you normally would. If you need additional instructions on uploading photos, inserting photo galleries and using the Wordpress interface, please view this screencast.

3. ### Media settings

   1. In Wordpress, click on Media Settings. Set your thumbnails to 310 x 150. Set your medium photo size to 590. Set your large size to 950.
   2. This theme will automatically create thumbnails from the images that you upload. By default, the thumbnail size is 150 x 150. This can be easily changed, if you know a little bit of CSS.
   3. If you plan on self-hosting your own video to use the theme's built-in HD video player, you need to use the Post Thumbnail text field on the Write Post panel and paste the URL to your video thumbnail. The dimensions of the thumbnail should exactly match the dimensions of the video dimensions that you plug into the Post Video Options panel.

4. ### Theme Options

   This theme has seven optional homepage designs:

   1. Slideshow Section - A full page slideshow
   2. HD Video Section - A full page video presentation
   3. Featured Sliding Posts - A horizontal slider that reveals six featured posts
   4. Thumbnail Slider - A horizontal list of thumbnails representing recent posts
   5. Featured Section - A main post at left, with three earlier posts at right
   6. Blog Section- A normal tubular list of posts
   7. Categories Section - A five column grid of selected categories

   Please activate each option and view your new homepage design. Remember, less is more.

5. ### Navigation

   The navigation contains a listing of all your pages and posts, your contact info and the search bar. You can set or remove the contact info from the Theme Options panel. For further reading, please see these instructions.

6. ### Video

   Modularity has a built-in HD video player that plays FLV video files. You are no longer restricted to pixelated YouTube videos. To add a video, upload the FLV file to your server using your favorite method, like FTP. Copy and paste the link to the file into a custom field called video. Next, add a video thumbnail. You can do this the exact way that you add regular thumbnails, except, you will want to add an image large enough to fit the maximum size of the video player, for best results try an image that is 950px wide. Add the video thumbnail to a custom field with key value video-thumb. For multiple videos within a post or page, try different values for the same video key which mean you can have 2 or more instances of video key. Same goes for video-thumb. Note that each thumbnail should be in the same precedence as that of video for them to match. You can also add other multimedia, which can include virtually any media with embed capabilities. Enter "multimedia" as the key value and paste your YouTube, Vimeo, or any other html embed code into the value field. You can read more about using custom fields here.

7. ### Thumbnails

   By default, thumbnails are auto cropped by Wordpress. This theme checks first to see if you have added the URL to your prefered thumbnail to custom field called, you guessed it, thumbnail. If not, the theme will defer to the first photo that you uploaded using Wordpress' Add Photo icon. If you haven't uploaded a photo using the Add Photo icon, the theme will can the post body for an image, and use it. If no photo exists in the post body, the theme will use a default image. As you can see, this series of "checks" allow you to have 100% control over your post thumnbnails. If you want to add cropping functionlity to your Wordpress site, please download and install the Sissors plugin.

8. ### Widgets

   There are a total of three widgetized areas on this theme, depending on which options you activate on the Theme Options panel. Three widgetized areas appear on the bottom and there is one sidebar widget. You can add and delete widgets by clicking Design - Widgets, from within your Wordpress admin panel.

9. ### Advertising

   This theme has two built-in spots for advertising: One in the sidebar, which measures 310 pixels wide, and one underneath the main post, which measures 590 pixels wide. You can add your adversing code on the Theme Options panel.

10. ### Common problems

    This theme uses jQuery javascript to do lots of fancy stuff. If your theme looks broken, than you likely have a plugin that uses a conflicting javascript library. Deactivate your plugins, one-by-one, to determine which plugin is conflicting with jQuery.

    Still having trouble? Consider becoming a member of Graph Paper Press so you can get access to our private, well-groomed support forum, tutorials, and additional themes.

11. ### Recommended plugins

    - Fancybox: The best lightbox plugin available, currently seen on Apple.com.
    - WP Super Cache: This plugin generates static html files from your dynamic WordPress blog. After a html file is generated your webserver will serve that file instead of processing the comparatively heavier and more expensive WordPress PHP scripts.

12. ### Credits

    - Thad Allender is the principal designer/developer.
    - Chandra Maharzan is the genius debugger/developer.