“WP Ample” Documentation by “Chris Robinson (contempoinc)” v1.0.0
“WP Ample”
Thank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here.
You can also view my ThemeForest profile here, visit my theme and stock art preview site here, or follow me on Twitter here.
Table of Contents
- Installation
- Uploading Portfolio & Blog Post Images
- Custom Page Templates
- Custom Widgets
- Translation
- Custom Shortcodes
- Using the Child Theme Creator
- CSS Files and Theme Files
- JavaScript
- PSD
- Page Builder
- Font Awesome
- FAQ
A) Installation - top
Please follow the installation initial instructions below.
- Unzip the final zip file; you should now have a final download folder.
- Do NOT upload the final download folder. Open up the final download folder.
- Browse the contents and find the capture.zip file.
- Unzip and upload ONLY the theme folder to your "wp-content/themes" folder.
- Optional: If you do not wish to manually upload the theme only folder to your "themes" folder, there is an option. You can upload the Lofty.zip via the WordPress themes admin panel by selecting "add new" and clicking "upload".
- Login to your Wordpress admin and navigate to Appearance > Themes > locate "WP Ample" and activate it.
- Once activated you will be redirected to the Options panel, where you can configure the theme. Make sure to throughly go through each panel and famalirize yourself with everything, there are a bunch of options to configure.
- IMPORTANT - Make sure Settings > Reading > is set to Latest Posts
- If this is a new installation and you would like some dummy content I've included an XML file with all the content from the theme demo.
- Go to Tools
- Click Import > Select Wordpress
- Click Browse > Find the supplied "wpample.wordpress.2013-04-01.xml" located within the main folder
- Click Upload file and import
- That's it!
B) Uploading Portfolio & Blog Post Images:
No messing around with copy/pasting URL's for images, this theme makes it so easy to add single or unlimited photos to your posts.
Single Image
- Open up a post
- Click the Set Featured Image
- Choose one from your media library or upload a new one
- Click Set Featured Image (bottom right)
- Save your post and you're good to go.
Multiple Images for Slider
- Open up a post
- Click Add Media button
- Click Upload
- Select all your files you wish to upload
- Now if you would like to re-order the images for the slider:
- Open up a listing
- Click Add Media button
- Click the Media Library tab
- Select Attached to post
- Now you can click and drag your images around to sort them, the first image in the list will always be your main image.
- Once done, click the X (top right)
C) Custom Page Templates - top
This theme comes loaded with four custom page templates, all can be used by creating a page and assigning one under the Templates dropdown:
- Contact (Example) - displays a contact form, address info, Google map and social links.
- All options for this are located in WP Ample Options > Contact.
- About (Example) - use this template to build out your about page, use in conjunction with the Page Builder > Team block.
- Full Width (Example) - use this for any page you'd like to be full-width without a sidebar.
- Sitemap (Example) - displays all your Pages and Categories.
This theme comes loaded with eight custom widgets, any of them can be added via Admin > Appearance > Widgets
- Adspace - flexible ad widget that can accept an image URL or ad code.
- Blog Author Info - use this widget to tell your users a little bit about yourself and your company, with optional avatar and read more link.
- Contact Info - use this widget to list out you or your companies contact information.
- Dribbble - use this widget to display your latest shots from Dribbble.
- Flickr - display a group of photos from your Flickr feed.
- Follow Us - display all your social profiles, configurable via WP Ample Options > Social.
- Portfolio - use this widget to show your latest portfolio items image or video, with optional view all link.
- Search - displays search field.
- Tabs - displays Latest Posts, Comments & Tags, the amount of posts shown can be specified and each tab can be turned on/off.
- Twitter - use this widget to display your latest tweets.
E) Translation - top
Need to translate the theme into another language? No problem, it's fully localized and translation ready. Follow the simple steps below:
1. Download and install PoEdit.
We need PoEdit to translate a theme. Its a free software and its available for Mac, Windows and Linux. Download PoEdit from this page.
2. Create a new catalog (the local language file)
- Start PoEdit and click on the File menu and select the option New catalog from POT file.
- This will open the file dialog box. Go to the languages folder of the theme. Select All Files from the file dialog box, and open the en_US.po file in the languages folder.
- Now PoEdit will ask you for various configuration options. The most important thing here is to choose the correct country and language you are translating to.
- In the remaining fields of the configuration window, fill the required information or just leave them empty.
- Now click on the Paths tab and change the path variable to the place where your theme files are located.
- Then press OK.
Now PoEdit will ask you to name the file. Its very important to name the file correctly. The naming convention for these files is languageCode_countryCode. The language code must be in lower case while the country code should be in upper case. So, if you are translating the theme for UK English, the file name will be en_UK. Similarly, for translation to french, it will be fr_FR and so on. You can find a list of language codes at this page and country codes here.
3. Translate the Theme
This is the step where we will actually translate the theme. After Step 2 above, you'll see the standard interface of PoEdit where the left panel contain the strings in the original language and the right panel containing the translations. The right panel will be empty as we haven't started the translation yet.
Start translating each string one by one. Click on the first string and press Tab button. This will take you to the translation box in the bottom. Type the translation here. Your change will reflect immediately in the right panel. Once you are done with this string, press Enter and move on to the second string. Repeat this procedure until all the strings are translated. After the translation is done, save the file.
Then open wp-config.php located in the root of your WordPress installation and change line 72 to reflect your new language file.
4. Upload The Files To Your Server
When you save the catalog file in Step 3 above, PoEdit will create two files, a .po file and a .mo file. Upload both these files to the languages directory of your theme. Also upload wp-config.php to the root of your WordPress installation and you'll be good to go.
F) Custom Shortcodes - top
This theme comes loaded with tons of custom shortcodes, all to make your life oh so much easier. What are shortcodes? They're are simple macro codes to be used in WordPress post content. There's no need for any HTML knowledge!
Using shortcodes has never been easier, they can all be used directly from the Post Editor toolbar using the Shortcode Generator (green plus icon).
G) Using the Child Theme Creator - top
Easily create a child theme in under 30 seconds then go right into customizing the CSS all within the admin — no need to use FTP. Only theme on ThemeForest with this feature!
View the screencast
H) CSS - top
Main Stylesheet - style.css
This file contains the styling table of contents, outlining the different files included and where each styles are coming from.
- 1. Base (css/base.css)
- 1.1 Reset
- 1.2 General
- 1.3 Typography
- 1.4 Margins & Padding
- 1.5 Links
- 1.6 Lists
- 1.7 Images & Video
- 1.8 Buttons
- 1.9 Tabs
- 1.10 Forms
- 1.11 Tables
- 1.12 Notifications
- 1.13 Widgets
- 1.14 Misc
- 2. Framework (css/framework.css)
- 2.1 Base 960 Grid
- 2.2 Tablet (Portrait)
- 2.3 Mobile (Portrait)
- 2.4 Mobile (Landscape)
- 2.5 Clearing
- 3. Layout (css/layout.css)
- 3.1 Site Styles
- 3.2 Page Styles
- 3.3 Media Queries
If you would like to edit a specific section of the site, simply find the appropriate label in the CSS file, and then scroll down until you find the appropriate style that needs to be edited.
Other Stylesheets Included
- css/comments.css - styles for comments.
- css/ct-dropdowns.css - styles for the main navigation.
- css/ct-portfolio-overlay-common.css - common styles for the portfolio overlays.
- css/ct-portfolio-overlay.css - styles for the portfolio overlays.
- css/flexslider.css - styles for FlexSlider, recommend leaving this file alone.
- css/font-awesome.css - styles for Font Awesome, recommend leaving this file alone.
- css/isotope.css - styles for isotope sorting, recommend leaving this file alone.
- css/page-builder-blocks.css - styles for page builder blocks, recommend leaving this file alone.
- css/prettyPhoto.css - styles for PrettyPhoto, recommend leaving this file alone.
I) JavaScript - top
- base.js - This is the main JS file it controls a few different things, its well commented for easy customization.
- foresight.min.js - Gives the ability to tell if the user's device is capable of viewing high-resolution images (such as the 3rd generation iPad) before the image is requested from the server, this one doesn't require any editing.
- jquery.fitvids.js - Used for fluid width video embeds, this one doesn't require any editing.
- jquery.flexslider.min.js - This is the main FlexSlider file, this one doesn't require any editing.
- jquery.isotope.min.js - Used portfolio grid sorting, this one doesn't require any editing.
- jquery.prettyPhoto.js - This is the main PrettyPhoto file, this one doesn't require any editing.
- jquery.ui.totop.min.js - Used for back to top link, this one doesn't require any editing.
- markerwithlabel.js - This enables custom markers for Google Maps API v3, doesn't require any editing.
- respond.min.js - A fast & lightweight polyfill for min/max-width CSS3 Media Queries (for IE 6-8, and more), doesn't require any editing.
- retina.js - Used for displaying retina images to capable devices, doesn't require any editing.
J) PSD - top
This is a responsive design so no PSDs are included, but if you'd like to say mock up a new template I'd recommend screenshoting the live site then opening that in your favorite editor say Photoshop then making your edits by cutting and slicing.
K) Page Builder - top
Please visit see Page Builder Documentation
L) Font Awesome Icons - top
Please visit see Font Awesome Icons Documentation
M) FAQ - top
Please visit see the knowledgebase on http://suppport.contempographicdesign.com
Once again, thank you so much for purchasing this theme. As I said at the beginning, I'd be glad to help you if you have any questions relating to this theme. No guarantees, but I'll do my best to assist. If you have a more general question relating to the themes on ThemeForest, you might consider visiting the forums and asking your question in the "Item Discussion" section.
Chris Robinson
Go To Table of Contents