# DateBook Responsive Dating WordPress Theme

#### WordPress Theme Documentation

View Changelog View Demo 1 (Native theme pages) View Demo 2 (Pages created with Brizy Page Builder)

## Howdy!

Thank you for buying DateBook! We have spent a very long time developing this theme. We’ve done our very best to make it as extensive and feature-rich as possible, while also keeping it incredibly easy and slick to use. We’ve also worked hard to improve the ease of customisation.

### Documentation Improvements

We would happily welcome feedback from you on how, if anywhere, you would like this documentation improved. If you would find anything a little bit easier and more helpful if we went into more detail, or explained something a little better – we’d be happy to hear it. We want Cutting Edge to be the best theme on the market! If you have any comments, please mail us via the form on https://themeforest.net/user/pagick.

## WordPress Installation

This theme requires a working version of WordPress to already be installed on your server. If you need to install WordPress then please visit: https://wordpress.org/download/. If you need any help with the installation, please refer to the guide below:

Installing WordPress

### Step By Step

Here is a brief step by step on how to install WordPress:

1. Download and unzip the WordPress package if you haven’t already.
2. Create a database for WordPress on your web server, as well as a MySQL user who has all privileges for accessing and modifying it.
3. Upload the WordPress files in the desired location on your web server:
   - If you want to integrate WordPress into the root of your domain (e.g. http://example.com/), move or upload all contents of the unzipped WordPress directory (but excluding the directory itself) into the root directory of your web server.
   - If you want to have your WordPress installation in its own subdirectory on your web site (e.g. http://example.com/blog/), create the blog directory on your server and upload WordPress to the directory via FTP.

   Note: If your FTP client has an option to convert file names to lower case, make sure it’s disabled.

4. Run the WordPress installation script by accessing wp-admin/install.php in a web browser.
   - If you installed WordPress in the root directory, you should visit: http://example.com/wp-admin/install.php
   - If you installed WordPress in its own subdirectory called blog, for example, you should visit: http://example.com/blog/wp-admin/install.php

## Installing a Theme

### Download latest version

You can download the latest version of your theme files from Themeforest.

1. Log into your Themeforest account and go find the Pagick Theme purchase on your downloads tab.
2. Click the “download” button next to it and choose to download the “Installable WordPress Theme” which is just the WordPress file, or choose the “Main Files” which is the entire package.

### Uploading through the WordPress Dashboard

The easiest way to install your theme is to upload via the WP Dashboard:

1. Go to Appearance » Themes » Add New » Upload
2. Click [Browse] and select the zip file
3. Click [Install Now]

### Uploading via FTP

If you have FTP login details, you can upload the un-zipped file to the correct folder on your site.

1. Extract the downloaded folder on your computer.
2. Log into your hosting space via a FTP software like FileZilla.
3. Go to themes folder to the wp-content/themes/ folder.
4. Upload the extracted datebook folder to this location.
5. To Activate the theme go to your site WordPress Dashboard then to: Appearance » Themes.

## Installing a Plugin

### Required Plugin Installation

Right after the theme was activated, a notification at the top of the screen will suggest to continue with the installation of the plugins that come packed into the theme. You can also access this page by going to DateBook » Install Plugins.

1. Click [Begin installing plugins] and select the plugins you need to install from the list. We recommend to install all of them. So you can create every element and parts of the theme.
2. Activate the Plugins you just installed.

## Theme Installer

We have created Theme Installer specially so that you do not have to create Pages, Countries, Menus, Widgets, and Database Tables (MySQL) manually.

### Installation Notification (Fast way)

You may start installation by clicking on “Start Installation!” button that is on the notification panel. The installation proccess starts immediately.

### Setting Up

All you have to do is go to DateBook » Theme Installer and click on the [1. Install] button.

1. Go to DateBook » Theme Installer.
2. Click the [1. Install] button.
3. Once the button is clicked, it can take some time to import the data. Please, be patient and wait for it all to load. Once it loads, you will see a “All the necessary data have been successfully installed!” message.

#### Manual Installation Notice

If you do not want to create Pages automatically then you have to go to Pages and create Pages as usual.

## Countries and Cities

Important! In order for Countries and cities to load in the Search and Registration forms, you must select the home page here: Settings » Reading, select “A static page” and choose your “Homepage” as the Homepage

You can use our Theme Installer to import Countries, Regions and Cities.

Of course, any time you can add countries manually. How to add countries and cities:

1. Go to Profiles » Countries.
2. Click the [2. Install] button.
3. You will be redirected to Countries Installer page. Click the [Start] button.
4. Countries installation proccess begins. Wait untill green line reaches 100 % and all 244 countries are installed.

You can add, edit and delete countries and cities:

1. Click the Edit button next to country name.
2. The Edit form will open. You can edit any field.

#### Countries and Cities names are translatable

Pay attention to field Title (English). This field is translatable. The more language files your have in your language folder (wp-content/plugins/datebook/languages/) the more new fields will be added in this form.

For example: you translate the theme into Spanish. It means that you add language files datebook-es_ES.mo and datebook-es_ES.po to the folder wp-content/plugins/datebook/languages/

After that the theme detects those files and a new field Title (Spanish) appears in the Edit form.

Now you can enter name of country or city in Spanish.

Once you receive the success message, please Navigate to DateBook » Theme Installer.

## Demo Content Import (Optional)

You can import the Demo Content such as Profiles, Tours, Classifieds, Posts by using our Theme Installer. Our installer will install all required content automatically. Demo Content is for the demostration purpose only. To import our demo content, please see the steps below.

1. Navigate to Appearance » Theme Installer.
2. Click the [3. Install] button.
3. Once the button is clicked, it can take some time to import everything. Please be patient and wait for it all to load. Once it loads, you will see a “All the Demo Content have successfully been created!” message. Once you receive the success message, your web site is ready to go and you can go frontend to see it.

## Theme Options

DateBook featured an amazingly easy and powerful Theme Options where you can find all the theme settings. The theme options can be used to customise the theme to suit your needs, including Front page, Search page and much more. You should take the time to go through all of these options to ensure that you are getting the most out of the theme.

All, theme options are self-explanatory or are described well directly in admin panel. The theme options is divided into the categories to make them easy to find.

### Setting Up

1. All the theme options can be set in theme admin panel. To display it navigate to Appearance » Theme Options in WordPress admin menu.
2. After admin panel is displayed, choose the options category from top pane. Panel contains many different settings for the theme. Please, read the option description for more information on each option and how to set it up.
3. After you set all the required options, don’t forget to save your changes by clicking the [Save options] button.

#### First Installation Notice

When you go to the Theme Options for the first time you can save default settings. In this case you do not need to change anything. Just click on the [Save options] button and the website will be ready to go.

## Menus

### Overview

WordPress comes with a wonderful and easy to use menus functionality, letting you quickly create a custom menu and place it in your theme’s supported menu areas or even in a widgetized area with the menus widget. You can customize your menu in all our themes by going to Appearance » Menus.

The WordPress menus functionality is well documented on the WordPress codex.

### Adding Links

Here’s a general overview of a menu we’ve created for our theme. We’re working on our main (primary menu), if you haven’t created a menu yet you will be prompted to create one before being able to add pages, etc… to your site’s navigation. You can create as many menus as you’d like as well.

In the left hand column is a list of all your pages, as well as custom post types, categories, tags, etc… You can then select certain pages, or categories and add them to the menu you are creating.

### Managing Locations

It’s up to the theme developer to decide how many menu locations a theme should have. Again, in our example we have several menu locations. Your theme may not have the same location names or number of locations. Regardless, there are two easy ways to assign a menu you just created to a menu location.

While creating or editing your menu, you can assign it’s location at the bottom of the menu. There is also a Manage Locations tab where you can assign all locations a menu from one screen. Helpful if your theme has many menu locations.

## Translation

DateBook is 100% translation and multi-lingual ready, and we recommend that you use the very popular plugins "Loco Translate" or "WPML".

Loco Translate plugin allows to change an original text in the theme without touching any core files.

To translate the static strings, if you aren’t using Loco Translate or WPML then I recommend downloading PO Edit, from https://poedit.net. Once you have installed please follow the steps below:

1. Open the /wp-content/themes/datebook/languages/ folder.
2. Then you will need to open the .pot file in PO Edit. Once opened, you will see all strings that needs to be translated. Type the translation of a string into the “Translation” column. Do not delete or edit “Original string” part.
3. When you finish translating, save the file as de_DE.po. Duplicate the en_US.po file, then rename it to your desired language code. For example; for German you need to re-name it as de_DE.po, for Spanish es_ES.po, for Turkish tr_TR.po, etc. You can find all the codes from this link https://make.wordpress.org/polyglots/teams/. This will create an .mo file in the same directory.
4. Upload the new files into the languages folder of the theme /wp-content/themes/themedir/languages/ and then follow this guide: https://wordpress.org/support/article/installing-wordpress-in-your-language/

### Send Us Your Translation!

If you translate Datebook into a language that isn’t included, then we’d really appreciate it if you could send it to us. This will benefit you as you won’t have to re-upload it when you update the theme, and will also help out others. If you want to contact us about this, please use the form provided on the page here:

Contact Us

## Setup the Home and Blog Page

To setup the home and blog page, navigate to Settings » Reading, select “A static page” and choose your “Homepage” page as the Homepage and “Blog” page as the Posts page.

## Logo, Favicon, Top Menu, Header image

WordPress comes with a wonderful and easy to use Customize functionality, letting you quickly set up a custom logo, color, top bar. You can customize them by going to Appearance » Customize.

### Setting up Logo, Favicon, Top Menu

Logo loads from this panel if you selected Theme in How to control theme items. But if you select Plugin, Logo will load from the DateBook Theme Options (see screenshot below): DateBook » Design and Style » Header tab.

1. Go to Appearance » Customize.
2. Click the DateBook General tab.

### Setting up Logo, Background image

Logo loads from this panel below if you selected Plugin here: Appearance » Customize » DateBook General » How to control theme items

Background image loads from this panel if plugin DateBook is activated.

1. Go to DateBook » Design and Style » Header tab.
2. Click the Header tab.

## Setup All the Page Templates

Homepage and theme's other pages must have DateBook template. You can manually set the page templates.

Only Blog page must use Blog template.

1. To set the templates go to Pages » Edit
2. Select "DateBook template" from Page Attributes.

List of pages that must use DateBook template:

1. Classifieds
2. Contact Us
3. Login
4. Forgot password
5. Profile – Edit
6. Profile – Blacklist
7. Profile – Cart
8. Profile – Checkout
9. Profile – Classifieds
10. Profile – Comments
11. Profile – Favorites
12. Profile – Friends
13. Profile – Messages
14. Profile – Notifications
15. Profile – Photos
16. Profile – Privacy
17. Profile – Settings
18. Profile – Subscription
19. Profile – Tours
20. Profile – Verification
21. Profile – Who viewed me
22. Registration
23. Searching
24. Tours

## Profiles

Profiles let users showcase their data such as name, age, images, personal data, preferences and other data beautifully in the DateBook

### Creating A Profile

To create a profile a user must register on the frontend of the website clicking on the Register link. He will then must provide his name, date of birth, and also other information about himself.

#### Profile Image (Default Image)

User must upload his image, this is the Profile Image. Profile Image will be displayed in profile listing. If there is no image set as Default then First image will be automatically set as Profile (Default) Image.

Notice: For best result, profile image should be minimum 268px in width and 362px in height.

## Users

When Users register on the website their login informations are kept in the User table. Profiles are automatically created and kept in the Post table as Profiles.

As Administrator you can publish/suspend a profile, asign Top/Featured statuses and Verification. All these options are placed in the Administration Dashboard that is located above any Profile.

## Private Chat Messaging

Users can chat or send messages to each other. Every time user writes a message to others a notification email will be sent to a receiver.

## Favorites, Blacklist

Users can add any profile to their Favorites or Blacklist lists:

1. To add to Favorites, users should go to any profile and at the bottom click on the [Add to Favorites] button.
2. To see all added Favorites user should go to their Messages Panel. From there users can remove anyone from those lists.

## Profile Comments

Users can leave comments on other users' profiles. All comments are shown to public. They are not private.

### Adding a comment

Once user is on someone's Profile page, he should then click on the Comments button that is placed next to Profile Name and Image. Page reloads and the Comments and Comment form will appear.

## Classifieds

Classifieds are the advert offers from users.

To add an advert offer, user should go to My Account » My classifieds and there click on the [Add Classifieds] button.

## Tours

Tours are the offers from users on the website where they invite other users to join them for trabeling together.

To add a Tour offer, user should go to My Account » My Tours and there click on the [Add Tour] button.

## Social Buttons

At the bottom of each Profile there are Social buttons. Clicking on them opens the popup window of social network.

## Promo Options

### Real Status

Real Status is a feature showing visitors that User's profile is real and not scam.

Real Status is a small sign placed next to the user's name on the profile page.

To get the Real Status user must upload image where he holds a piece of paper with the name of the website on it.

You (Administrator) can give the Real Status to a user, for this go to user's profile and at the bottom in the Administrator panel click on the Add Real Status button.

### Top Profile

Top Profile is a feature placing User's profile at the top of search results on the Search page.

You (Administrator) can set the Top Profile, for this go to user's profile and at the bottom in the Administrator panel click on the Add to Top Profiles for 1 day, 1 week, etc. button.

### Featured Profile

Featured Profile is a feature setting background pattern to User's profile.

You (Administrator) can set the Featured Profile, for this go to user's profile and at the bottom in the Administrator panel click on the Add to Featured Profiles for 1 day, 1 week, etc. button.

## Posts / Blog

To start adding posts to your blog, navigate to Posts » Add New.

### Creating A Post

Once you’re on the Add New Post screen:

1. Start filling in the blanks: enter your post title, write your actual body content in the main post editing box below it.
2. As needed, select a category, add tags, and make other selections from the sections below the post.
3. When your post is ready, click [Publish].

Since creating and editing pages is basic WordPress knowledge, we won’t cover it in detail. If you’re new to WordPress, you may find the following resources valuable:

How to create a new post How to edit an existing post Using Categories and Tags

### Post formats

Post Formats was introduced with Version 3.1. A Post Format is a piece of meta information that is used to customize presentation of a post.

DateBook supports 4 different formats.

Standard format - is the default blog entry and looks like this:

Image Format enabled will make your Post look like this:

Aside Format enabled will make your Post look like this:

Quote Format enabled will make your Post look like this:

### Single Post

Single Post - is a normal blog post with some features:

## Credits

### CSS Files

assets/css/bootstrap.min.css - a sleek, intuitive, and powerful mobile first front-end framework for faster and easier web development. More info: Bootstrap

assets/css/font-awesome.min.css - Font Awesome icons. More info: Font Awesome

assets/css/ion.rangeSlider.css - Ion.RangeSlider. More info: Ion.RangeSlider

assets/css/social-buttons.css - social buttons - Facebook, Twitter, and so on.

assets/css/pikaday.css - Pikaday - Datepicker. More info: Pikaday

style.css - main css for the theme, which includes the layout and styling for all aspects of the theme.

### JavaScript Files

assets/js/bootstrap.min.js - Bootstrap comes with the powerful Bootstrap framework for its javascript elements. More info: Bootstrap

assets/js/html5shiv.min.js - HTML5 Shiv. More info: https://github.com/aFarkas/html5shiv

assets/js/respond.min.js - Respond.js. A fast & lightweight polyfill for min/max-width CSS3 Media Queries (for IE 6-8, and more). More info: https://github.com/scottjehl/Respond

assets/js/ion.rangeSlider.min.js - Ion.RangeSlider. More info: https://github.com/IonDen/ion.rangeSlider

assets/js/pikaday.js - Pikaday. A refreshing JavaScript Datepicker. More info: https://github.com/Pikaday/Pikaday

assets/js/retina.min.js - Retina.js is an open source script that makes it easy to serve high-resolution images to devices that support them. More info: https://imulus.github.io/retinajs/

assets/js/script.js - this is where all the custom magic happens. Feel free to edit any of this code, but make sure to keep a backup in case anything goes wrong!

### Fonts

assets/fonts/ - folder contains the following fonts:

Font Awesome - fontawesome.com

Engagement - Brian J Bonislawsky DBA Astigmatic

### Images and Icons

Image (Startup business plan concept design with flying rocket) Designed by Starline

Images (City people street on the Front page, Couples on the Login page, profile images) by pexels.com

Icons (female and male) by iconfinder.com

Icons (edit icon) by iconfinder.com

Icons (Locked folder icon) by Freepik from www.flaticon.com is licensed by CC 3.0 BY