“PinThis” Documentation by PixelBeautify.com


“PinThis” - Best Pinterest Style Wordpress Theme

Created: 10/04/2014
By: PixelBeautify.com
Email: support@pixelbeautify.com

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. Thanks so much!


Table of Contents

  1. Getting Started
    1. Included Files
    2. Installation Options
    3. FTP Upload
    4. Wordpress Upload
    5. Importing Dummy Content
    6. Theme Support
  2. Theme Options - PB Panel
    1. Main
    2. Branding
    3. Slider
    4. SEO
    5. Social Networks
    6. Reset
  3. Using the Menu System
    1. Creating Menus & Adding to Theme Locations
    2. Submenus
  4. Custom Post Formats
    1. Standard
    2. Aside
    3. Image
    4. Quote
    5. Status
    6. Audio
    7. Video
  5. Custom Widgets
  6. Extras
    1. Magnific Popup
    2. Add Link to External Website
  7. Google Adsense
  8. Translating the theme
    1. Tools
    2. How to translate the theme
    3. Saving the translation
    4. How to use the translation
  9. How to Install a Child Theme
  10. Updating the theme
  11. Credits

1. Getting Started - top


A few words on getting started with PinThis, package files & theme support.

a) Included Files - top

After downloading the theme package un-zip it. Inside the package you will find the following files:

b) Installation Options - top

We assume you already have the default wordpress installed in your server.

To install PinThis wordpress theme (that you’ve already downloaded and un-packed) you have two primary options: FTP or WordPress theme upload from the Dashboard.

c) FTP Upload - top

To manually upload PinThis wordpress theme, login with your credentials to your website and locate the /wp-content/themes directory on your server. Upload the un-zipped theme folder into the: yourdomain.com/wp-content/themes.

Note: Please ensure you are uploading the un-zipped theme folder, not the entire package downloaded.

d) Wordpress Upload - top

First you need to login to the administrative panel of your WordPress website.

Go to the Appearance menu section, select Themes, and then click the Add New Theme button. Select the Upload link and you will see the following:

Screen

Click the Browse button. A window will show up that will allow you to locate the PinThis-vX.X-installable.zip archive that contains your theme.

Screen

Select the file and click Open. The File upload window will close. Click the Install now button next to Browse.

Screen

This will automatically install your PinThis theme, and you will see a page like this one:

Screen

Select the Activate option to make the PinThis theme the default one for your website. You will be taken to the full list of themes, with the PinThis one at the top.

Once done with the settings you can go to the main page and voilla:

Screen

e) Importing Dummy Content - top

We recommend you install the dummy content which will guide you on creating posts and pages compatible to the theme.

Below explanation is an step by step explanation on how to import our demo website content, please read carefully.

  1. Login into your WordPress Admin section.
  2. Go to Tools » Import in the blog’s admin panels.
  3. Click on the WordPress and follow the instructions if Import plugin isn’t installed yet (3.0+).
  4. Browse the included dummy-content.xml (XML file) from main Zip Package » Dummy Content and Upload the XML file.
  5. You will first be asked to map the authors in this export file to users on the blog. For each author, you may choose to map to an existing user on the blog or to create a new user.
  6. Click the “Download and import file attachments” checkbox to download all image attachments.
  7. WordPress will then import each of the posts, page, custom post types, comments, and categories contained in this file into your blog.
  8. Notice that the Sidebar Widgets are not replicated on your imported dummy content. You should be the one to create the widgets. To create widgets, navigate to the left sidebar menu of the WordPress’ Dashboard, then Appearance » Widgets. Just drag and drop the widgets on to the widgets area on the right side of the widgets page.
  9. After this, you should also update the Menus by going to Appearance » Menus.
  10. Done! You should now have the dummy/demo content similar from the Live Preview of the theme.

f) Theme Support - top

If you have a problem with the theme or found a bug please let us know by sending us an email and we will help sort out your problem.

We tested the theme with major browsers and different devices. Unfortunately it is impossible to run every test scenario.

Note: We are happy to help with setup and any bugs you may stumble upon.


2. Theme Options - PB Panel - top


To access the theme options panel simply...

If you navigate to PB Panel you will find all of the customization options for this theme. Most of these options are self explanitory, but we have provided descriptions for each option.

a) Main - top

Screen

b) Branding - top

Screen

c) Slider - top

Screen

Navigate to PB Panel » Slider tab. Check Front Page or All Pages to display the slider. Under Slider Options you can set navigation arrows, autoplay, dot navigation etc as you want. All settings are explained very well.

How to add slides?

PB Slides allow you to add slides with custom image, title, description and link so you can use it as a main slider on the homepage or on all pages.

Screen

  1. Navigate to PB Slides » New Slide.
  2. Add a label title for the slide. This is not the title which will be used in the slide, this is just label.
  3. Go to Slide Data. Enter your Slide Title, Description and Link. This information is not required. If you don't want - do not enter.
  4. If you want to display Slide Image from your existing images in the media library or upload a new one, go to Featured Image section and set / edit desired image. Placing the slide image is not required.
  5. Once its all done, make sure you click the Publish / Update button.

d) SEO - top

Screen

e) Social Networks - top

Screen

Screen

f) Reset - top

Screen

Note: If there is anything that you would like to be able to customize just let us know and we'll add that feature.


3. Using the Menu System - top


You can create a menu from Appearance » Menus in Wordpress admin.

a) Creating Menus & Adding to Theme Locations - top

The first step of creating our menu is to open the WP Menu Editor. To start click create a new menu link. You just need to enter a Menu Name and click Create Menu.

Screen

Once you've created the menu, the your next step is to select the Menu as the Main Navigation under the Theme Locations. Just press on Header Menu checkbox. After you've selected your Theme Location, click Save. This is what links your newly created menu to the theme.

Screen

The final step is adding pages and links to your newly created Menu. You can just select a page via the checkbox and click Add to Menu.

Then the page will be added in the Menu list on the right. You can drag menu items around to order them. Or customize/delete the menu items by clicking on the down arrow on the right. Once you are done customizing your menu, click Save Menu.

Screen

Created Menu will be placed here:

Screen

You can make multiple level's of sub-menus. All you need to do is drag the menu item that you want inside the sub-menu under-neath the parent menu item. There will be an option to indent the item, so that the sub-menu item looks like it is pushed inside of the parent menu item.

Screen


4. Custom Post Formats - top


This theme offers a wide variety of options to aid you in creating nice-looking pages with any content.

Applying a specific format to a post enables additional editing options that will grant your page both a unique look and great user experience.

Screen

a) Standard - top

This post format is displayed with a featured image (if it's set), post title, post excerpt and pinbox metadata.

Screen

b) Aside - top

This is a simple post with a post excerpt, commonly used to make notes.

Screen

c) Image - top

This format is very similar to a standard post format. The main difference is that post title and post excerpt are not displayed by default.

Screen

d) Quote - top

A small post that displays a styled quotation & author information with a blockquote used as an icon. If featured image it's set will be display as a background.

Screen

e) Status - top

This post format is a short status update, commonly used to post tweets. Displayed with a post excerpt and pinbox metadata.

Screen

f) Audio - top

A post that displays an audio file. You can either upload your own file or add a link from an external source. If a featured image is set, it will be displayed in the header area of pinbox.

Screen

Screen

g) Video - top

A post that contains a video in the header part of the pinbox. You can either provide a URL to Youtube/Vimeo file or upload your own video.

Along with that you can apply a custom cover image (if featured image is set) to the video that will be shown on a blog listing page.

For better visual result you can choose video aspect ratio - 16:9 or 4:3.

Screen

Screen


5. Custom Widgets - top


PinThis have the default right Sidebar widget area for blog and general inner pages. You can drag and drop any widget in the Sidebar area. Your new Theme comes with one custom widget which can be found in your Wordpress Admin Area under Appearance » Widgets.

Drop the widgets to the sidebar to add it and then customize it to your liking. There are detailed instructions of widget when there's need for it.

Screen

Our custom Widget is Thumbnailer - Allows you to display posts with thumbnails. You can set number of posts to show. Default is 9.

Screen


6. Extras - top


a) Magnific Popup - top

To make an image or gallery images open up in a popup (ex. Lightbox). Default in post/page - ON, with all JPG, PNG, GIF and BMP files. If you want to use it in the gallery - just select Link To Media File from dropdown in Gallery Settings:

Screen

And the result:

Screen

b) Add Link to External Website - top

Allows you to make a link to a URL of your choosing in a post. Just go to Add New Post or Edit Post and fill in Add Link To External Website box.

Screen

And that's it! Your link will appear in desired post page:

Screen


7. Google Adsense - top


PinThis have 4 Google Adsense banner positions:

  1. Banner space between posts on the front page
  2. Banner position 1 - over the content of the post
  3. Banner position 2 - between post title and post content
  4. Google Adsense widget in the Sidebar

Screen

Screen

How to add a banner between posts on the front page?

Go to your WP administration panel » Posts » Add New and select Standard format of the post. In this case below the post will appear the option to add a google adsense banner code. Remember that this option only works with standard format of the post!

Screen

Paste your Google Adsense banner code in the field. Your banner will appear between posts on the front page. Remember that if you fill out this field, the post title and content will not be displayed.

How to add banners on position 1 and 2?

Go to PB Panel » Google Adsense.

Screen

Paste your Google Adsense banner code into the fields and press Save Settings.

How to add a banner in the sidebar widget?

Go to Appearance » Widgets. Drag Google Adsense Widget to Sidebar.

Screen

Paste your Google Adsense banner code into the field and press Save. That's all!


8. Translating the theme - top


a) Tools - top

The only tool you need for translating a WordPress theme is Poedit. Follow the instructions on its website http://www.poedit.net to install the tool. It’s very simple. Once you have Poedit, you’ll be ready to translate.

b) How to translate the theme - top

To translate the theme, you need to find the file named pinthis.pot located in the languages directory inside the theme folder. Open it. From this point, you must go through every line of text and translate it to your language. You must first click the text string you want to translate. Then, you type it in your language at the bottom of the screen.

Screen

c) Saving the translation - top

Once you’ve translated the theme, you’ll want to save it two times. Once as a .po file and once as as .mo file. You must save this according to your language code. A list of language codes can be found here: http://codex.wordpress.org/WordPress_in_Your_Language.

For example, French is fr_FR, so you need to save the translation as fr_FR.po first. Then, you need to save it as fr_FR.mo

d) How to use the translation - top

To use a translation, you first need to add the .mo and .po files to languages directory of the theme folder. Then, you’ll need to make sure your wp-config.php file matches your language files. For example, if using a French translation, you’ll need to add the fr_FR.po and fr_FR.mo files to languages folder. Then, you’ll want to set your language in wp-config.php, like this:

define ('WPLANG', 'fr_FR');

Once you save that file, the theme will be in your language.


9. How to Install a Child Theme - top


Installing a Child Theme is almost the same as installing any other WordPress theme. The only difference is that you need both the parent theme, and the child theme uploaded to your WordPress theme directory. For more information, please click here.

Once you have uploaded both the parent and the child theme, now you can go ahead and activate the PinThis Child Theme. You can do so by going to Appearance » Themes and activating the Child theme which is PinThis Child in this case.


10. Updating the theme - top


There are two ways to update your theme to the latest version:

  1. Wordpress upload method
  2. FTP method

Wordpress Method

FTP method


11. Credits - top


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 or contact me at pixelbeautify.com. Please rate this theme!

PixelBeautify

Go To Table of Contents