Fapowy Documentation

Installation

First of all install WordPress. If you don't know how, the Codex has a great page about it. Make sure you're using 3.0 or newer.

There's two ways to install the theme. You can either choose to upload the theme to your server via FTP (Upload the folder fapowy from the www folder into wp-content/themes/) or to use WordPress' theme upload function. To use the upload function upload the file fapowy.zip from the www folder and then upload it through the WordPress admin as shown on the picture below.

When go to Appearance > Themes and activate the Fapowy theme. You're now using Fapowy as your active theme :)

Theme Options Page

After activating the theme you'll a new page under Appearance called "Fapowy". That's the theme options page.
Depending on what theme you've used before, you might also see 3 new pages called "Menus", "Background" and "Header". I'll go through them later in this documentation.

On the theme options page you'll see 4 tabs: Theme, Post, Slider and Other.

Tabs

The Theme Tab

Color scheme: Select the color scheme for the theme. It comes per default with red.css, green.css, blue.css and dark.css. Learn how to create your own

Exclude categories: If you have one or more categories that you don't want to display in the loop. Hold down ctrl/command to select multiple.

Hide description: You can hide your blogs description by checking this box.

Intro text: This text will be displayed after the slider (if there's one), but before the posts. It's useful for intro text. You can use HTML and shortcodes in the box.

The Post Tab & How to Use Images in Posts

Under the "Post" tab, do you find some post thumbnail settings.

You can choose width and height. The default values are 630px width, 260px height.

Tip: Use the Regenerate Thumbnails plugin if you want your old uploads to be the new sizes

Images in Posts

alignleft Apply the alignleft class to the image to align it to the left
alignright Apply the alignright class to the image to align it to the right
aligncenter Apply the aligncenter class to the image to center it

Tip: If you add class="colorbox" to the link, the full size image will open in lightbox

Post Thumbnail in Posts

Post Thumbnail

The Slider tab

Under the "Slider" tab do you have the option to enable/disable the slider, choose the order and how many slides there should be shown a time. I recommend at least 3 slides.

How to Add a New Slide

You can add a new slide by going to Slider > Add Slide in the dashboard sidebar.

Add Slide

Here's a video on how to do it

The Other Tab

Alternative RSS: If you have an alternative RSS feed address such as a Feedburner, enter it here. You can redirect all the other feeds (such as comment, tag and search feed) to it by checking the box right under.

Favicon: If your site has a favicon enter the url here or leave it to the default.

Footer text: The text for your footer. You can use HTML and/or shortcodes. Here's a shortcode list.
Here an example of a footer text:

<p class="alignleft">Copyright © [year] [site-link]</p>
<p class="alignright">Powered by [wp-link] and using [theme-link] as theme</p>

Google Analytics: Enter your Google Analytics tracking code here (will not be shown if you're using Google Analytics for WordPress)

To create a menu, go to Appearance > Menus, enter the name, and create it. When under "Theme Locations", select your newly created menu as Primary Menu. You can now add pages, categories, custom links and so on to your menu.

Upload a New Logo

To upload a new logo or change it to normal text, go to Appearance > Header. You can upload a new logo, choose the default or use normal text.

Change the background

To change the background, go to Appearance > Background. You can upload a new image or use a color. You might have to change some colors in style.css if it looks ugly.

Shortcodes

You can see the shortcodes right here and here or in inc/theme/shortcodes.php

Widgets

The theme has four widget areas: The Sidebar, Single Post, 404 error page and the footer.

I've included 3 widgets especially for the Single Post widget area. These are Fap: Author box, Fap: Post meta and Fap: Social links. You can easily add more.

Plugins

This section is about plugins. I've build-in support for some plugins so you don't have to touch the theme files if you use them. You don't have to use them, but they can add some extra nice functions to the theme. You can download all the plugins from the WP-Admin Dashboard - Just go to Plugins > Add New and search after them.

Yoast Breadcrumb or Breadcrumb Trail: Using one of these plugins will add breadcrumbs to your site - Download Yoast Breadcrumb, Download Breadcrumb Trail
WP-PageNavi: This plugin will replace the normal WordPress paging navigation - Download the plugin
Cleaner Gallery: If you use the build-in WordPress gallery is this plugin a great idea. It adds valid HTML, allow you to open your images in Colorbox and much more! - Download the plugin

Create Your Own Color Scheme

It's easy to modify or create your own color scheme. All schemes can be found in the styles folder. There's a .css file and a image folder to each scheme. The easiest way to create a new is to copy one of the existing (I prefer red.css) and change the colors and images in that.

Let's say we want a pink color scheme. Copy the red.css and the red folder, so you now have two of each. Now rename the copied to "pink" (note: you have to change the image locations in pink.css from the red folder to the pink folder)

Change the things in it you want. You should now have a pink color scheme to choose in the Theme Options :)

CSS Files and Structure

The main stylesheet is style.css located in the main folder.

In the css folder do you find a IE stylesheet.

As said in the main stylesheet style.css. The file is separated into sections using:

/* Reset */
some browser default reset

/* HTML elements */
some code

/* Header */
some code

/* Menu */
some code

/* Content */
some code

/* Slider */
some code

/* Main */
some code

/* Post */
some code

/* Sidebar and widgets */
some code

/* Footer */
some code

/* Comments */
some code

/* Forms */
some code

/* Images */
some code

/* Misc */
some code

/* Colorbox */
some code

etc, etc.

JavaScript

This theme imports 3-4 Javascript files.

jQuery
js/jquery.roundabout-1.1.min | The slider (if enabled)
js/jquery.colorbox.min | Colorbox (jQuery Lightbox)
js/script.js

jQuery is a Javascript library that greatly reduces the amount of code that you must write.
The script.js do some jQuery stuff. Calls the slider, colorbox, some CSS stuff and other things.
Roundabout is the slider script
Colorbox is for the lightbox effect on images

PSD Files

I've included two psds with this theme:

The main layout
The logo

If you'd like to change the logo, open "logo.psd", make the necessary adjustments, and then save the file. Click here to see how to change it

Translate the Theme

The theme is translatable - So you don't have to edit any theme files to translate it into your language! To be able to translate, do you need a .po file editor. I recommend you Poedit (both for PC & Mac)

After you've downloaded the program, open it and go to Files > New Catalog from POT file. Go to the theme folder and find the file languages/fapowy.pot. After you've opened it, save it as language_COUNTRY

Here's some language codes:

Danish: da_DK
French: fr_FR
Dutch: nl_NL
German: de_DE
Italian: it_IT
Spanish: es_ES
More language codes

If it isn't working, make sure that you have defined a language in wp-config.php - Look for define ('WPLANG', '');. Enter your language code, ex define ('WPLANG', 'fr_FR');.

If you've translated this theme to your language, you're more than welcome to send your translation to me though the contactform on my Themeforest page or send me an email kontakt@jayj.dk.

Sources, Credits, and License

I've used the following scripts and icons

Roundabout by Fred LeBlanc
Colorbox by Jack Moore
EqualHeights by Scott Jehl, Todd Parker, Maggie Costello Wachs
Developpers Icons by Sekkyumu
WooFunction Web Icon Set by WooThemes
WooCons #1 by WooThemes
WeFunction icons by WeFunction
FamFamFam icons by FamFamFam
Some of the shortcodes aren't by myself alone. Credits is in inc/theme/shortcodes.php
Much of the slider write panel code by Spencer Finnell

Once again, thank you so much for downloading 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.

License

Fapowy is licensed under the GNU General Public License, version 2 (GPL)