Pleasant WordPress Theme Documentation

Thank you for purchasing Pleasant WordPress Theme. This documentation consists of several parts and shows you the entire process of setting up and customizing a WordPress theme. If you have any questions that are beyond the scope of this help file, please refer to the Support section. Thanks so much!

WordPress is a free and open source blogging tool and a content management system (CMS) based on PHP and MySQL. It enables you to build Websites and powerful on-line applications and requires almost no technical skills or knowledge to manage. Many aspects, including its ease of use and extensibility, have made WordPress the most popular Web site software available.

Creating a website with WordPress is significantly much easier than coding it by yourself. if you are a beginner, even working with WordPress may be difficult to you. That's why, in this section we will provide some useful links and also will explain how to get oriented in the documentation and what pattern to follow when building your website with our theme. Please note that this documentation covers all the main settings for the theme, but it doesn't cover instructions about working with WordPress, as this is a very extensive topic. If you are new to WordPress, we would recommend to first get familiar with the WordPress system, so you can have at least basic knowledge about how it works and then proceed with setting the theme.

1. Theme Installation

a. Through WordPress Dashboard

Go to the menu Appearance > Themes and click on Add New button.
Click on Upload Theme button.
Click on Browse button and navigate to the unzipped theme package on your computer.
Look for a file called pleasant.zip Click on it to select, then click OK.
Click on Install Now button and wait until the installation is complete.
Click on Activate link to activate the theme on your WordPress site.
Go to Appearance >> Theme Options >> Restore Default.

Note: Some servers have limited folder access settings applied and wouldn't allow uploading the theme trough the admin - in these case you have to upload the theme via FTP.

b. Manual Installation using FTP client

If you know the FTP login details of the server where your site is hosted and you have a FTP client installed (such as FileZilla), you might consider using this way of uploading your theme.

Unzip the pleasant.zip file
Using an FTP client to access your host web server. Go to /wp-content/themes
Upload theme to /wp-content/themes/
Go to Appearance -> Themes and activate theme from Dashboard.

First you have to unzip the download file, find the zip file called pleasant.zip, unzip it and upload the folder to the main WordPress installation folder » wp-content » themes. Please note that if you prefer this way of installation, you have to make sure that the main files of the theme are contained just within one folder of the themes folder.

You can activate the theme after it is uploaded on the server. In order to activate this theme you have to go to the admin panel » Appearance » Themes. In this section you should see the theme with a title Pleasant. Just click on the Activate button and your theme should get activated.

2. Import Demo Content

After activating the theme, please import demo content using following

Download the Demo Content zip file
The demo content is inside a .zip file. You must extract this archive on your computer.
(Right click on pleasant-sample-data.zip to extract)
Go to Tools » Import
Install and run WordPress importer
Click on browse, select pleasant-sample-data.xml file and click on Upload file and import
You will 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.
You will then have the choice to import attachments, so click on the "Download and import file attachments" box.
Please be patient while WordPress imports all the content. Posts, Pages, Projects, and Menus are imported. You will need assign the menu a theme location & you'll need to configure widgets. This is a limitation of WordPress import system.

3. Homepage Setup

After activating the Pleasant theme, setup homepage using following

Go to Settings -> Reading -> Front page displays
Click on radio button of Your latest posts
Go to Appearance -> Theme Options and click on Restore Defaults in bottom side

4. The header

The header consists of two main elements:

Site Name / Logo
Menu

a. Changing the site name / logo

If you don't have your logo image then you can use site name and tagline. To change site name and tagline go to
Settings » General » Site Title

OR if you want to uplaod logo for your website go to Appearance » Theme Options » Basic Setting
You can also increase logo image height as per your requirement.

b. Setting the menu

First of all create pages from Pages >> Add new page
Go to Appearance >> Menu
Click on Create a new menu link
Give a name to your menu in Menu name and click save menu button
Once you have create menu. You need to add pages by selecting with checkboxes. After adding menu list you can arrange it by drag and drop.
Select menu theme locations Primary Menu from Menu Settings
Click Save Menu after adding required pages, categories in the menu

5. Homepage Slider

In order to add slides to homepage slider go to the Appearance » Theme Options » Homepage Slider
For each slide there are different options that you can apply.

You can change Slider Effects and Timing.
You can change Slider Animation speed, pause time
You can change Slider Hide/Show Direction Naviagtion of slider.
You can change Slider Hide/Show pager of slider.
You can change Slider Pause Slide on Hover.
Slider images should be of size 1420 × 590 pixels

If you don't want to use this default image slider, you can use any image slider WordPress plugin

Go to Appearance » Theme Options » Homepage Slider
Enter your slider shortcode which is provided by plugin without php tag

6. Homepage Section

The homepage contatins lots of section to create beautiful and professional website.

a. Welcome

This section is used to display welcome text in your website

To manage this welcome section go to Appearance » Theme Options » Sections » Welcome to Website Section

b. Services

This section is used to display various sevices in your website

To manage this services section go to
Appearance » Theme Options » Sections » Services box for frontpage section

Select page and upload services image

c. Advanced Theme features

This section is used to display advanced features in your website

To manage this section go to Appearance » Theme Options » Sections » Section 1

In order to change Font Awesome icons in this section:

Find 'fa fa-check-square-o' and replace 'check-square-o' with your icon name
Use icon only from Font Awesome
Icon name should be in lowercase letter

d. Theme Features

This section is used to display various features in your website

To manage this section go to Appearance » Theme Options » Sections » Section 2

d. Latest Blog Posts

This section is used to display recent blog posts in your website

First of all create new posts from Posts -> Add New
To manage this recent posts section go to Appearance » Theme Options » Sections » Section 3
Use this shortcode to display posts:
[latest-news showposts="4" comment="show" date="show" author="show"]

e. Our Skills

This section is used to display various skills with data counter in your website

To manage this section go to Appearance » Theme Options » Sections » Section 4

In order to change Font Awesome icons in this section:

Find 'fa fa-group' and replace 'group' with your icon name
Use icon only from Font Awesome
Icon name should be in lowercase letter

f. Our Team

This section is used to display team members in your website

First of all create new team member from Our Team -> Add New
To manage this team member section go to Appearance » Theme Options » Sections » Section 5
Use this shortcode to display team member: [our-team show="4"]

g. Clients Testimonials

This section is used to display clients testimonials in your website

First of all create new posts from Testimonials -> Add Testimonials
To manage this testimonials section go to Appearance » Theme Options » Sections » Section 6
Use this shortcode to display testimonials: [testimonials]

h. Photo Gallery

This section is used to display photo gallery

First of all add some photo from Photo Gallery -> Add New
To manage this photo gallery section go to Appearance » Theme Options » Sections » Section 7
Use this shortcode to display photo gallery: [photogallery filter="true" show="8"]
Set filter="false" to remove filter from gallery

i. Our Clients

This section is used to display clients list in your website

To manage this section go to Appearance » Theme Options » Sections » Section 8

7. Footer

The Footer section consists of five main elements:

About Us
Latest Posts
Contact Info
Footer Menu
Copyright text

To manage footer section go to the Appearance » Theme Options » Footer

Setting footer menu

Go to Appearance >> Menu
Click on Create a new menu link
Give a name to your menu in Menu name and click save menu button
Add pages by selecting with checkboxes.
Select menu theme locations Footer Menu from Menu Settings
Click Save Menu after adding required pages, categories in the menu

8. Page Templates & Sidebars

When you create a new page from the Pages » Add New section, the "Default Template" is assigned to the page by default. The default page template is a standard page template that can be with a sidebar or full-width layout and can contain custom content.

Default Template
- Used to setting up the content on any page with Right Sidebar
Left Sidebar
- Used to setting up the content on any page with Left Sidebar
Full Width
- Used to setting up the content on any page without Sidebar
No Sidebar
- Used to setting up the content in center on any page without Sidebar
Contact Us
- Used to setting up the contact page.

9. Widgets

The WordPress widgets are used to manage sidebars:

Can manage sidebar from widgets (exa. blog sidebar and main sidebar)
Footer section can manage from footer widgets 1,2.3,4

10. Shortcodes

To view all shortcodes go to Appearance » Theme Options » Short Codes:

Photo Gallery:
[photogallery filter="true" show="8"]
Testimonials:
[testimonials]
Testimonials Listing:
[testimonials-listing show="10"]
Contact Form:
[contactform to_email="test@example.com" title="Contact Form"]

11. Multilingual

This theme is ready for translation - it comes with a .po file that contains all the embedded into the theme strings.
It supports multiple languages. The qTranslate X WordPress plugin offers a way to maintain dynamic multilingual content on a WordPress site.

How to make your website translate ready?

Install qTranslate X WordPress plugin
Used following code for making text translate ready - [:en]English Text[:de]Deutsch Text[:]
Viewing in Dutch used website url : http://www.yourwebsiteurl.com/de/
Viewing in English used website url : http://www.yourwebsiteurl.com/en/

To translate Homepage sections Title, Content, Button texts, Read more texts

Go to Appearance » Theme Options » Basic Settings
Go to Appearance » Theme Options » Sections » Section 1 » Section Title / Content
and use below code for making text translate ready
[:en]English Text[:de]Deutsch Text[:]

12. Support

If you have any questions regarding our WordPress themes, you can contact us through our support forum or you can mail us at support@gracethemes.com. Our support team is always ready to help you with any problems of customization or compatibility you may encounter.

Pleasant Lite WordPress Theme Documentation

Thank you for using Pleasant Lite WordPress Theme. This documentation consists of several parts and shows you the entire process of setting up and customizing a free WordPress theme. If you have any questions that are beyond the scope of this help file, please refer to the Support section. Thanks so much!

1. Homepage Setup