# Sahifa WordPress Theme

## By TieLabs

###### Last Updated : April 21, 2013

Thank you for purchasing my theme . Please read this document and explore the item comments and FAQ items for further information and help.

For questions on basic WordPress installation/usage, HTML, JavaScript or CSS editing - please try the ThemeForest forums, W3Schools, the Wordpress Codex or Google as theme errors/issues get top priority.

#### Don't Forget If You Like It, Rate It !

### Installing sahifa Theme

#### Uploading sahifa via FTP to Wordpress

- Download the zipped theme pack to your local computer from themeforest and extract the ZIP file contents to a folder on your local computer.
- In the extracted folder you will find 'sahifa.zip' Extract this file .
- Using an FTP client to access your host web server
- Upload the Theme files in the extracted folder called 'sahifa' to wp-content/themes directoryprovided by WordPress.
- Visit Administration > Appearance > Themes, under the Manage Themes tab, under the Available Themes, if necessary navigate to the page displaying that Theme, then click the Activate link to make the Theme, the Current Theme.

#### Installing sahifa from the WordPress Dashboard

- Download the zipped theme pack to your local computer from themeforest and extract the ZIP file contents to a folder on your local computer.
- Log into your WordPress admin panel and click on the “Appearance” tab.
- Now click on the "Add New Themes" tab.
- Click on the "Upload" button, "Browse" for file called sahifa.zip In the extracted folder select "Open".
- Click the "Install Now" button.
- Activate the theme from this page, OR "Return to Themes Page" and activate from there

### Installing Sample Content

To install the Sample Content

- Go Dashboard > Tools > Import > WordPress
- Install the plugin.
- Use it to upload the sample content XML file .

Check this video

### Language Translations

All of our Themes are able to be translated into any language. The process of translating the theme is a user responsibility.
The following instructions are given as guidance.

1. Open wp-config.php and replace this:

       define ('WPLANG', '');

   with this (subsitute the language string (bg_BG) with your own!):

       define ('WPLANG', 'bg_BG');

2. Download and install POEDIT
3. Connect to your site -> open your theme/languages directory
4. Download the default.po file and open it with POEDIT.
5. Translate file and save it as bg_BG (the file name must match with the string you inserted into wp-config.php)
6. Two files will be generated after save. bg_BG.po and bg_BG.mo
7. Upload the .mo and .po files into wp-content/themes/your-theme/languages folder

Your WordPress installation should be in the language you intend on using the site.

### How to activate the RTL Version

You just need to install the theme on RTL wordpress blog and it will adjust automatically .. check this page for more informations .

### Building Menus

To create a custom navigation menu:

- Go to Appearance > Menu
- Click on the plus (+) sign to create a new menu (eg. Main Menu).
- Add the menu items from the left panels (Custom Links, Pages, or Categories)
- To create dropdown menu, drag the menu item toward the right (the item(s) will be indented)
- When you are done adding the menu items, click "Save Menu"
- Then on the top right panel where it says "Theme Locations", select the menu from the dropdown to assign it to the navigation location and click "Save"

NOTE: Refer to Official Wordpress Menu Guide

### Add House Icon To main Navigation

- Go to Appearance > Menu
- In the Custom Links Block add your full blog url in the URL input field .. don't forget http://
- Add any text in the Label input field .. for example add 'Home'
- Click on 'Add To Menu' Button
- Click "Save Menu"

#### How to remove the house icon ?

add this code to custom css area in Tiepanel > Styling

    #main-nav ul li.menu-item-home a , #main-nav ul li.menu-item-home.current-menu-item a{
    	background-image: none !important;
    	text-indent: 0;
    }

### Setting Up Logo

- Login to Wordpress Admin
- Click sahifa Theme Options
- Click the Header Settings Tab .
- Click upload .
- Select your logo image to upload.
- Once uploaded click "Use this image" .
- Make sure you’ve selected "Full image" for the image size.

### How to use Custom Sliders Feature ?

Custom Sliders allow you to add slides with custom image , title , caption and link .. so you can use it as a min slider on the homepage or on a single post .

- Login to Wordpress Admin
- Go to Custom Sliders --> Add New
- Add a title for the slider .
- use Add New Slide button to add a new slide .
- Choose the slide image from your existing images in the media library or upload a new one and click Use this image button.
- Enter your slide title , link and caption .
- use Add New Slide button to add a new slides .. when you finished click Publish / Update button .

Check Setting Up The Slider section for instructions to set acustom slider as main site slider .

### Setting Up The Slider

To enable the slider:

- Login to Wordpress Admin
- Click sahifa Theme Options
- Click the Slider Settings Tab .
- Check "Enable" under the Slider Settings
- Choose Slider Type Flexi Slider or Elastic Slideshow .
- You may display either WordPress Posts or custom upload images in the slider:
- Set animation , slider speed etc as you want .
- Choose the Query Post to get Wordpress posts.
  - To display Posts from Category, set Query type as Category then select a category in the dropdown menu
  - To display Posts by tag, set Query type as Tag then Enter a tag name, or names seprated by comma in the tags input field .
  - To display Selective Posts , set Query type as Selective Posts then Enter a post ID, or IDs seprated by comma in the Selctive Posts IDs input field .
  - To display Selective Pages , set Query type as Selective Pages then Enter a page ID, or IDs seprated by comma in the Selctive pages IDs input field .
  - Or set Query type as "Custom Slider" and choose the slider from the dropdown menu list .

### Breaking News Module

To enable the Breaking News Module:

- Login to Wordpress Admin
- Click Sahifa Theme Options
- Click the Header Settings Tab .
- Check "Enable" under the Breaking News Settings
- Enter Breaking News Title or leave it blank to use default one.
- Choose the category and number of posts to show .
- Set animation , slider speed etc as you want .

### Homepage Builder

To Customize Your HomePage:

- Login to Wordpress Admin
- From WordPress Settings Menu > Reading .. Make sure that Front page displays option is set to Your latest posts
- Click sahifa Theme Options
- Click the Homepage Tab .
- Set Home page displays as 'News Boxes - use Home Builder' .
- Begin to build yor home page by click on items like 'News Box' , 'Scrolling Box', 'Ads' .. etc boxes will appear in area below you can sort it and change setting .

### Sidebar Manger

The Sidebar Manager enables you to create a unique sidebar for specific pages of your site.

To add custom sidebars .

- Login to Wordpress Admin
- Click sahifa Theme Options
- Click the Sidebars Tab .
- In 'Add Sidebar' Block .. add your sidebar name and click Add button.
- Now you can assign your Custom sidebar to Home , posts , pages and archives .

To assign your custom sidebar to single post/page :

- In post edit page , Select your custom sidebar from Sidebar Options As shown in below screenshot

### Overlay Patterns

To set pattern for the background.

- Go to sahifa > Styling tab .
- Set Background Type as pattern .
- Set the background color .
- Select any of the patterns for the background image.

### Setting Up a Background

- Login to Wordpress Admin
- Click sahifa Theme Options
- Click the Styling Tab .
- Set Background Type as Custom Background .
- Click upload .
- Select your Background image to upload.
- Once uploaded click "Use this image" .
- Make sure you’ve selected "Full image" for the image size.
- Set other options as you want .
- If you want to display the image as full background check 'Full Screen Background' .

### Featured images for the posts

The recommended size for the Featured images is 660px x 330px .

Theme cropped all uploaded images to fit its places in the theme .. if you have any problems with the size of old images which uploaded before install the theme you need to use Regenerate Thumbnails Plugin or AJAX Thumbnail Rebuild Plugin to regenerate thumbnails with suitable sizes .

#### How to set a featured image for a post :

### Adding a Review Post

You can add a review post from Review Post Options box in the post edit/add page .. check the video

### How to use Lightbox ?

#### Adding a Lightbox Content

1. Go to Posts --> Add New
2. On the "Visual" editor mode .. click on lighbox shortcode icon .
3. In the "Add Lighbox" window Add :
   - The Full Image or Youtube / Vimeo Video URL which that will appears in the lighbox .
   - The Title which will shown as a tooltip text when the mouse moves over the element .
   - In "Content" area add the Text will linked with the Lightbox .. or the html code if you want to use an image like :

         <img alt="" src=" IMAGE URL " />

4. Then click on "insert into post" button.

#### Adding a Lightbox Gallery

Important | WP 3.5.1 There are a bug in WordPress 3.5.1 so you need to go to text mode in the post editor and add link=”file” to the gallery short code to be like : [gallery ids="164,116" link="file"]

### Full Width Page/Post

In post edit page , Select 'full Width' image from Sidebar Options As shown in below screenshot.

### Using Page Templates

In most of our themes, we offer sever PAGE TEMPLATES. A Page Template is a template which comes with your theme. WordPress can be configured to use different Page Templates for different Pages. You can select which Template will be used when displaying a particular Page.

For Example : Authors , Timeline , Sitemap and Tags page templates

##### How To Use a Page Template

1. Go to Pages --> Add New
2. On the right-hand side, you will see the following panel titled Page Attributes with a drop-down under Template:

   NOTE: If you do NOT see this panel, look to the top right of your screen for the words - Screen Options. Click that and enable the checkbox next to Page Attributes.

3. Select the Page Template you desire.
4. Publish the Page. That's it! Now that page will display the pre-defined content within that page template.

### Footer Settings

To set the Footer Widget column layout, go to sahifa > Footer Settings tab and select layout from Footer Column layout .

To drop the widgets in the Footer Widgets, go to wp-admin > Appearance > Widgets.

To replace the default footer text, go to sahifa > Footer Settings tab and enter your text there .

### Shortcodes Gui

Shortcodes make it simple to insert elements like buttons, boxes, columns etc. without any knowledge how to code HTML. Shortcodes work in posts and pages .

### How to Paginate a Post ?

In order to paginate your blog post, in the Write panel in your WordPress admin, switch to the TEXT view (if you are using the Visual view) and then enter the following code to wherever you want to break the post up into a new page.

    <!--nextpage-->

Save the post , And you’re all done!

### How and Where to Include Google Analytics Tracking Code?

1. COPY the code given to you by Google Analytics
2. Go to WordPress --> Theme Panel page --> General Settings --> look towards the bottom for Footer Code box:
3. Paste your Google Analytics (or other) tracking code here. This code will automatically be inserted into the footer of your theme on every page.
4. Click Save Changes. That's it!

### How to chnage Author Avatar

The theme uses Gravatar to display users avatars . to craete or change your Gravatar :

If you have never setup a Gravatar account:

1. Register / login to Gravatar. Upon registering, use the SAME email address that is associated with your WordPress User Profile.
2. Upload your photo and associate it with that specific email address.

If you already registered at gravatar.com, follow these steps:

1. Click on "My Gravatars" .
2. click on "Add a New Email" .
3. Then, you'll need to click on "Add a New Image" .
4. Upload an image .
5. Then select the email address, and then select your image from bottom. Now it's associated with that email address. Click Save .
6. It will take about 5-10 minutes to propagate on the internet, and then will appear on site.

### How to Insert Ads

#### Add an image Advertisement

- Go to Theme Panel page > "Banners Settings" tab
- Enable the Ads area you wany via "ON/OFF" button.
- Click on "upload" and add your Ad image .
- Add your Ad link .
- Add Alternative Text For The image (optional) .
- Enable "Open The Link In a new Tab" option If you want to open the link in a new window / tab .

#### Add a Text , Adsense or Flash Advertisement

- Go to Theme Panel page > "Banners Settings" tab
- Enable the Ads area you wany via "ON/OFF" button.
- Add your Adsense code or custom html code in the "Adsense Code" input area .

###### Flash (SWF) Advertisement Code

A flash advertisement would need to be in the .swf (shockwave) format. To use it, just replace the data & value URL paths and width/height accordingly in the code example below:

    <object type="application/x-shockwave-flash data="http://www.URLPath.com/Path/To/file.swf" width="300" height="250">
    		<param name="movie" value="http://www.URLPath.com/Path/To/file.swf" />
    </object>

### Credits

Thanks so much to

- jQuery
- jQueryUI
- jQuery Easing plugin
- jQuery Cycle plugin
- jQuery InnerFade plugin
- jQuery tipsy plugin
- jQuery tweet! plugin
- jQuery Scroll to Top Control
- jQuery Tools Tabs
- jQuery COLOR PICKER plugin
- jQuery checkbox plugin
- Flexslider
- ELASTIC IMAGE SLIDESHOW
- Html5Shiv
- selectivizr
- Webfonts with Google fonts
- Timthumb
- jPlayer
- WP-PageNavi Plugin
- Socail icons by Yusuke Kamiyamane
- Subtle Patterns
- Documenter
- Premium Pixels
- Some patterns
- Photos used in the demo site from : UGArdener, law_keven, midlander1231, eldeeem, Alex Millà, Stuck in Customs, Eduardo Amorim, paul bica, bulbocode909, Per Jensen, Neal., photos.dan2010, Kalexanderson,