Welcome to CityBook - Directory Listing WordPress Theme
"CityBook – Directory Listing WordPress Theme" is perfect if you like a clean and modern design. This theme is ideal for designers, photographers, and those who need an easy, attractive and effective way to share their work with clients.
Finally thanks for selecting CityBook
Get started with CityBook
This documentation is briefly describe all of sections and themes options. I wish it is help you to customize your site what you want.
When you purchase our theme from Themeforest, you need to login to Envato then download theme zipped file from Downloads tab. We recommend you download theme with All file & documentation option selected.
Theme zipped file:
Demo Content – folder contains exported .xml demo content file and shortcode content for all demo pages, CityBook Listing.
Documentation - folder contains off-line documentation version for CityBook theme.
Download the theme to your local machine and extract it then you will find citybook.zip file in the extracted folder.
In cPanel File Manager, navigate to WordPress themes folder. If your WordPress is installed in the document root folder of your web server you would navigate to "public_html/wp-content/themes" and if you have WordPress installed in a sub-folder called wordpress, you would navigate to "public_html/wordpress/wp-content/themes".
Once you've navigated to the themes folder in cPanel File Manager, click on Upload file(s) and upload that .zip file you saved in Step 1.
Once the .zip file is uploaded, click on the name of that file in cPanel, then in the panel to the right, click on "Extract File Contents", and that .zip file will be uncompressed.
From the Themes panel, roll over the Theme thumbnail image for the CityBook you are interested in to see options for that theme.
You can view more information about any theme by clicking Theme Details.
A live preview of any Theme (using your blog's content) can be seen by clicking Live Preview.
To activate the Theme click the Activate button.
For more detail on install and using a Wordpress Theme please read this tutorial: Codex - Using Themes
Install Required and Recommanded Plugins
After activating the theme you will see a submenu in your admin Appearance > Install Plugins. Where you have to install and active all required plugins.
Setup a Demo package
Before you can get started with your CityBook theme and have your site look like the demo, you first need to add content to WordPress. There are two way to import demo data for the theme.
Notice: please make sure that all theme required plugins are installed and activated.
Method 1: - Using One Click Demo Import plugin intergrated in Appearance menu.
When installed and activated the theme and its required plugin named One Click Demo Import you can import demo data by follow these steps:
Log into your site as an administrator.
Go to Appearance -> Import Demo Data admin menu.
On Import Demo Data screen select data you want to import to your site then click to Import Demo Data button and wait until you get the success message.
With Full Demo Content (widgets included) demo data selected you don't need to follow Import Demo Widgets tutorial from Sidebars and Widgets section.
Method 2: - Using WordPress Importer plugin.
In your downloaded theme package folder there is a file named citybook.wordpress.2017-08-02.xml in Demo Content folder, it is the demo data .xml file that was exported from our demo. It will be used in WordPress Importer plugin to import all demo data to your site.
There are also separated content files for each post type from the demo, was exported there if you only want import one of them. They are in \Post Types .XMLs/post_type.xml format.
To import from a WordPress export file into a WordPress blog follow these steps.
Log into that blog as an administrator.
Go to Tools > Import in the blog's admin panels.
Choose WordPress from the list. (You need install the plugin for the first time)
Upload the file using the form provided on that page.
You will first 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
WordPress will then import each of the demo pages, posts, galleries, media, comments, categories and contact froms contained in this file into your blog.
After import the demo content let setup your blog like our demo
Setting up your front page
Go to Settings > Reading in the blog's admin panels
In Front page displays option you will have two options
Your latest posts - If select this your front page will look like our blog demo page (listing posts from your blog)
A static page (select bellow) - Select one (Home page) of our demo pages that imported to your site before - Then your front page will look like our home demo page.
You must define a menu before you can add items to it.
Login to the WordPress Dashboard.
From the Appearance menu on the left-hand side of the Dashboard, select the Menus option to bring up the Menu Editor.
Select Create a new menu at the top of the page
Enter a name for your new menu in the Menu Name box
Click the Create Menu button.
Your new custom menu has now been defined.
Adding Items to a Menu
You can add different link types into your menu, these are split between panes left of the menu you're currently editing.
Locate the pane entitled Pages.
Within this pane, select the View All link to bring up a list of all the currently published Pages on your site.
Select the Pages that you want to add by clicking the checkbox next to each Page's title.
Click the Add to Menu button located at the bottom of this pane to add your selection(s) to the menu that you created in the previous step.
Click the Save Menu button once you've added all the menu items you want.
Your custom menu has now been saved.
Note The Screen Options allow you to choose which items you can use to add to a menu. Certain items, like Tags are hidden by default.
Customising Menu Items
This field specifies the title of the item on your custom menu. This is what your visitors will see when they visit your site/blog.
This field specifies the Alternative ('Alt') text for the menu item. This text will be displayed when a user's mouse hovers over a menu item.
Select "Same window or tab" or "New window or tab" from the pulldown.
Optional CSS Classes for this menu item,
Creating Multi-level Menus
When planning the structure of your menu, it helps to think of each menu item as a heading in a formal report document. In a formal report, main section headings (Level 1 headings) are the nearest to the left of the page; sub-section headings (Level 2 headings) are indented slightly further to the right; any other subordinate headings (Level 3, 4, etc) within the same section are indented even further to the right.
The WordPress menu editor allows you to create multi-level menus using a simple 'drag and drop' interface. Drag menu items up or down to change their order of appearance in the menu. Drag menu items left or right in order to create sub-levels within your menu.
To make one menu item a subordinate of another, you need to position the 'child' underneath its 'parent' and then drag it slightly to the right.
Position the mouse over the 'child' menu item.
Whilst holding the left mouse button, drag it to the right.
Release the mouse button.
Repeat these steps for each sub-menu item.
Click the Save Menu button in the Menu Editor to save your changes.
Adding Menu to Your Site
CityBook theme supports custom menus, you will be able to add your new menu to one of two Display Locations: Top Menu, Social Links Menu.
Scroll to the bottom of the menu editor window.
In the section titled Display locations, click the check box for the location where you want your menu to appear.
Click Save menu once you've made your selection.
1. Main Menu structure
This menu will display on header of your pages.
2. Social Links Menu structure
This menu will display on footer of your pages.
And this is how they display on the front-end site.
To add a widget in your theme’s CityBook, navigate to Appearance > Widgets. The big panel on the left side shows all available widgets. The small panels on the right are the widgetized areas. Total 2 areas are available.
Blog Sidebar (Main Sidebar): the sidebar area where you your widgets display on archive and single post pages.
Page Sidebar: This sidebar only is available in page templates
4 columns on Footer:
Import Demo Widgets
Search in Theme Downloaded Package (extract zip file first) > Demo Content you will find citybook-widgets.wie file, is our demo widgets content exported and included in the package.
To use the exported file you must to install new plugin call Widget Importer & Exporter
Go to Tools > Widget Importer & Exporter submenu.
Use Choose File button under Import Widgets section select the file then click to Import Widgets button.
When done you will have blog sidebar like our demo.
Sidebar Widgets Configuration
To make Main Sidebar and Page Sidebar widgets available you need to change Blog Sidebar Layout option in Appearance -> Customize panel to Left or Right Sidebar. Or select custom template for post/page.
For more details in creating wordpress widgets please read this guide: WordPress Widgets
Create Footer Area with Widget:
Elementor Page Builder
Elementor Page Builder for WordPress will save you tons of time working on the site content. Now you’ll be able to create complex layouts within minutes! It’s build on top of the modern technologies – get the best for your lovely website!
Have you ever noticed how much time you spend fighting with [shortcodes]? No more trial and errors with “shortcodes magic” – Elementor Page Builder will take care of that.
Add columns/elements with single click, then use your mouse to drag elements around to re-arrange them.
“Elementor Page Builder ″ comes as a part of CityBook.
You manage and customize each of these elements, by clicking on the corresponding section, column, or widget handle. Access the handle by hovering over the top right corner of widgets until a blue box appears, or on the top left corner of a column until a gray box extends.
Let’s edit a section.
Hover over the top middle outline of a section to access its handle - the blue box.
The handle lets you:
Move a section up or down the page by clicking Edit Section and dragging it
Duplicate, add, save, or delete a section
The same handle options are available for columns and widgets.
There are 2 important options we have to notice you:
CSS ID and CSS Class: is 2 important fields you need to notice. We will use some special CSS class and do highlight for you.
We don't recommend you create new City Listing from Backend, but on some case you can follow these steps below:
Step 1 – Navigate to CityBook Listing > Add new Listingin your WordPress admin sidebar.
Step 2 – Click on the Add New option to make a new CityBook Listing. Create a title, and insert your description about CityBook Listing in the editor.
Step 3 – Add Listing Categoriesfrom the right side. To assign it to the current CityBook, check the box next to the Listing Categories name.
Step 4 – For a single image, click the first Featured Image Box, select an image and click the Set Featured Image button.
Step 5 – Scroll down to Media Settingsbox, inside you can custom information for your CityBook Listing
Step 6 – Once you are finished, click Publish to save the post.
Submit new City Listing from FRONTEND
We RECOMMEND you should create new Listing from Front end, It's really visual and easy, see the screenshot below:
2. Create Category for Listing
Navigate to CityBook Listings > Listing Category, you can add new Category manually
This is important option of CityListing, after creating it, you should press to the Edit button to update some important information for them:
1. Available Features: This is feature list for the Category, you can pick it easy on box
2. Additional Features: This option is really good for custom job if you want to use theme for other purposes
3. Content Widgets Order: You can customize the display position of content area in a single listing depending on its category.
Ex: Car category, you need to arrange the price at the top, detailed information at the bottom ..
But a single listing of Restaurant is another layout This option allows you to customize the layout easily
3. Create Features for Listing
This features is created and assigned for Category item, you should create it base on the Category list
1. Normal Account
1. Register new Account
Now just need to register new Account and Login by this Form, after registing you willn't be annoyed by email Email Confirm.
2. Manage your Information
After login, you can edit all Person Informations here:
3. Manage your Booking Informations:
Navigate to Dashboard > Booking to check your Booking History
You also CANCEL this BOOKING by Press to the Cancel
2. Upgrade to Partner Role
Partner Role allows you SUBMIT NEW LISTING, MANAGE YOUR BOOKING.. and more other Features on site, This is Membership feature of theme. There
Of course, You can build new Listing, then all of them is saved on the Listing > My listings:
Manage the Booking Order:
You can manage your booking here:
CityBook Theme Customization
Now you have successfully installed CityBook theme. You can go to Appearance -> Customize to customize your own unique website!
1. Site Identity
3. Static Front Page
4. Thumbnail Sizes
5. Colors & Fonts Options
6. Blog Options
7. Footer Options
8. Error 404
9. Additional CSS
CityBook Add-ons plugin
1. General settings
2. Membership settings
3. Submit settings
4. Search settings
5. Listing settings
6. Single Settings
7. Google map setting
8. Payment Settings
9. Email Settings
10. Widget settings
11. Maintain Page Settings
12. ADs Settings
Theme and Plugin Translations
The theme and its plugins come localization ready out of the box – all that’s needed is your translation, if the theme does not come bundled with one for your language.
There are several methods to create a translation, most of which are outlined in the WordPress Codex. However, we find the easiest method is to use a plugin called Loco Translate. More advanced users can use PoEdit. Both methods are covered in this doc.
Before you begin
The theme includes a language file (.po or .pot file) which contains all of the English text. You can find this language file inside the theme folder in \public_html/wp-content/themes/citybook/languages/.
Set up Wordpress
WordPress needs to be told which language it should run under.
Go to: Dashboard > Settings > General and change the Site language.
Once this has been done, the theme will be displayed in your locale if the language file exists. Otherwise you need to create the language files (process explained below).
Translating with Loco Translate
Loco Translate is a free plugin that you can download here. You can also add directly from the WordPress administration, in Plugins > Add New.
Once you downloaded and installed Loco Translate, a new “Loco Translate” menu item is created with two sub-sections. By default the “Manage Translations” section will list all your themes and plugins and will display all available translations for each of them:
Loco Translate Listings
You can easily add new languages to a theme or a plugin using the Add New Language link:
Loco Translate: add new language
Then choose the language to add in the list, or enter the language ISO code (ex: fr_FR, en_US etc…), and select the folder to add the translation files to, and hit Start Translating:
Loco Translate: create new language
Finally start translating, and save when you finish:
Loco Translate: Start translating!
Translating with PoEdit
PoEdit is a more advanced alternative to Loco Translate. Only advanced users should attempt this method.
CityBook comes with a POT file which can be imported into PoEdit to translate
To get started open PoEdit and go to File > New catalog from POT file. Once you have done this, choose citybook.pot and PoEdit will show the catalog properties window:
Enter your name etc so other translators know who you are and click ‘ok’. After this you will be prompted to save your .po file – name it based on what you are translating to, for example, a GB translation would be saved as en_GB.po . Now the strings will be listed.
After translating all strings you can save – the .mo file will also be generated automatically.
Translate the strings
Update your translation
After updates, you can update your po file by opening it and then going to Catalog > Update from POT file. Choose the file and it will be updated accordingly.
Auto Update Theme
Envato Market plugin was integrated with this theme to help you update it automatically when a new version release.
To use this plugin you should install it as required plugin for CityBook theme. Navigate to Appearance -> Install Plugins submenu and check to Envato Market plugin to install and active it.
Envato Market plugin screen:
You will need to generate a personal token, and then insert it to Token field:
After saving it, you can Go to Appearance -> Themesclick to the Update, the newest version will be update automatical
The new version comes with the update of the CityBook Add-ons plugin. Please remove the current plugin and then install the new plugin to get the latest version