NOTICE: This Doc is old version, pleae click to visit the latest version Doc.

SEA WordPress Theme Documentation


Thank you for purchasing our theme. If you have any questions that are beyond the scope of this help file, please feel free to publish your question here.
Thanks so much!

To help us with theme FREE updates with new features, please take 1 min to leave stars rating for this theme on ThemeForest if you like it, we'll appreciate it:

  1. Please go to ThemeForest login and navigate to your account.
  2. Click Downloads link, and you will see your purchases list:

    Themeforest

  3. Click stars around our theme to leave stars rating:

  4. Thanks! This little thing will help us to release new theme updates!
  5. If you don't like something in our theme or have some problems, please contact us and we will fix your issue and will help you! We are always welcome for your advice on how to improve our theme.



Server Requirements
To use SEA we recommend your host supports:
Recommended PHP configuration limits

On a very few hosts, like GoDaddy, Hostgator and 1&1 basic plan, you may meet some issues such as white screen, demo import fails, empty page content and other similar issues are all related to low PHP configuration limits. The solution is to increase the PHP limits. You can do this on your own, or contact your web host and ask them to increase those limits to a minimum as follows:

max_execution_time = 120
memory_limit = 128M
post_max_size = 64M
upload_max_filesize = 64M
max_input_time = 60
max_input_vars = 1560
Learn more



Installation


To use a WordPress theme, you must have a working version of WordPress already installed. For information about installing the WordPress platform, please refer to the WordPress Codex here.

  1. Extract the package file
  2. After extract the main zip file, you'll see these folders and files:

    • sea-theme.zip - Sea theme installable file
    • documentation folder - help file
    • sea-child.zip - Child theme installable file
    • plugins folder - The plugins install file
    • log folder
    • language folder - pot/po/mo files
  3. Install the theme file
  4. Installing the theme can be done in 3 ways. You can upload the theme ZIP file using the built-in WordPress theme upload, or copy the files through an FTP client.

    • Using the Envato WordPress Toolkit plugin: Please refer to this post.
      Note: How to get the API Key of ThemeForest(new version)? Refer to this post.

    • Using WordPress Theme Upload:

      • Login to your WordPress admin.
      • In the "Appearance > Themes" menu click tab "Install Themes".
      • At the top of the page click "Upload", then click "Choose File".
      • Select the zipped theme file, "sea-theme.zip", and click "Install Now".
      • After installation, you will receive a success message confirming your new install.
      • Click "Activate".

      Tips:
      1. Be sure to extract the file "sea-theme.zip" from the ThemeForest download before uploading. Using the ThemeForest ZIP file directly will result in a "Missing Style Sheet" error.
      2. If “The link you followed has expired.” is shown when you upload the zip file. It may be caused by upload size limitation, please increase the PHP configuration:
      post_max_size = 64M
      upload_max_filesize = 64M


    • Using FTP:
      • Login to your FTP server and navigate to your WordPress themes directory.
      • Usually this would be "wp-content/themes".
      • Extract folder "sea-theme" from the zipped theme.
      • Copy the folder "sea-theme" to your themes directory.
      • After uploading the files, login to your WordPress admin.
      • In the "Appearance" menu click "Themes".
      • Click "Activate" for the theme "Sea".
  5. Install Plugins

    After activating the theme, you would notice the message box on the top of admin pages to ask you to install/activate some plugins, and you could use them for free or cancel the messages. Include BM Content Builder(must install), Permalinks Customizer, WP Google Maps, Loco Translate, SVG Support.

    plugins

    • Click Begin installing plugins in this message.
    • You could check all required plugins; they are optional. You could install/activate what you need:

      Plugins

    Note: Please install/activate the BM Content Builder before import demo data.
    Not all plugins are necessary. If you don't need maps, you will not install Google Maps.


  6. Import Demo Data
    • Install/activate the BM Content Builder and SVG Support plugin.
    • Go to Plugins > Installed plugins, Deactivate all other 3rd plugins.
    • Go to SEA Theme > Import Demo, select a demo(thumbnail), the "Import" will be activated, click it.

      choose the demo file

    Sometimes the imported content may be broken if import demo data for multiple times. For example, you have imported the demo Creative and imported the demo Blog again. If there is no useful content on your website, you could reset the WordPress database before the new importing. You could do it by WP Reset plugin. Please notice, it will REMOVE all content(posts/pages/uploaded images, etc) on website.

    For the license reason, some images and fonts are different from the live demo website. The font name of the demo site is Neue Plak, Sabon Next.

  7. Video Guide:

1. How does this theme work? (Brief)

  1. Global settings: in SEA Theme > Theme Options panel, you could set the whole website general settings, such as logo, header, main container, lightbox, and color, e.g.
    • To set header or footer layout, please go to SEA Theme > Theme Option > Header or Footer
    • To set social media, please go to SEA Theme > Theme Option > Social Networks, you could create the social media link and social share button(see different)
    • To set colours, please go to SEA Theme > Theme Option > Colors. You could also set font and color for an individual module built by BM Content Builder editor.
  2. Define the fonts. Click here.

  3. To create the main content:
    • To create a single project, please go to Portfolio > Add New. Please make sure that the BM Content Builder plugin is activated.
    • To create a page(like portfolio list, blog list, about), please go to Page > Add New, we strongly suggest you create the content by BM Content Builder.
    • To create a blog post, please go to Posts > Add New.

To set up the logo for your website, you need to:

  1. Go to the WordPress Admin Dashboard.
  2. Go to "SEA Theme > Theme Options" (on the left sidebar).
  3. Go to Theme Options > General Settings > Logo section, where you could upload a logo image or input logo text(learn more).


3. Frontpage

To set up the homepage, you need to create a page which you want to use it as homepage, after that, go to Settings > Reading, activate A static page (select below), choose the page of Front page: drop-down menu.

set frontpage


Before building your custom menu, you need to create your pages first, then navigate to Appearance > Menus, it is recommended to create your Menu from Pages or Links.

5. Theme Custom

On admin panel the left hand, click "SEA Theme > Theme Options", you will see Theme Options panel.

There are 5 tabs in Theme Options panel: General Settings, Header, Footer, Content, Social Networks and Colors.

General Settings
SEA Theme > Theme Options > General Settings SEA Theme > Theme Options > Header SEA Theme > Theme Options > Footer
Content
SEA Theme > Theme Options > Content
Social Networks
SEA Theme > Theme Options > Social Networks
Colors
SEA Theme > Theme Options > Colors
WooCommerce
SEA Theme > Theme Options > WooCommerce
If WooCommerce is intalled/activated, this tab will show.

To manage the fonts, please go to Fonts Management from the admin panel. Activate the BM Content Builder plugin if there is not the Fonts Management tab.

Fonts Management

You should define the fonts firstly, and there are four kinds of source: Google Fonts, Adobe Fonts, Uploaded Fonts, and System Fonts.

Fonts Management

Go to Fonts Management > Fonts Assignment to assign the font to the logo, menu, post/page, or other elements.

Fonts Management

If you want to set font for some elements what are not included in these tabs.
Please click "Custom" tab, enter the HTML selector of the element to set font settings:

Fonts Management custom selectors

Please separate multiple selectors by commas like .logo,.menu



Video Guide:

To create a new single portfolio(project), go to Portfolio > Add New from the admin panel(Please make sure that the BM Content Builder plugin is activated).

Portfolio/add new

Each Portfolio should be assigned one category at least. Please organize the Portfolios by category. For the "Grid" or "Masonry Grid" module in BM Content Builder, it would list the Portfolio(s) come from the category you have chosen.

Post/Category

You could set "Featured Image" for posts, the featured image could be shown in portfolio list("Grid" or "Masonry Grid" module):

Post in List/Featured Image

Templates:

Gallery Template

There are 3 templates: "No Template" "Gallery on Left" and "Gallery on Right":
The "No Template" is without any placeholder layout. It fits to work with BM Content Builder editor.
The "Gallery on Left/Right" is "Text column + Images column" layout, it looks like:

Gallery Template

If template set as "Gallery on Left" or "Gallery on Right", the options would be shown:



URL: The default slug is ux-portfolio. If you want to change it, please go to "SEA Theme > ux-portfolio" to change the slug name:

Portoflio Permalink

To create a new post, go to Posts > Add New from the admin panel. (refer to this article)

Post/add new

7 Post Formats

The theme provides 7 formats for your post; these formats would affect the layout of your post in list and content page. You need to pick up the format from the selector:

Post Formats

Go to Pages / Add New. You could build pages including homepage, works, about, and so on.

Page/add new

Please make some settings:

Page Settings

After install and activate the BM Content Builder plugin, you'll see the BM Content Builder button in Page/Post editing page:



Activate BM Content Builder

Press the button to pop up the interface of BM Content Builder.

BM Content Builder Main Interface

If there are existed content on BM Content Builder, there are several buttons on the top bar: Quit, Save, Add Module, Save Layouts as Template, Insert Template.

BM Content Builder Main Interface

Click the left-arrow icon to exit this editor.

Click the disk icon to save the current content.

Click the plus icon to add new modules.

Click "Insert Template", you could insert some layouts. There are templates including Home Page, Single Projects, About/contact, Blog, and Sections. The "User" tab is for your own.

Insert Template

Click "Save Layouts as Template", you could save the current layout as a new template. You would find the template in the "User" tab(Click "Insert Template" to find it). You could also save a Group layout to a new template, click to check.

Save Layouts as Template

There are 10 modules within the builder: Text, Button, Grid, Masonry Grid, Single Image, Button, Content Form, Embed, Social, Slider, and Group.

Mods

Add a new module, like Text. The pop-up panel would show.

Spacing

Click "Spacing", you could enter a number to setup the "Top Spacing(desktop/mobile)" and "Bottom Spacing(desktop/mobile)" for this module.

For the builder is a live model editor, you'll see the change that you have edited. Move the mouse cursor over the module. The toolbar would show.

Tools bar

The "Save"
Text

Add some text with the text module. You could set up the "Background color" and "Inner Wrap Width" for the module.

Text module

There is a 3rd party wysiwyg editor within the Text module. You could set up the "Font color/background color", "Font Size/Line height/letter spacing", "Container Height" and other options with the editor. If you set up the "Container Height" same as "Browser Height", the content in Text module would be vertical centering.

Font color / background color:
Editor

Font size:
Editor - Font size

The default font size unit is PX, you could use unit VW or VH in code mode, it would be more flexible. e.g.

<h1 ><span style="font-size: 11.5vw;" data-msize="52">More simple, <br>more powerful.</span></h1>

What are the viewport units?

Font size for mobile:
Editor - Font size

To add link for selected text:
Editor - Add Text Link

Click this button if you want the coding mode:
Code mode

The Text module support color, image and video background. You could create fullscreen wrap with color, image or video background with "Text" module. Please enter some simple text in editor(don't enter too much content). You could create mask text effect through:
Background: image > Effect: Mask

Image Mask Text

The text editor spports shortcode also, if you want to show a map, you could use the WP Google Maps plugin. Add the map through Maps > Maps, enter the shortcode like:
Code mode

Tips: If set as "Hosted video" , it is recommended to enter both mp4 and webm, that will support most browsers.

Single Image
To show one image, you could use the Single Image module.

Single Image module

The File Type supports normal image and SVG.

Image
It supports JPG, GIF, and PNG image formats.
  • Style: Shadow
    Single Image Shadow

    Vertical Offset of the shadow, a negative number means the box-shadow would be above the box, a positive number means the shadow would be below the box.

    Blur Radius of the shadow, if set to 0 the shadow would be sharp, the higher the number, the more blurred it would be, and the further out the shadow would extend. For instance, a shadow with 5px of horizontal offset that also has a 5px blur radius would be 10px of total shadow.

  • Fit Image Width to Container

    On: The image would always fill its container.

    Off: The image would display on the original size. If the image is bigger than its container, it will fill into its container. You could set the align value on its container. This option often set for some small image like icon.

    Single Image Fit Image Width

    Single Image SVG

  • You could enter a URL or enable Lightbox for the image clicked.

SVG
You could set Color, Width, Link URL for the SVG.

Single Image SVG

Masonry Grid
This module is used to make a masonry grid list.

Masonry Grid

  • Sources:
    • Media Library: to choose images from media library.
    • Portfolio: to show the portfolio posts(Portfolio of left admin bar);
    • Post: to show the posts;
    • WoCommerce Product: to show the product list, it needs to install and activate the WooCommerce plugin;

    When set up the source as Portfolio, Post, or WooCommerce Product, don't forget to Choose a Category. The single portfolio/post/product within this category would be shown. Each post should have a "Featured Image" for thumbnail.

    Pickup Category

  • Filter:
    If you want to show filter for the portfolio page, please enable the "Filter" option. Make sure there are sub-categories in the category of the portfolio list. The category structure looks like:

    category tree

    For the "Media library" source, you could set category for each image, but don't set parent category, it will list all categories of level 1 set on images.

    You can set category for each image in Media > Library also.

    Image Category

  • What Thumbnail Does:
    • Open The Portfolio Item: when you click one item, the gallery post page would be linked. If this item is a Link format post, the first URL set within link post would be linked.
    • Open Lightbox: when you click one item, the full size featured image will be opened in the Lightbox. If you enter embed video code into "Show Video" of a single portfolio or video format post, the video will be shown in the Lightbox instead of the featured image.
    • The "Open Custom URL" and "Nothing" are only for from "Media Library."

      Custom URL

  • Fit Image into Grid: The images are filled into the grid by default(the images will be cropped). If it is activated, the images will be fit within the grid, the size of the image will be limited in the grid.
  • Image Lazyload: If it is activated, the images will only be loaded when they are on the current screen. The page will be loaded faster.
Grid
The Grid module is most the same as the Masonry Grid.
It can be set the standard grid like:

Grid Module

It can be set as a masonry(waterfall style) list with following options:
  • Image Ratio: Auto
  • Grid List Type: Masonry Grid(Waterfall)
Grid Module

It looks like:

Grid Module

Use the Gird module to create a blog list
  • Resource: Post
  • Image Ratio: Auto
  • Grid List Type: Masonry Grid(Waterfall)
  • Item Style: Image + Text
Grid Module

Button
To show one or more buttons, you could use this module.
In the Button module, you could make multiple buttons and change their order by drag & drop.

Button Module

Click a "Pencil" icon to edit the button item:

Button Item

  • Button Width

    Button Width

    It is recommended to use "Padding on Left/Right" for it is fluid.
  • Button Border

    Button Border

  • Show Icon

    You could upload an SVG icon and set a width for it.

    Button with Icon

Contact Form
You could use this module to show a contact form:

Button Module

Tips:
1) If you can't receive the mail, please check your mailbox, maybe it is moved to the spam.
2) Try to use a SMTP WP plugin, like WP Mail SMTP.
Read more: How to set the WP Mail SMTP?
Embed

To enter a video to the page, you need to copy and paste the embed code of the video, an example with Vimeo video:

Embed Module

Supported video:

  • Vimeo
  • Youtube
  • other embeded videos from video sites

For Vimeo and Youtube video, you could directly copy/paste the link(url):

Videmo URL

Social Media
Social Media Module

To show social media, please add the module. It is Click-to-share to social media; it supports 9 kinds of social media. Social Media

Slider
Slider Module

  • Slider Style 1

    Slider Module



  • Slider Style 2

    Slider Module



  • Slider Style 3

    Slider Module



  • Enable link
    To open a URL when clicking a slider image, please active "Enable link".
    Please go to "Media Library" to enter the URL for the image:

    Slider Image URL



Group
The Group module is a special module which is similar to a container, other modules could be put into it.

Group Module

The tools icon color is blue.

Click this button, you could save the group (including the modules in it) as your own template.

Save the content of Group as Template.

  • Align
    Group Module Align

    The "Align on Vertical: Equal Spacing" would work when there are multiple rows of modules.

    Group Module Align

    The "Align on Horizontal: Equal Spacing" would work when there are multiple modules in one row.

  • Force Content to fit Fullwidth
    When a group is fullwidth, and this option is "On", it would work like the following image:

    Group Module Fullwidth

  • Disable Gap
    It looks like if activate this option:

    Group Module without Gap

  • Screen height
    You could set the percentage of screen height for the group. It would be if set it "50% of the Screen height":

    Group Module Screen height



    If the height of the module is more than 50% of the screen height, the group would be with modules height. The height option for mobile would only work on portrait mode.
  • Background
    There are background settings(color, image, and video) for The Group. You could create a fullscreen wrap by the options and 100% of the screen height, increase the width as fullwidth. It will be:

    Group Module Full Screen height

    Hosted Video: It needs to enter a video file URL(not 3rd embed code like Youtube). If you enable the "Enable Mix Blend Mode" option, it uses the CSS - mix-blend-mode: screen. If you want to create a text mask effect, please insert a Text module into this Group module. Please set white color for "Choose Color for Video" option. It is a new CSS feature; it doesn't work well on part of browsers.
  • Shadow and Radius
    Group Shadow

    There are shadow and radius(round corner) options. You could add one Image and Text module into a Group to create an icon box with these options. The shadow options are the same as Image shadow.
  • Change Universe Color when Scroll In
  • Auto Goto Top When Scroll In
    The group module will auto goto the top of browser viewport when it scrolls in.
  • Make Groups Contour on The Current Row
    Make Groups Contour on The Current Row

    If there are multiple Groups in one row, their height will be the same.


WooCommerce is now the most popular eCommerce plugin on the web. Please install and activate WooCommerce plugin to create your online shop.

Notice

The WooCommerce would automatically create a page named "Shop - Shop Page", it could not be edited by BM Content Builder and page options of SEA theme. It is the default page of WooCommerce. You could creat a new page to customize the layout for your shop page.

The WooCommerce default shop page

1. Translate

1.1 Basic strings

You can translate the basic strings in "SEA Theme > Theme Options > General Settings: Descriptions", there are 15 strings:

translate-basic-strings
1.2 PO/Mo file

For the strings not included theme options, you can translate the static strings to your language using Loco Translate WordPress plugin(check the DOC) or Poedit.
There are the two main POT files:

/themes/sea-theme/languages/sea-theme.pot 
/plugins/bm-builder/languages/bm-builder.pot


2. Website with Multi-language

It is recommended to use the popular WPML wp plugin if you want to make a multi-language site. There is the documentation of WPML.

2.1 Translate pages
  1. Created a new page(make sure under default language), activate builder editor, put in some modules, click publish.
  2. Check ‘Duplicate’ checkbox and click “Duplicate” (see the screenshot below) at the right sidebar. “Duplicate” button would be displayed after checking the checkbox. Click the pencil icon to translate the page.

    Translate the Content Builder Translate the Content Builder

  3. For a page created by BM Content builder. Please don’t translate the origin modules. You need to clone the modules what need to be translated also. Translate the cloned modules.
2.2 To translate the strings like copyright information, Comment title, and so on:
  1. Install the plugin WPML String Translation.
  2. Go to left navigation: WPML/String Translation.

    WPML/String translation

  3. Pickup "admin_texts_ux_theme_option" in selector "Select strings within domain". The strings will show.

    WPML/String translation



  4. Click “translations” of every string item, enter the target translated words, check on “Translation is complete" and save it.

    WPML/String translation



2.3 To set the language Switcher

There are two ways:

  1. To show the Switcher by menu. Go to WPML > Languages, click "+ Add a new language Switcher to a menu":

    WPML Switcher on Menu


    The options panel will popup:

    WPML Switcher on Menu


    Select a menu, set what's elements(language name, flag) shown, position, color. The Switcher could be shown in the selected menu. The "Dropdown" style doesn't support footer menu.

  2. To show the Switcher by footer element. Go to SEA Theme > Theme Options > Layout : choose the "WPML Switcher" for "Footer Elements", the Switcher(Flag) will be shown on footer:

    Language Switcher

  1. Javascript files
    1. Bootstrap v3.3.5 - js/bootstrap.js - Bootstrap framework js
    2. Modernizr 3.5.0 - js/modernizr-custom.js - Respond user's browser features
    3. Waypoints v4.0.1 - js/jquery.waypoints.min.js - Trigger something scrolling a anchor
    4. Isotope v3.0.4 - js/isotope.pkgd.min.js - Masonry layout plugin
    5. - js/packery-mode.pkgd.min.js - PACKAGED v2.0.0 - For Isotope packery layout
    6. - js/photoswipe.min.js - PhotoSwipe v4.1.2 - Lightbox plugin
    7. ImagesLoaded v4.1.2 - js/imagesloaded.pkgd.min.js - Judge images loaded or not
    8. OwlCarousel v2.2.1 - js/owl.carousel.min.js - Slider plugin
    9. LazyLoadXT v1.1.0 -/js/jquery.lazyloadxt.min.js - Image lazy load plugin
    10. VelocityJS v1.5.0 - js/velocity.min.js - Animation effect
    11. jPlayer v2.9.2 - js/jquery.jplayer.min.js - HTML5 media player plugin
    12. ie.js - js/ie.js - For IE browser
    13. custom.theme.js - js/custom.theme.js - Sea theme main js
  2. CSS files
    1. Bootstrap v3.3.5 - styles/bootstrap.css - Bootstrap framework
    2. OwlCarousel2 css - styles/owl.carousel.css - Slider plugin css
    3. photoswipe - styles/photoswipe.css, styles/skin/photoswipe - Lightbox plugin css
    4. style.css - style.css - theme main css
    5. style.css - rtl.css - theme RTL css




Once again, thank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please feel free to publish your question here.

Thanks,
SeaTheme