FlatAds - Directory Portal WordPress Theme” Documentation by “Alex Gurghis” v1.0

“FlatAds - Directory Portal WordPress Theme”

Created: 17/12/2013
By: Alex Gurghis
Email: Alex Gurghis

Informations about Updates and New Themes are always announced on Twitter and Facebook. Twitter updates are usually more up to date, Facebook updates are more detailed and easier to follow :)

Hello! First of all I would like to thank you for purchasing my theme! :)

This file will teach you how to set up and use the “FlatAds” WordPress Theme.
This file is really extensive so you might think the theme is hard to use,
actually its not, you probably just might jump to the options page and explore everything yourself, this file is more of a reference work if you do not know what to do, or if you are not familiar to WordPress.

Have fun with your new theme! best regards
Alex Gurghis

Table of Contents

  1. Folder Structure
  2. Installation and setup (to get it like in our demo)
    1. Install theme
    2. Install plugins
    3. Import content
    4. Setup Menu
    5. Import ReduxFramework Settings
    6. Import LayerSlider content
    7. Setup FlatAds custom pages
    8. Setup Categories icon and colour
    9. Miscellaneous
  3. Setting up the Theme Options
    1. General
    2. Pages
    3. Paypal
  4. Ads
  5. Pricing Plans
  6. HTML Structure
  7. CSS Files and Structure
  8. JavaScript

Folder Structure of FlatAds - top

The Theme is built with WordPress best practices in mind, therefore it makes heavy use of the WordPress template engine. What exactly does that mean?

Whenever you see a php function call like this within your php files (get_header(), get_footer() or get_sidebar() ) the theme retrieves a reusable code snippet, most of the time a chunk of code that is used in many different files.

Apart from the php structure the theme uses a lot of modern CSS3 features, most notably the power of media queries to serve different layouts for different viewport sizes. If you use a modern browser (IE9 +, Chrome, Safari, Firefox) and resize your browser window you will realize that the theme adapts its size to the viewport.


Installation - top

2.1 Install theme - top

Step #1

You can either choose to upload the theme to your server via ftp (only upload the unzipped folder „FlatAds“ into the folder wp-content/themes/ ) or via WordPress upload function. to use the upload function of the WordPress admin panel make sure to ONLY upload the “FlatAds” folder and not the whole archive file that you received by themesnap.

Step #2

Go to “Themes” menu and upload your theme then hit “Activate” button.

2.2 Install plugins - top

After the theme activation you'll see an info box about installing some plugins:

Click on Begin Installation.

To get all the features you see on our demo, make sure you'll install all of them.

2.3 Import content - top

To import content go to Dashboard -> Tools -> Import. There select WordPress -> Install the plugin, activate it and run the importing. Inside the folder you downloaded from ThemeFores (All Files and Documentation) you'll have a folder "Demo Content" inside it are two folder and one xml file "demo-content.xml". On importing select it.

If you'll get the 500 Server Error or it wil say that some files already exist please try again till you'll have a message that all is imported and Have fun!

2.4 Setup Menu - top

After the importing demo content is done we have to setup the menu. Go to Dashboard -> Appearance -> Menus. Here Select Main Menu first from "Select a menu to edit:" ( see 2 on picture ). After that select the menu location ( see 3 on picture ) and save the menu. Do the same with the footer menu.

2.5 Import ReduxFramework Settings - top

Go to dashboard -> Options ( see 1 in picture) -> Import ( 2 in picture ) -> Import from file ( 3 in picture ). Go to "Demo content" folder, open "redux.json" file in "ReduxFramework Settings" with a text editor, copy everything inside it and paste in the import field. Click import ( 4 in picture ).

2.6 Import LayerSlider content - top

Go to dashboard -> LayerSlider WP -> On import block select the file located in Demo Conent/LayerSLider Demo Content folder and click "Import"

2.7 Setup FlatAds custom pages - top

Go to dashboard -> Options -> Pages. As you can see the links are already there but they are from our demo. They come there when we imported the ReduxFramework settings. We have to replace with ours. The pages are created we only have to copy the link in the right place.

Make sure you change the permalinks to something different than default. Otherwise it will not work. (Dashboard -> Settings -> Permalinks)

The pages are:

Login Page Url -> Login

Profile Page Url -> Profile

Register Page Url -> Register

Reset Password Page Url -> Reset Password

New Ad Page Url -> New Ad

Edit Ad Page Url -> Edit Ad

Featured Plans Page Url -> Pricing Plans

Make sure you delete the empty space after the link, otherwise it will not be saved.

2.8 Setup Categories icon and colour - top

To setup categories icons go to Posts -> Categories. Click on main category and there you'll have custom field for category icon code, a color picker and an upload image for icon. The icons are located in "psd/categories icons" folder. The icon code are from http://fontawesome.io/icons/

Vehicles: color - becd4a, icon code - <i class="fa fa-truck"></i>, image - car.png

Community: color - 33485d, icon code - <i class="fa fa-users"></i>, image - community.png

Dating: color - e74d3c, icon code - <i class="fa fa-heart-o"></i>, image - heart.png

Jobs: color - f1c40f, icon code - <i class="fa fa-suitcase"></i>, image - jobs.png

Pets: color - 7d3e2c, icon code - <i class="fa fa-github"></i>, image - pets.png

Real Estate: color - 9c59b6, icon code - <i class="fa fa-home"></i>, image - estate.png

Services: color - 6997c4, icon code - <i class="fa fa-wrench"></i>, image - services.png

Shopping: color - 7ba48a, icon code - <i class="fa fa-shopping-cart"></i>, image - shopping.png

2.9 Miscellaneous - top
Go to Dashboard -> Settings -> Reading and there make the homepage statik page and select "Home"
The listing won't appear on the map and also the price will be missing. This is because of the wordpress import plugin. Edit from front end a few listing by adding them an address from the map and a price.
Change the widget you want to have as right now on footer you'll have the default wordpress widget
That's it. Now the theme should look like our demo. Enjoy and dont't forget to rate it ( On your download page on ThemeForest ). Thank you!

Setting up the Theme Options - top

If you want to change the general Options of the Theme open the “FlatAds” Theme Options Panel (located in your admin sidebar) and click it, you will notice several tabs with options, which we will discuss now one by one.

General - top

Here you will add the logo, favicon and google analitycs id, google map styles.

Pages - top

Please set-up the custom pages to have a functional directory theme.

There are 8 (eight) pages that you have to create. Go to dashboard (or from top admin bar) click on Add New Page. Give it a name and select the right template. Save it and copy the permalink into the rigth option url field.

Fonts - top

Here you can change the font. Ther are available 650+ Google fonts.

Colors - top

Here you can change the colors.

Top Social Links - top

Here you can add the social links.

Contact Page - top

Here you can asetup the contact page.

PayPal - top

Here you can setup the paypal. To get the paypal api credentials please follow the link: https://developer.paypal.com/webapps/developer/docs/classic/api/apiCredentials/

Ads - top

You can add ads from front end and if you are the admin you can add theme from back end as standard posts. There are two type of ads: regular and featured. For featured ads the user will need to buy a price plan. The spots for featured ads are above the regular on homepage, category page, archive page, search page and on sidebar. The featured ads will become regular when the period of time from price plan will end. The latest ad will be shown first (in both categories: featured and regular). The user can convert a regular ad into a featured one by simply editing it and selecting a price plan that he has bought.

Pricing Plan - top

You can have an unlimited number of pricing plans. To add a new one please go to dashboard -> Pricing Plans -> Add New Price Plan. Please fill the name some description, the price (without the currency sign, it will be added from paypal settings - see above.) the ads number and the ads active time. Publish it.

HTML Structure - top

The Theme uses valid HTML and comes with predefined classes for common elements needed in web design.
All templates share basic elements like header, footer, main, and entry so be carefull when editing those or adding/changing the CSS for those ids and classes :)

CSS Files and Structure - top

The CSS for the theme is split into various files: one that holds the basic markup for layout which is called style.css.

JavaScript - top

The theme uses advanced jQuery functions. You do not need to know how to use jQuery to activate them, almost everything is controlled by WordPress. All the function calls as well as as the custom created jQuery plugins are located in the custom.js file.

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.

Alex Gurghis

Go To Table of Contents