Samui - Gutenberg WordPress Theme for Magazine and Blog Theme

Amazing Fast and Simple. Easy to Use.

Theme support


  • created: 24 June 16
  • latest update: 4 February 19
  • version: 2.0
  • by: Park of Ideas

Thank you for purchasing our theme. If you have any questions that are beyond the scope of this Documentation, please feel free to contact our support team. Thanks so much!

Installing Theme and plugins

You can install this WordPress theme using two installation methods:

  1. Using WordPress Administration Panel
  2. Copying theme files via ftp

METHOD 1 (Normal)

Using samui.zip found in ZIP file you downloaded from ThemeForest.com you should perform the following steps:

  • Login to WP admin
  • Go to WP Dashboard → Appearance → Themes option and click on it to load new page
  • Select Install Theme tab at the top of the panel to load new page
  • Click on Upload Theme button at the top of the panel to load new page

  • Click on Browse button and locate samui.zip on your file system
  • Click on Install Now button
  • Once installation is complete click the button Install and Activate to install and activate required theme plugins
  • On the next step you will see theme's splash screen with 3 buttons.
  • If you need additional plugins (such as Instagram feed, or MailChimp subscription) to extend the functionality of the theme, click the Install plugins button. 
  • If you don't need additional plugins, click on the Import demo  button to import demo data your website.
  • After Importing Demo data you can customize theme, clicking on Customize button or go to WP Dashboard → Appearance→ Customize 

METHOD 2 (Using FTP)

Using samui directory found inside of samui.zip file located inside ZIP file you downloaded from ThemeForest.com you should perform the following steps:

  • Using FTP client you should login to server where your WordPress web site is hosted
  • Using FTP client you should navigate to /wp-content/themes/ directory under your WordPress web site’s root directory
  • Using FTP client upload samui directory to themes directory on remote server
  • Once installation is complete you can activate Samui theme here:  WP Dashboard → Appearance → Themes

Import Demo

After you click Import Demo button you should choose one of 4 demo to Import the content and theme options.
You can open Import Demo page from WP Dashboard → Appearance → Import Demo Content as well.

Click All data checkbox and Import attachments, after that click Import and wait several minutes while demo content importing.

Theme Customizing

After importing Demo Content go to WP Dashboard → Appearance → Customize and start customizing theme.

Colors

To customize how your website looks, including background color and accent color navigate to WP Customize Panel → Colors

  1. Choose Accent Color Preset or Choose it from the color palette
  2. Choose Background Color or use your own background color

Background Image

You can fill website background with image, navigate to WP Customize Panel → Background image and upload image and choose options you need.

  • Choose Image position and Image size
  • Click Repeat Background Image and Scroll with Page if you need this options

Logo and site identity

  • Navigate to WP Customize Panel → Site Identity and enter the Sitename and Tagline here.
  • Upload your logo (PNG, JPG, SVG) here as well.
  • Upload your favicon (Site Icon) as well. Site icon should be square and at least 512 x 512 pixels.

Fonts

Navigate to WP Customize Panel → Fonts and set fonts for titles of your website. 

General Theme Settings

  • Go to WP Customize Panel → General Theme Settings and choose Header type, Sidebar position, Post layout and design and some other options.

EEdit your navigation menu through the "Appearance → Menus" options.

Homepage

Navigate to WP Customize Panel → Homepage Settings and choose Your latest posts. Or you can change the homepage, just click A static page option and select the page to make it the Homepage of your website.

Front Page Builder

General settings

Go to WP Customize Panel → Front Page Builder.
Here you can switch on/off and drag&drop different front page blocks, such as Slider, Banners, Posts etc.

Slider

  • Here you can choose from 2 types of slider (fullwidth or Fixed Width).
  • Choose the style of slider - there is 5 options of the design.
  • Choose the height of slider and slides appearing effect (Fade or Slide).
  • Choose the number of slides and the category of the slide posts.
  • Set the Effect speed (default is 500) and Autoplay interval in ms
  • Check "Hide Slider Category" if you don't want to display slider category at the website.
  • Check "Add top margin" if you use this block not at the very top of the page.

An example of fullwidth slider with white info block at the center (you can also see this banner on our demo: https://parkofideas.com/samui/demo2)

Big Banner

  • Here you can set the title, subtitle and button text
  • Choose the text align
  • Enter the link
  • Upload the image for your banner
  • Set the image position and size
  • Check the box if you want Parallax effect on the banner
  • Set colors of text and button
  • Set background color
  • Check "Boxed view" if you don't want it fullwidth
  • Check "Add top margin" if you use this block not at the very top of the page.
  • Check "Add top and bottom padding" if you want bigger banner

An example of parallax slider (you can also see this banner on our demo: https://parkofideas.com/samui/demo2)

Instagram Feed

To add your Instagram feed you should enter your Instagram Access Token (link is provided). You can also choose the size of thumbnails and fullwidth or boxed view.

An example of instagram feed:

Two Top Posts

You can check "show post at the top of the home page" at the very bottom of post editing page in admin to show this post at the featured two top posts area.

An example of two top posts:

Category Posts

Use these blocks for listing of 4 blog posts of the category selected.

Blog Posts

Use these blocks for blog posts listing.

HTML block 1 and 2

Use these blocks for any HTML code you want.

Shortcode block 1 and 2

Use these blocks for any shortcodes from any WordPress plugins you use in your website. It can be the map or contact form or gallery or whatever you want.

Subscribe block

This block works with MaiChimp plugin. First you should link this plugin with your MailChimp account. After that put shortcode into the field. You can also set header, subheader and background color for this block.

An example of Subscribe block (you can also see this banner on our demo: https://parkofideas.com/samui/demo1)

Post/Page Settings

To create a new page, navigate to WP Dashboard → Pages → Add New
You can enter a page title and add content.
You have the option of choosing Full Width page layout via the drop-down menu on the right titled "Template"

Go to WP Customize Panel → Post/Page Settings and choose style of Page Title. Here You can also hide or show different elements of posts and pages.

To customize the footer please navigate to WP Customize Panel → Footer

  • Choose the design of your footer
  • Choose color theme (light or Dark)
  • Put the logo image for footer
  • Add contacts or another information to the text box
  • Add Copyright
  • Choose Text color and Background color for the footer

Widgets

Theme comes with 2 custom widgets

1. Custom About Me Widget
  1. Go to WP Customize Panel
  2. Click Widgets
  3. Click Sidebar
  4. Click + Add a Widget button
  5. Choose Custom About Me Widget
  6. Put title, About me Text, linking URL and Read More text
  7. Upload images for Avatar and sign
2. Custom Latest Posts Widget
  1. Go to WP Customize Panel
  2. Click Widgets
  3. Click Sidebar
  4. Click + Add a Widget button
  5. Choose Custom Latest Posts Widget
  6. Put title and choose category (or you can show posts from all categories)
  7. Enter the number of posts to show

Performance

Use this options to improve speed of your website.
Navigate to WP Customize Panel → Performance and check all 3 checkboxes.

Translation

Samui Theme is translation and multi-lingual ready.

You can translate Samui theme using two methods:

1. Loco translate Plugin

2. PO Edit application:

To translate the static strings, we recommend to download PO Edit application from http://www.poedit.net/. Once you have installed please follow the steps below:

  • Open the /samui/languages/ folder where you will find 2 files: samui-theme-functionality.pot and samui.pot.
  • Then you will need to open each .po file in PO Edit. Once opened, you will see all strings that needs to be translated. Type the translation of a string into the “Translation” column. Do not delete or edit “Original string” part.
  • You should not translate all strings in this files, you can just leave some strings as they are in the original language. Remember that strings that you have not translated will appear in English in your site.
  • When you finish translating, save the files. This will create an .po and .mo file in the same directory. Name of each file should consist language code (for example de_DE or ru_RU).
    Name of files should be like this:
    • samui-theme-functionality-de_DE.mo
    • samui-de_DE.mo
  • After that upload new files into the language folder of the theme /wp-content/themes/samui/languages/, or /wp-content/themes/samui-child/languages/ if you use child theme

Theme Updating

There are a couple of different ways to update Samui WordPress theme to the latest version:

Method 1: Install the WordPress Envato Market plugin

Once installed, activated, and setup, the Envato Market plugin will display a notice in your WordPress dashboard when an update is available.

  1. Install and activate the Envato Market plugin
  2. Navigate to the Envato Market menu, follow the instructions to generate a Global OAuth Personal Token, and enter the Token in your Envato Market plugin page
  3. You will see notifications on this page when a theme update is available

Method 2: Manually Install the Update

  • To manually install a new version of the theme:
  • Backup the current version of the theme.
  • Delete the old version and reinstall the latest version. You should have an FTP access for this.

Update History

Version 2.0 – February 4, 2019
1. Tweak: Added Front Page Builder
2. Tweak: Added new homepage blocks: html, shortcode, parallax banner, subscribe
3. Tweak: Theme design updated
4. Tweak: Added Gutenberg support
5. Tweak: Added WPML and GDPR support
6. Tweak: Added options to choose start time and duration for the video banners
7. Tweak 4 demo layouts for One-click-import

Version 1.0.7 – October 6, 2018
1. Tweak: Improved version of Envato Market plugin
2. Tweak: Improved One click Import 

Version 1.0.6 – September 1, 2017
1. Tweak: Theme now supports latest WordPress 4.8+ 

Version 1.0.5 – November 20, 2016
1. Tweak: Added plugin for theme updating
2. Tweak: Added new feature for uploading demo content
3. Tweak: Some minor improvements in Documentation

Version 1.0.4 – August 5, 2016
1. Tweak: Added added Instagram to footer

Version 1.0.3 – August 2, 2016
1. Tweak: Added Vimeo video support in slider
2. Tweak: Added Youtube short url support for video slider
3. Fix: some minor css fixes

Version 1.0.2 – June 28, 2016
1. Tweak: Added option to choose slider height (500px or 700px)
2. Tweak: Added two new styles of slider (without any texts above the image (or video) and without texts and link to post)

Version 1.0.1 – June 25, 2016
1. Tweak: Added social icons to header
2. Tweak: Clickable top banners on homepage
3. Tweak: Added video into slider