Introduction

This documentation will give you an understanding of how Sam Martin is structured and guide you in performing the most common functions. If you require further assistance, related to topics not covered in this documentation, then please contact us via Our Support Forum

If want to customize this theme as per your requirement, please contact us here: Our Support Forum

Author: Potenza Global Solutions www.potenzaglobalsolutions.com

NOTE: We will not respond to any support questions on Item comment section or through e-mail. If this document doesn’t answer your questions feel free to open up a private ticket in our our support forum

If want to customize this theme as per your requirement, please contact us here: Our Support Forum

WordPress

WordPress is one of the most popular CMS in the world that makes it the best choice for your website.
You can download and install the WordPress from the official website using WordPress’ very setup steps called “Famous 5-minute install”.
For more information on WordPress, please, visit the WordPress Codex page.

Theme requirements:
Please check the recommended server configuration for proper theme functioning:
– PHP version 5.4 and higher
– memory_limit – 512M
– max_execution_time – 600
– max_input_time – 600
– upload_max_filesize – 256M
– max_input_vars – 3000
Make sure your server is set up properly and the theme and content will be loaded correctly.
Enough server configuration will also ensure fast speed and increased performance.

Theme Installation

Package from Themeforest

With your purchase of this theme, the first step is to download the package from ThemeForest. Move your mouse over your ThemeForest Login name in the right top corner and click Download. You will see the number of items purchased, along with the package’s content, as shown in the following diagrams.

Next, click Download > All files & documentation next to Sam Martin theme and save the package on your computer.

The download includes documentation, license, zipped file with theme files and the Sam Martin theme files folder. Unpack the entire package after downloading.

Sam Martin Theme Installation

Before you can complete the installation, make certain you have unpacked the entire package. This is very important! You can complete the installation in either of the following two ways:

  1. WordPress Theme Manager – please go to Appearance > Themes > Add new > Upload, select the zipped theme folder called sam-martin.zip and press Install Now WordPress will do the rest for you.
  2. FTP upload-upload non-zipped sam-martin folder to the /wp-content/themes/ folder in the WordPress installation folder on your server.

IMPORTANT!!! After theme installation, you will see a box with information about required and optional plugins. To install and activate them, navigate to Appearance > Install Plugins and install only those plugins that are required, or are optional but necessary.

Plugins include:
Visual Composer (required)
Contact Form 7 (required)
WooCommerce (optional).

Theme Activation

In Sam Martin v3.0.0, to reduce the theme package size, we moved sample-data and plugins on our server. So, to access these resources, from the server, it will require to activate the theme first.

Also, since the theme activation system is integrated into the new version, some core features will be deactivated, until the theme is not activated. Once, the theme is activated, all the features will be activated.

To activate the theme, follow the below steps:

  1. Update the theme with the latest version.
  2. Go to Admin Panel > Sam Martin.
  3. Enter purchase-code and click on “Check” button.
  4. Click on Plugins tab. It will redirect to theme’s bundled plugins page.
  5. Update “Sam Martin Theme Functions” to latest version.

Once the theme is activated, it will display some tabs, including License, Support, Plugins, Theme Options, Install Demos, System Status, and Ratings.

If you are installing and activating, the theme for the first time or plugins are not updated to latest, it will display License, and Plugins tabs only. From the Plugins tab, you can install/update necessary plugins, and once all the required plugins are activated, other tabs will appear.

Sample Data

The theme is provided with the demo content. You may install it and customize to make the site creation easier – it’ll help you to understand how to create the layouts. However, you may not install the content and skip this step.

One click install

The theme is provided with the demo content. You may install it and customize to make the site creation easier – it’ll help you to understand how to create the layouts. However, you may not install the content and skip this step.

If you use the 1 Click Demo Install option, you don’t need to use .xml files. Simply go to Theme Setting > Sample Data and click on install button. Once you click on install button then home page, blog page, post, portfolio, testimonials, menu and widget are automatically set.

Here’s also step-by-step instructions of how to re-create pre-built website, please watch instructional video in video section below.

FAQs and Troubleshooting

Q.: I’ve installed the demo content but my homepage is 404 page. Where can I set the homepage?
A.: The homepage can be selected in Settings > Reading > Front page displays > Static page > and select the needed page in Front page dropdown. The blog page can be selected in Settings > Reading > Front page displays > Static page > and select the needed page in Posts page dropdown.

Site layout

In this section, you can set site layout of the theme.

  1. Site Layout: In site layout option, you can change the site layout; we have given total three site layout options. By default, we give the First layout option. In this layout, site header appears on left side and site content is set on right side.

Header - Site Logo & Favicon Icon

Here you can set all the logos that will be used on the site.

  1. Site Logo: You can change Site logo from Theme Setting > Header > Site Logo
  2. Favicon Icon: Small logo that will be displayed in the browser tab near the site/page title.

Default Header Setting

By default theme sets the header image and background color and opacity option. This setting is enabled for all inner pages except home page. If you want to change particular page header background image and background color and opacity then you can change from particular page settings from backend Pages > Add new/All pages.

Color Schemes

In colour schemes, you can change the site default colour and set as per your site design.

  1. Main Theme Color: In this option, you can change the main colour of the theme.
  2. Secondary Color: In this option, you can change the colour of the theme sections’ titles.
  3. Tertiary Color: In this option, you can change the colour of the theme sections’ contents and icons.

Social Profiles

In social profiles, you can add/edit social information of your site.

  1. Facebook: In this option, you can add/edit your Facebook social profile.
  2. Twitter: In this option, you can add/edit your Twitter social profile.
  3. Dribbble: In this option, you can add/edit your Dribbble social profile.
  4. Vimeo: In this option, you can add/edit your Vimeo social profile.
  5. Pinterest: In this option, you can add/edit your Pinterest social profile.
  6. Behance: In this option, you can add/edit your Behance social profile.
  7. Linkedin: In this option, you can add/edit your Linkedin social profile.
  8. Instagram: In this option, you can add/edit your Instagram social profile.
  9. Add Custom Profile: In this option, you can add your custom social profile.

Social Sharing

We give total five social sharing features like Facebook, Twitter, Linkedin, Google Plus, Pinterest. If you want to disable any social sharing feature then you can disable from this section. This social sharing icon will appear on blog listing page and blog detail page.

Inner Page Setting

If you want overwrite default header setting for particular page then you can change default header setting from this section.

Potenza Custom Shadow Heading Settings

If you want to set section Heading with shadow then you can use the element in visual composer.

Potenza Availability Calendar Settings

You want to display your availability date then you can use element in visual composer and lists down your absent date in list. So, your absent date will be displayed on fronted date calendar.

Potenza Features Settings

Potenza features element provides different icon list. You can set any section with icon, title and subtile. Also give the option for set title heading tag like h2, h3, h4, h5 and h6.

Potenza Portfolio Settings

Display your portfolio on a page. First of all you have to create portfolios in the corresponding section of the admin panel

Categories – select the categories, you’d like to display the portfolio works from. Works of all categories are displayed by default if no category is selected.

Potenza Services Settings

  • Icon library : choose icon library which type of icon you want to display
  • Icon : Icons list will be appear as per your selected icon library
  • Title : Add your title
  • Description : Add you section description
  • Button Text : add button text
  • URL (Link) : add button action link

Potenza Skill Bar Settings

Skill bar element provides two types of skills. One is skill bar and second is skill circle. You can use any one as per your requirement.

Potenza Social Icon Settings

Provide pre-defined social icon lists, you can set your social media link. Pre-defined social icon lists:

  • Facebook
  • Twitter
  • Dribbble
  • Vimeo
  • Pinterest
  • Behance
  • Linkedin

Potenza Testimonials Settings

  1. Display your Testimonials on a page. First of all you have to create portfolios in the corresponding section of the admin panel.
  2. Categories – Select the categories, you’d like to display the portfolio works from. Works of all categories are displayed by default if no category is selected.
  3. No. of Testimonials – You can enter number for how many testimonials you want to display. If you will not add any number then display all testimonials in this section.

Potenza Typer Settings

A script that causes any text on the page to be typed out, one letter at a time.

Translation

WordPress does not support a bilingual or multilingual blog out-of-the-box. There are however Plugins developed by the WordPress community which will allow you to create a multilingual blog easily.

Sam Martin is built with translation support. So, you can use commercial/non-commercial plugins, available on various sources, to translate your site.

Sam Martin theme package contains below items:
1. Sam Martin : Main theme.
2. Sam Martin – Theme Functions : Plugin containing supporting functions and features.
3. PGS Testimonials : Plugin contaning testimonials related functions.
4. PGS Portfolio : Plugin contaning portfolio related functions.

Text strings displaying in backend or frontend comes from above theme/plugins. Also, a major or minor part of text strings, may come from WordPress core and other installed plugins. So, translation will require to translate text strings from all these resources. Along with this, contents comes from database, not from files, which is added by user, must be translated too.

A fully localized and translated WordPress website requires translate contents and text strings.

Here below is provided few translation methods:

PoEdit

With PoEdit, you can add/edit translation files in your required language(s).

You can find translation file at below path.
/wp-content/themes/sam-martin/languages/sam-martin.pot

Open translation file in PoEdit, and create new translation by clicking on “Create New Translation”

Select your required language, we are choosing French as sample.

Save new created translation in /wp-content/themes/sam-martin/languages/sam-martin.pot folder.

When you save translation, it will generate .po and .mo files both.

Note: Same like you can translate other plugins/theme, by editing/translating translation files.

Loco Translate plugin

Loco Translate is a free plugin, hosted on WordPress Plugins Repository, which provides in-browser editing of WordPress translation files. It also provides localization tools for developers, such as extracting strings and generating templates.

For setup/translation steps and more information, please check below links:
Loco Translate – WordPress Respository Installation Guide
Loco Translate Guide on localise.biz

WPML plugin

WPML is a commercial plugin, which provides in-browser translation management, which stores all translations in database.

For translation guide, please check below link:
WPML – Getting Started Guide

Retina Display

The basic concept of a Retina image is that an image twice the size of a standard web image will be displayed on screen. On a non-retina device an image will be 100px X 100px whereas a Retina device will display the same image but at 200px X 200px. Most of devices use this branded concept for Retina devices like having approximately twice the pixel density of a non-retina device.

If you want to get perfect looking images on Retina screens. If for example you build website where you upload regular images into Content, you must always upload 2 images in Media
Add new section which looks like below:

my_image.png - this is the name for standard image (e.g. 100px X 100px)
my_image@2x.png - this is the example name for retina image and file must be always 2x larger than regular image (e.g. 200px X 200px)

Note You need to include retina.js to make your website completely retina ready. See example below:

<script type="text/javascript" src="js/retina.js"></script>

For more information about retina documentation and to download retina.js Click here.

Browser Support

Sam Martin support all major browsers like Google Chrome, Mozilla Firefox, Safari, Edge, Opera, and Internet Explorer 11 (and above).

How to rate this item

If you like our theme and support, Please do not forget to rate it with 5 stars in your Downloads section and write a review in Comments as it will add more value to our services!

Kindly visit here: http://themeforest.net/downloads and find “Rate this item” below the download button and rate out the theme.

Plugins Documentation

You may find some useful documentation and tutorials links here.

  1. Visual Composer Plugin documentation link.
  2. Woocommerce documentation link.

WooCommerce / Shop integration

Sam Martin is fully compatible with the WooCommerce plugin. We carefully designed Sam Martin in such a way that you can build a nice shop that is loaded with options, and one that is perfect in appearance. Since WooCommerce is an external plugin, you will find any information you may need about it in the WooCommerce author’s page. Here are several useful links:

  1. WooCommerce Plugin Page
  2. WooCommerce Documentation
  3. WooCommerce Forum
  4. WooCommerce Shortcodes

How to install WooCommerce and setup the default shop pages

  1. First go to Plugins > Add new section and type “WooCommerce” into search field. Then click “Search Plugins” button.
  2. Once that is done, and you see the result, click on the “Install now” button next to “WooCommerce – excelling eCommerce” plugin.
  3. Once WooCommerce is installed, click on the “Activate plugin” link.
  4. In a few moments you will see a WooCommerce Purple Notification Bar at the top of the plugin page. Clicking the Install WooCommmerce Pages button in the purple bar will install all the default pages.

Source & Credits

All images are for preview purposes only and are not included in the download files. Images of copyrights under Creative Commons CC0.

Images

Scripts

CSS & Fonts

Note For questions on basic WordPress, HTML, Javascript or CSS editing – please give your question a quick Google or visit W3Schools as theme issues get top priority.

Video

Here’s step-by-step instructions of how to re-create pre-built website, please watch below instructional video.

Suggest Edit