Thank you for purchasing the Mentor - Premium Drupal Theme by Theme Boutique. In order to get the most out of your purchase, please make sure to carefully read all of the information contained in this document. Use the table of contents on the left hand side of the page to jump to a relevant section.
New installations come equipped with all of the demo content and can be set up in a matter of minutes. Follow the steps below to get started:
Existing installations do not come with the demo content. If you would like to implement the footer blocks seen in the theme demonstration, please refer to the footer blocks section of the installation guide. To setup the Mentor theme on an existing installation, follow these steps:
Sometimes referred to as i10n, Localization allows for localized and/or multilingual Drupal installations. This section of the documentation will cover three areas:
Before we can begin exploring the multilingual capabilities of our Drupal installation we'll need to install the appropriate language libraries.
To change the text direction to right-to-left, follow these steps:
The steps above install a basic multilingual configuration in Drupal. If needed, the Internationalization suite can be used to extend Drupal's multilingual capabilities even further. Download the Drupal 7 version and place the contents in the sites/all/modules folder to get started.
This section contains a list of the content types which come prepacked with the Mentor theme. Content types are used to organize the nodes created on your Drupal website. Each content type has specific fields for certain pieces of data. These fields are described in greater detail for each content type below:
To create a new node under a content type, click the Add Content link in the Drupal administration toolbar at the top of the page. A list of each content type will be prompted -- choose a content type and create the new node.
Fields for each content type can be added, edited or deleted through the Drupal administration interface. Please refer to the documentation related to each individual content type for more details.
The following fields can be editted in the Drupal administration interface. Navigate to Structure > Content Types > Basic Page > Manage Fields to modify the basic page field settings.
Below is a list of each basic page field along with a description of it's respective purpose:
The following fields can be editted in the Drupal administration interface. Navigate to Structure > Content Types > Blog Post > Manage Fields to modify the basic page field settings.
The contact page is generated by the Contact module. To change the e-mail address this page sends to, naviagate to Modules > Contact > Configure.
Several elements on the contact page can be modified through the Mentor theme settings by navigating to Appearence > Settings > Contact Page. Here the latitude/longitude values for Google Maps, along with the introduction message on the contact page, can be configured.
Mentor requires a few Drupal modules to function fully. To enable these modules, navigate to the Modules section in the Drupal UI (found at the top of the screen in the Drupal administration toolbar). Inside of the sites/all/modules folder of the download files you will find the following module folders and their contents:
Drupal 7 menus can be configured through the administration interface at Structure > Menus. This portion of the documentation will detail the following:
To create or modify a dropdown menu, navigate to Structure > Menus > Main Menu > Edit Menu. The diagram below illustrates
an example of a dropdown menu:
The diagram above illustrates a parent link (the Pages link) and several child links (indented items underneeth the Pages link).
Ensure that the parent item always has the show as expanded item checked to trigger a dropdown menu. Each child link, along with the parent item, must be checked as Enabled to be displayed in the menu.
Indenting any menu item will make the item a child link within the dropdown menu.
Mentor's menu system is built with elements from the popular Twitter Bootstrap framework using a modified version of the Menu Attributes module to style menu items.
The diagram below lists each menu item used with the Mentor theme:
Blocks and Regions are two elements used do develop Drupal websites. Blocks (a block of content) are placed inside of regions to organize the content which appears inside of regions on your Drupal website. This section will document the following information:
The grid below demonstrates the region layout for the Mentor theme. Each region is used as a container to hold blocks. CSS elements for each region can be added/modified through the Theme Settings at Appearence > Settings > Regions.
The diagram above can be used to help you determine where on the page you want to place blocks. Blocks can be created, and added to regions, by navigating to Structure > Blocks in the Drupal administration interface. The section below, titled Blocks, will describe creating new blocks and placing blocks within regions in greater detail.
Blocks can be added/modified by navigating to Structure > Blocks > Add Block in the Drupal administrative interface. Each block can hold plain text or full HTML markup and be used on multiple pages of your website.
Using a block is highly recommended when an element needs to be used on multiple pages. Make sure you check the filter settings if HTML is needed.
Blocks can be edited by navigating to Structure > Blocks in the Drupal administration interface, or by hovering over a block on the page and clicking the Edit block link.
CSS classes can also be added to each block on the edit block page.
Blocks can be placed in regions by utilizing the "drag and drop" interface found at Structure > Blocks or on the block edit page:
Each block can be edited by navigating to Structure > Blocks in the Drupal administration interface and clicking the "configure" link next to the block you wish to modify.
To place a block on a specific page, or multiple pages, navigate to Structure > Blocks in the Drupal administration interface and click the configure link next to the block you are editing.
Locate the Pages tab at the bottom of the page. Here you can specify the address to each page you wish to include or disclude each respective block on.
Example In the example on the left, the block will only be listed if the path is /contact or /node/17.
Note: If a more robust way to control blocks/regions is desired, use of the Context module is highly recommended.
The Views Module is a popular Drupal module utilized extensively within the Mentor theme framework to build blocks and pages based upon node and taxonomy content. Views is being integrated into Drupal core for Drupal 8, so if you've never used the module before now is a great time to learn. Both the Mentor: Tools module and demo content file (enabled during theme installation) come packaged with the following views (found at Structure > Views):
Click the Edit button to modify each view individually. If you would like to control the placement of these blocks on pages, please refer to the Blocks/Regions section of this documentation.
Views is a complex module with an enormous amount of capabilities (which are far too broad to detail in this documentation file). If you are unsure of how to configure the Views module, please contact Theme Boutique support and we can help you solve your problem.
If you're a more experienced Drupal user, there is nothing particularly important that needs to be known about the View pages/blocks which come with the Mentor theme. Fields, field markup, and filters can be added or modified as needed. If the need to revert a view back to the default settings should ever arise, navigate to Structure > Views and locate the view in question. Open the dropdown menu for the view and click "Revert" (the Mentor: Tools module must be enabled for this functionality).
Various settings for the Mentor theme are specified through Drupal's theme settings, found at Appearence > Settings. The theme settings comprise of four sections:
The general settings consist of the default Drupal theme settings.
The region settings allow users to add a Twitter bootstrap grid class and additional CSS classes.
The layout settings section contains the following options:
The contact page section contains the following options:
To create a new slideshow, navigate to Structure > Add Content and select the Mentor: Slider option. When creating a new slider, there are three fields which must have values:
Now that you have some slides with data/images created for a slideshow, the content needs to be generated by creating a block with the Views module. Navigate to Structure > Views > Mentor: Slider.
First, you'll want to clone one of the existing blocks by utilizing the dropdown menu found on the right hand side of the screen (figure 1). Once a clone has been created, change the node ID in the "filter settings" to the node ID (figure 2) for the Mentor: Slider node you created in Step 1: Create Slides. When finished, save your new view block and assign the new block to the appropriate page at Structure > Blocks.
The Revolution Slider module links together three key components: the slide builder, the Views Module, and Revolution Slider option sets. This section of the documentation will detail the aforementioned components in greater detail so you can get started on creating your own slides as soon as possible!
Before we can create a slider, we're going to need to populate the slider with some slides first. The Slide Builder tool will be utilized for this process. Navigate to Add Content > Revolution Slider.
The slide builder consists of five sections:
Although descriptions for each field are provided in the slide builder itself, further documentation may be needed if you have never used the Revolution Slider in the past. Please refer to the Revolution Slider documentation (found in the assets folder of the Mentor theme download from ThemeForest) for a comprehensive overview of the plugin's capabalities.
Notes:
The Slide Builder module integrates with the css/slider.css file found in the Mentor theme directory. When stying your slider elements, please make sure to use this file if you want to see your styles in the Slide Builder preview.
If this theme was purchased simply for the Revolution Slider module and you plan on using the module with a different theme, the location of this CSS file can be modified on line 395 of revolution_slider.module in the modules/revolution_slider folder (Note: for advanced users only -- if you don't know PHP, simply create a css/slider.css file in the folder of your default theme instead).
Option sets can be defined by navigating to Configuration > Revolution Slider in the Drupal UI. Existing option sets can be edited and new option sets can be defined here. These option sets will be used in the third part of this process (View Blocks).
You may be wondering -- what is an option set? Option sets are a collection of defined slider settings which can be applied to Revolution Slider blocks in views. These options influence default slider settings, transitions, speeds, and navigation elements for the Revolution Slider module:
Descriptions of these options are detailed in "Layout" section ofv the Revolution Slider plugin documentation (found in the assets folder of the Mentor theme download from ThemeForest). When done editing an option set or defining a new option set, be sure to save your options.
At this point, we should have at least a few slides built via the Slide Builder tool and an the default option sets defined (at a minimum -- feel free to define yor own options when necessary). The Views module is going to be used to integrate the slides and option sets. To get started, navigate to Structure > Views > Revolution Slider > Edit.
Click the Settings link next to "Format: revolution_slider" to assign option sets to a view block.
When the option set is selected, click the Apply button and save the view. The Revolution Slider block is now ready to be used! Please visit the Contexts section of the documenation for more information on assigning blocks to regions.
To add a new slider block, navigate to Structure > Views > Revolution Slider > Edit. On the right hand side of the page there is a drop down menu with the contents "edit view name/description" selected. Open this menu and click Clone View.
This process will create a clone of the original Revolution Slider block that can be modified as needed. Repeat the steps listed above to customize this slider block.
Having troubles? We're here to help! Theme support is handled through our dedicated support forum. If you are having an issue with a theme, please create an account on our support forums (you'll need access to your purchase code to create an account). Once your purchase has been verified, your forum account will be approved. Thanks!
All theme modifications which alter or built upon the original theme functionality are considered extra customizations and are not covered by Theme Boutique's support policy. If you would like to request a quote for paid customizations, please contact us through our author profile page and we will respond to your query within 48 hours.