Documentation version 1.6


Introduction


Thank you for purchasing my theme. If you have any questions about customization of this theme please visit our Support System or contact me directly via e-mail form on my profile page. I will be happy to help you.

Theme Installation #back to top

Installation

Extract the zipped package downloaded from ThemeForest to your desktop. In the extracted package you will find setwood.zip which is the WordPress theme file.

You can install the theme in two ways: through WordPress or via FTP.

Install via WordPress

  1. In the WordPress dashboard, navigate to Appearance > Themes.
  2. Click "Add New" button.
  3. Click "Upload Theme" button.
  4. Select the "setwood.zip" file.
  5. Click "Install Now" button.
  6. Click the "Activate" link once the installation has finished and you're ready.

Install via FTP

  1. Log into your web server with FTP client software.
  2. Extract the Setwood.zip file and upload the extracted folder to the /wp-content/themes/ folder on your server.
  3. Activate the newly installed theme by going to Appearance > Themes and clicking the Activate button.

The homepage for Setwood is easy to setup since the theme uses the default recent blog posts by default. Go to Settings > Reading to make sure that default option is set.

Please Use Child Theme After Install. So future updates will not overwrite your changes

Plugins Installation #back to top

When your theme has been activated, there is a notification advising you to install recommended plugins. In order to make the theme look exactly as the demo page, you need to install recommended plugins. Click on Begin installing plugins link.

After the installation you will get a notification informing that plugins were installed successfully. After you have installed all the plugins, click on "Return to Required Plugins Installer" link at the bottom and follow the same steps yet select "Activate" from the drop-down menu. This process may take a while on some hosts, so please be patient.

Importing the Demo Content#back to top

The easiest way to get started and find your way around using this theme, is by installing it into a fresh WordPress installation, and importing our sample content. To import the demo content correctly, you must have installed and activated Setwood theme. All plugins prompted you after theme activation, must have installed as well.

WARNING: As this will create posts, pages, custom post types, categories, widgets, etc. and change various system settings, it is strongly advised that you do this on a clean WordPress installation, without any previous and/or precious data. Under no circumstances we can be held responsible for total or partial data loss, so please be careful.

This theme supports one-click demo import. You can import the settings and setup for any of the 6 demos available for this theme.

Let's get started:

  • Navigate to Appearance > Import Demo Data. and click the "Import Demo Data" button

After the import you may uninstall One Click Demo Import plugin.

In the Tools tab of your WordPress admin sidebar, select the Appearance > Menus and create a new menu, then add pages to it and assign Theme Locations. Setwood Theme supports three different theme locations for wordpress menus: Primary Menu, Secondary Menu, Handheld Menu. Primary Menu will appear near the logo and it supports multiple sub menus, we may you can add as much as you want. Secondary Menu will appear in the top bar (very top of the page). Handheld Menu is optional menu, if we want to set a menu exclusive for mobile we can use this location.

To create the primary menu, in the WordPress dashboard, navigate to Appearance > Menus and perform the following steps:

  1. Enter menu name into the correct field.
  2. Click "Create Menu" button.
  3. Check the "Primary Menu" check box.
  4. Click "Save Menu" button.
In order to create the secondary menu, click on "create a new menu" link and follow the same steps yet check "Secondary Menu" checkbox. More can be found in WordPress Codex.

Live Customize Options#back to top

To get into the customize options go to Appearance > Customize. Setwood theme comes with dozens of options so you can customize the theme to your needs! Most of your theme options can be found in the live WordPress theme customizer. 

General Settings #back to top

In the Tools tab of your WordPress admin sidebar click Appearance > Customize and then open panel General Settings. Here are the list of options

Site Identity

  • 1. Type your Site title and Tagline.
  • 2. Upload your custom website Logo. For Retina Ready Displays, please upload a double size logo. Logo Mini Size is used for sticky header. The ideal size for logo would be 202px 96px, 190px 24px for the sticky header.
  • 3. Upload your Site icon, which would be used as a browser and app icon for your site. The Site Icon is used as a browser and app icon for your site. Icons must be square, and at least 512 pixels wide and tall.

Header

Here we can select header layouts and we have the builtin wordpress option to set site custom header image also we can enable/disable the sticky header if needed.

Background Image

Here we have the builtin wordpress option to set site background image.

Featured Image

Setwood has the option to set default featured image, Upload an image to display it for posts which don't have featured image set.

Footer

Customize Footer Text and Footer Social Links display on/off

Layout Settings #back to top

Go to Appearance > Customize > in your WordPress admin dashboard and the open panel Layout Settings. Here we can find list of options to control post/page sidebar position, meta data display and ordering for each layouts, Content limit settings e.t.c. And most of the options can be enabled/disabled.

Featured Slider #back to top

To set up the featured homepage slider you need to do the following:

Go to Appearance > Customize > Featured Content Options > Click enable "Display Featured Content" and select your preferred layout from the 'Select Featured content style' drop down.

In "Featured Content Options" you can see other options

Note with Featured Posts Slider: It's important that the posts appearing in your slider have a featured image assigned to them, and you need always use images for slider with at least 1170px width & 650px height

IMPORTANT NOTE: For "Full Width" slider: You should use images for slider with at least1920px width & 600px height to get best result.

Change the Featured Tag

By default, Setwood displays any post in the slider with the tag "Featured" attached to it.

You can edit this tag in the Theme Customizer. To edited the tag, go to Appearance > Customizer. Under the Featured Content section, change the name of the tag.

The featured post is not displayed in latest blog post listing on homepage, Check on "Display featured posts in latest blog post listing." to enable display.

The Don't display this tag on the front end checkbox lets you determine whether you want the Featured tag to appear in tag clouds on the front end.

Post Thumbnails / Feaured Image#back to top

To add a featured image in a WordPress post, simply click on "Set Featured Image" link inside the featured image meta box in the post edit screen. This will open the WordPress Media Uploader. You can use that to upload an image from your computer or use an existing image from your media library. Once you select the image, simply click on Set Featured Image button.

To get the best results, set featured image with minimum width 1170px and minimum height 650px. If you want to use Full Width Featured Slider, you need to set featured image with minimum width 1920px and minimum height 650px.

If your site has already had posts, you must use the plugin Force Regenerate Thumbnails to generate necessary thumbnails for Setwood theme.

Force Regenerate Thumbnails allows you to delete all old images size and REALLY regenerate the thumbnails for your image attachments.

Adding a Blog Post #back to top

To add new posts to your blog, go to Posts > Add New and follow the steps below.
  1. Give a title to your post,
  2. Place your text in the content editor,
  3. Upload a featured image by clicking "Set featured image" on the Featured Image panel,
  4. Add a category to the post, and tags if you so desire, from the respective panels

Important Note: In order to get the best result, you should choose featured images for your posts with minimum width is 1170px and minimum height is 650px. If you want to use Full width Slider, you need to use featured images with minimum width is 1920px and minimum height is 650px.

Setwood has the possibility to create 5 different types of posts: standard, gallery, video, audio and quote.

Standard Post

A standard post is the default post type. You can add text and images to your post using the tools and content box.

Gallery Post

A gallery post allows you to create a slideshow-type gallery or gallery grid at the top of your post. Once selected, the Gallery post format will use the first gallery that you added to your post. Galleries can be added to your post using the WordPress Media Editor. Simply click the "Add Media" button to create a gallery and add it to your post. By default the gallery grid will shown, to change it to a slideshow set the gallery to one column grid.

Video Post

Selecting the Video post format will display a video at the top of your post. You can share videos from nearly all video hosting sites, such as Vimeo or Youtube. After you have selected the "Video" post format from within the Format options box, the next thing you need to do is add a video to your post. The theme will automatically use the first video in your post as your format video. To add a video to your post, simply copy   paste the video's URL, oembed code, or embed code within the post editor, or use the "Add Media " button to upload and embed your own video file.

Audio Post

An audio post allows you to share a music or audio track and displays it at the top of the post. Like the video post, simply copy   paste the track's URL, oembed code, or embed code within the post editor. When you preview or publish the post, the audio player will play the first audio file that you embed into your post.

Quote Post

A quote post used for quotations, specially when you wants to just share a quote which is not within a standard post. You can add text to your post using the tools and content box. Block quotes can be added easily from within the post editor. Simply highlight your text, and then press the blockquote button to turn it into a quote.

Adding Author Bio#back to top

Setwood includes the option to add an author bio that will appear at the end of your blog posts. To set up this feature, log into your WordPress admin and click on your username in the top right-hand corner of the screen (or if you have the bar disabled, you can navigate to Users > Your Profile instead).

Scroll down to Contact Info section and add your social media urls.

Then scroll down to the About Yourself section and add your author bio in the Biographical Info text area. Click save

The bio you added will now show up automatically on all of your blog posts (along with your WordPress Gravatar that is linked to your user email address).

Creating a Page #back to top

To create a new page, in the WordPress dashboard, navigate to Pages > Add New. Enter page title and add your content. Also, if you need featured image, don't forget assign it.

Setwood Theme supports 3 layouts: No Sidebar Full Width, with Left Sidebar and with Right Sidebar. Default layout settings for all posts/pages is controlled from the Theme Customizer Options Panel.

Creating a Contact Me Page

For contact page "Contact Form 7" plugin is recommended make sure it is installed and activated.

Create the Contact Form

  1. In the WordPress dashboard, navigate to Contact > Add New.
  2. Click "Add New" to display the contact form in English, otherwise, select your desired language.
  3. Setup your contact form. Detailed documentation here.
  4. Once finished setting up your form, click the "Save" button.
  5. Copy code snippet (short code) highlighted in blue, as we will then paste it into a WordPress page.

When you create your form you can use the column shortcode to display like in theme demo

Your Name (required)
[text* your-name]

Your Email (required)
[email* your-email]

Subject
[text your-subject]

Your Message
[textarea your-message]

[submit "Send"]

Create the Page

  1. Create a new "Contact Me" page.
  2. Paste the generated code snippet (short code), into the text box on the create/edit page screen.
  3. Click on "Update" if page has been edited or "Publish" button, to have it appear on your site.

Widgets #back to top

WordPress Widgets add content and features to your Sidebars and Footer. Examples are the default widgets that come with WordPress; for example post categories, tag clouds, navigation, search, etc. Widgets require no code experience or expertise. They can be added, removed, and rearranged on the WordPress. Go to Appearance > Widgets to manage widget options for sidebars, footer, instagram section. Setwood comes with 6 useful custom widgets.

  • Setwood : About Me Widget - Add and customize your "About Me" information.
  • Setwood : Social Icons - This widget displays your site's social icons.
  • Setwood : Banner Advertisement - Add your Advertisement here.
  • Setwood : Facebook Page Box - Displays a nice facebook page box
  • Setwood : Posts - Display posts with thumbnail
  • Setwood : Featured Block - Displays Promo Box below homepage slider

MailChimp for WordPress

MailChimp for WordPress helps you add more subscribers to your MailChimp lists using various methods. You can create good looking opt-in forms or integrate with any other form on your site, like your comment, contact or checkout form.

Configuring Sign-Up Form(s)

  1. Go to MailChimp for WP > Forms
  2. Select at least one MailChimp list to subscribe people to.
  3. (Optional) Add more fields to your form using the add MailChimp field dropdown.
  4. Embed a sign-up form in pages or posts by using the [mc4wp_form] shortcode.
  5. Show a sign-up form in your widget areas using the "MailChimp Sign-Up Form" widget.
WordPress.org Plugin Page

Recent Tweets

  1. Go to your Widgets menu, add * Recent Tweets widget to a widget area.
  2. Visit https://apps.twitter.com/ in a new tab, sign in with your account, click on Create a new application and create your own keys if you haven't already.
  3. Fill all your widget settings.
  4. Enjoy your new Twitter feed! :)

Trendng Post Below Homepage Slider #back to top

To display trending post drag and drop the Setwood:Posts to the Below Header widget area, and set the Widget style to Slider and set the order by number of views or number of comments

Footer Instagram #back to top

Make sure you have the 'WP Instagram Widget' plugin activated. This widget will display your latest instagram images on sidebar or footer widget area. WP Instagram widget is a no fuss WordPress widget to showcase your latest Instagram pics. It does not require you to provide your login details or sign in via oAuth. WordPress.org Plugin Page

Go to admin > Appearance > Widgets and drag, drop Instagram Slider widget to Footer Instagram Footer widget area. Config your Instagram widget with your Instagram username

Footer Widgets #back to top

From left to right there are 4 sequential footer widget areas called Footer 1, Footer 2, Footer 3, Footer 4, and the width is auto-adjusted based on how many you use. If you do not use a footer widget, nothing will be displayed. For Demo we used 3 widget areas.

Feature Block / Promo Box #back to top

To set up the feature block below the homepage slider drag and drop Setwood:Feature Block to the sequential featured widget areas called Featured 1, Featured 2, Featured 3, Featured 4 and the width is auto-adjusted based on how many you use.

Changing colors #back to top

Simply go to Appearance > Customize > Color Settings to make your color adjustments to fit your style.

Changing your fonts #back to top

Simply go to Appearance > Customize > Typography Settings to make your adjustments. The typography control is integrated with google web fonts and you can get instant preview of the font changes

Version History (Changelog) #back to top

All images used on live preview are creative commons licensed, downloaded from unsplash.com and pixabay.com and these are not included in the theme package.

Should you have any questions that are beyond the scope of this documentation Or you want a theme customization? Just write us through Support System or contact me directly via e-mail form on my profile page. I will be happy to help you.


Changelog

Version 2.0 – March, 2018
- Gutenberg Support
              - Social Media Icons Sorting Option
              - Minor Style Tweaks
              - Code Optimization
              
Version 1.6 – March, 2018
- Show/Hide Author, Date, Category in Featured Content.
              - Show/Hide Show/Hide Author, Date in Post Layouts.
              - Stick Sidebar Enable/ Disable Option
              - Minor Style Tweaks
              - Code Optimization
              
Version 1.5.3 – November 16, 2017
- "I Recommend This" plugin source set to GitHub.
              - Minor Style Tweaks
              
Version 1.5.2 – June 20, 2017
- New WooCommerce 3.0 gallery features support.
              
Version 1.5.1 – May 11, 2017
- Schema.org Structured Data Markup fix
              
Version 1.5 – March 08, 2017
- New Featured Grid Slider Style
              - Accent color in customizer issue fix
              - pagination fix for home page template template-home.php
              
Version 1.4.1 – January 13, 2017
- Added boxed layout
              - Menu default fix
              - Social icons to open new window fix
              - Removed jetpack logo support to avoid confusion
              - Search toggle style tweak
              
Version 1.4 – November 10, 2016
- Bug Fix - Safari browser compatibility fix/
              - Translation fix ( Next and Prev).
              - Search Results Improvement.
              
Version 1.3.1 – October 20, 2016
- Bug Fix - Social Icons alignment when changing Header layout.
              
Version 1.3 – September 5th, 2016
- 2 Header Layouts Addition
              
Version 1.2 – August 25th, 2016
- Post Limit Bug Fix
              - Below Header Widget Bug Fix
              
Version 1.1 – August 21st, 2016
- Minor CSS and JS Improvements
              - Customizer Color and Typography Controls Update
              
Version 1.0 – August 13th, 2016
- Initial Release