Getting Started

Alright, let's get to work. First, we need to make sure that you have all the necessary things to install Ad-Sense. You'll need to perform the following steps:

Theme Requirements

First, make sure you have the latest WordPress installation, by checking the update panel within your current WordPress installation. If you don’t have WordPress already, you can download it from the WordPress repository. While Ad-Sense might work with older versions of WordPress, it is recommended to have the latest version of WordPress.

Next, download the theme ZIP file, and save it somewhere handy on your computer, as you will be using the included files for the rest of the installation process.

Theme Files

Ad-Sense includes a variety of files, including the necessary theme files, as well as some other useful files. We'll cover what files are included with a description now:

• Assets
  • PSD Files— Ad-Sense includes Photoshop (PSD) source files (only with our Extended license) that make it easy to change or customize more complex elements of your theme. Basic design changes can be done through the options panel, but as a courtesy, the original PSD source files are included as well. Home.psd and Single.psd are the Homepage design and Single Page design respectively, and included layered source files that may be edited in Adobe Photoshop.
  • Pre-Defined Layouts— All different layouts showed in the demo can be used from WP Dashboard >> Appearance >> Theme Options >> Import/Export
• Documentation— The documentation file you are currently reading is included with Ad-Sense and is designed to help you get started quickly and easily.
• WordPress Theme Files— Also included are the necessary WordPress theme files, which we will be using for most of the remainder of this document, as a ZIP file that may be extracted as a folder.

Step 1: Upload and Activation

Video Tutorial:

http://community.mythemeshop.com/tutorials/article/5-how-to-install-a-mythemeshop-wordpress-theme/

For installing the Ad-Sense theme in WordPress, you have two options. You may either upload the theme ZIP file using the WordPress theme installer (Recommended), or you can upload the unzipped theme folder via FTP (Advanced).

Method 1: Install Using the WordPress Theme Installer

1. Log into your WordPress site and open the admin dashboard.
2. Navigate to the 'Appearance' tab.
3. Choose the 'Themes' tab.
4. Click 'Upload Theme'
5. Select 'ad-sense.zip' downloaded from your member's area, and click Install Now.
6. Wait for it to complete, click Activate once the upload has finished and you're ready for the next steps.

Method 2: Upload and Install Using File Transfer Protocol (FTP)

1. Extract the 'ad-sense.zip' file into a folder within the extracted folder on your computer.
2. Either using your FTP client or via your site's FTP panel, upload the extracted folder 'ad-sense' to your /wp-content/themes/ directory.
3. Wait for the upload to complete.
4. Now, we're ready to activate Ad-Sense. Back in your WordPress admin panel (yoursite.com/wp-admin/), navigate to Appearance → Themes → Manage Themes. Next, under "Available Themes", click "Activate" for Ad-Sense.

Importing Pre-defined Layouts:

Video Tutorial

http://community.mythemeshop.com/tutorials/article/22-how-to-import-your-mythemeshop-theme-options-settings/

Importing The Demo Settings, Widgets and Content

We want to make it easy for you to make your website look like the demo. So, we have incorporated a one-click-import solution in the Ad-Sense theme.

The way you use it is very simple.

1. Log into your site as an administrator.
2. Make sure you activated your new theme before proceeding.
3. Go to Appearance → Theme Options → Import Export tab in the bottom left
4. Choose a style and proceed with any of the options provided.
5. Enjoy!

Note: If you already have content and custom widgets, we strongly recommend not to use the Widget and Content Import options.

Step 2: Plugin Installation

Video Tutorial:

http://community.mythemeshop.com/tutorials/article/6-how-to-install-a-wordpress-plugin/

Ad-Sense includes nearly everything you'll need already, but there are some plugins that will make life easier and enable additional functionality that we recommend you install now.

To install a plugin, in your WordPress admin panel (yoursite.com/wp-admin/), navigate to Plugins → Add New. You may search for the name of the plugin you wish to install (names of recommended plugins listed below), which will return a list of potential plugins. Click either "Details" to read more about a plugin if you are unsure, or click "Install Now" if you wish to install the plugin. It may ask if you are sure, and you may proceed, at which point the installation with commence. You must then click "Activate Plugin" to make it available for use.

Recommended Plugins:

• MyThemeShop Connect— With this plugin you can install theme updates directly form your WP Dashboard.
• OTF Regenerate Thumbnails— If you have existing content, this will help you update your image thumbnails sizes.

Step 3: Thumbnail size

If you already have had content on your site, you will want to regenerate thumbnails. Using the recommended "OTF Regenerate Thumbnails" plugin above, you can use the plugin to automatically do it for you.

Navigation Setup

http://community.mythemeshop.com/tutorials/article/13-how-to-create-wordpress-theme-navigation-menu/

WordPress uses easy-to-configure navigation menus that you can set up and control the location of. To get started, navigate to Appearance → Menus in your WordPress admin dashboard.

1. Create a name for your menu.
2. Using the options on the sidebar for pages, categories, etc, check and click "Add to Menu" for the desired navigation items.
3. Drag to reorder and structure your menu in the "Menu Structure" panel.
4. Check the box for "Primary Menu" under "Theme locations".
5. Click "Save Menu" when done.

Menu Locations

Ad-Sense has 2 menus, the Primary menu, which is located at the top of the theme underneath the logo. You must ensure that the checkbox for "Primary Menu" is set for your navigation menu. Mobile menu will appear only when mobile devices are detected.

Theme Options Panel

The Theme Options Panel

Once you have activated the theme, you will see a welcome message, which will show you how to use the theme options panel. The theme options panel will allow you to configure the settings of your theme.

You will find all the instructions for each setting inside the MyThemeShop options panel. Now, have fun configuring your brand new theme, and explore the various options to make your site truly customized.

To access the Theme Options panel, navigate to Appearance→ Theme Options.

Warning: Clicking the ' Reset to Defaults' button will replace your current settings with the default ones. It is advised that you use the Import / Export feature to create a backup before resetting any options.

Import / Export Options for Backup & Restore

Video Tutorial:

http://community.mythemeshop.com/tutorials/article/22-how-to-import-your-mythemeshop-theme-options-settings/

It is highly advised to create backups of your options once you have the theme configured how you want it. It's easy to create a backup.

1. First, navigate to Appearance → Theme Options → Import / Export.
2. Next, to create a backup, click the "Copy" button under Export Options.
3. Copy the text from the text box, save it in a text file on your computer and keep it safe.
4. To restore from backup, click the "Import Code" button, paste in the code that was saved, and click the "Import" button. This will overwrite all existing settings, so use caution and create another backup before proceeding.

Transferring Theme Options

You can also use the backup created above to transfer to another site that is using this theme. You can copy the core for your settings, and duplicate it to another site, which is useful if you have a network of blogs that all need the same settings.

Ad Managment

Managing ads is an important part of Ad-Sense theme. We are really proud to offer some of the industry leading options with this theme that you can use to gently remind ad block users to whitelist your website. This way, you earn more revenue from same number of visitors your website is getting right now.

Detect Ad Blocker

If user is using any ad blocker extension, then this option will hide your content and will ask the user to white-list your website. You can choose to enable or disable it here:

Appearance → Theme Options → Ad Management.

Choose Ad Blocker Notice Type

There are various options you can choose from when an ad blocker is detected by the theme. You can choose to hide your entire content, show a popup, show a floating notice, or just show a snippet of text using shortcodes.

Notice Customization Options

You can easily change what the ad block detection notice says. Change the title of the notice and its desciption here.

Other Ad Management Options

You can make the background area clickable if you want to show ads there. You can also add an advertisement in the header, the navigation, below the title or below the content area. All these options are available at Appearance → Theme Options → Ad Management. Give it a go and find a combination that works best for your website.

Setting Up Pages

Create a New Page

All pages in the demo are built using a combination of shortcodes and a page template. Take the following steps to create new pages for your site.

1. Navigate to Pages→ Add New.
2. In the Page Attributes section, select one of the Templates from the list (see list of available templates below).
3. Start adding content in the text editor, or use shortcodes to format your pages, which we'll discuss now.

Available Page Templates:

• Default Template— The default template is used to create most of the pages, except homepages, and features a sidebar.
• Contact Page Template— This page template shows the contact form.

Shortcodes

Using Shortcodes

Video Tutorial:

http://community.mythemeshop.com/tutorials/article/11-complete-guide-on-how-to-use-the-mythemeshops-wp-shortcode-plugin/

Your theme comes pre-packaged with a plugin named WP Shortcode by MyThemeShop, allowing you to add styled content to your site with little effort. For your convenience, the available Shortcodes have been included in a one-click menu. Once your install the theme, you will see notification Shortcode plugin installation.

On our demo site, you can find examples of all shortcodes. When creating a page or post, choose the Visual Editor, and click the green "+" icon to reveal the list of shortcodes. Choose the functionality you wish to include, and click "insert". This will insert the necessary code for you.

Shortcode Demo

Adding Icons to Shortcode Buttons

Video Tutorial:

http://community.mythemeshop.com/tutorials/article/29-how-to-add-icons-to-your-shortcode-buttons/

When adding a shortcode button using our shortcode interface in the post editor, it will look like this:

[button-brown url="#" target="_self" position="left"] Brown Button [/button-brown]

To add icons on the button, just add this code before the button Shortcode:

<i class="icon-remove"></i>

The final result will look similar to this:

[button-brown url="#" target="_self" position="left"]<i class="icon-remove"></i> Brown Button [/button-brown]

You can find all available icon names here: http://demo.mythemeshop.com/Ad-Sense/icons/ Note: You must edit above code in HTML view of editor, not the visual interface.

Reference Examples: http://demo.mythemeshop.com/Ad-Sense/shortcodes/

Sidebars & Widget Areas

MyThemeShop offers powerful custom widgets to help you easily add features and functionality to your WordPress theme without having to tinker with any code. Each widget is listed on the widgets page with a description for your convenience. You can enable Footer widget area from Options Panel

Adding Widgets:

Video Tutorial:

http://community.mythemeshop.com/tutorials/article/10-how-to-add-widgets-in-a-wordpress-theme/

First, decide what widget you are looking to add, and where you want it to appear on your site. There is one sidebar placement available:

• Sidebar: Appears in blog page, single posts and page sidebar.

To add the custom widget in your theme, navigate to Appearance → Widgets, and drag the desired widget to the right side for the desired widget space. There is a description of each included widget that you can choose from.

Translating Your Theme

Video Tutorial:

Download & Install our latest plugin My WP Translate for translating your theme:

MyThemeShop offers Exclusive Translation plugin, so you don't need to edit .po file directly, you can easily have your themes translated into additional languages. To translate your theme, follow the instructions in the video embedded above.

Tip: You can use translation option even if you just want to replace any word in english.