The Box documentation

Here you find The Box documentation to help you to install, setup and use this theme. The guide provides answers and solutions to common problems and issues.
  1. Installation ↑ top

    Installing your theme is easy! After downloading you should have a the-box-plus.zip file.

    – WordPress Method
    1. Go to Appearance » Themes in the WordPress Dashboard and click on the “Add New” button
    2. Click on the “Upload link”, select the zip file and click “Install Now”
    3. Activate the theme.

    – Ftp Method
    1. Log into your site via FTP
    2. Browse to your folder located at wp-content/themes
    3. Unzip the the-box-plus.zip folder and upload The Box Plus folder to your server
    4. Log In to WordPress and go to Appearance » Themes
    5. Find the theme and click to activate

  2. Automatic Update ↑ top

    If your theme is out of date, you will see a notice on your WordPress Dashboard. You’ll be able to update your theme using the traditional WordPress update tools.
    You will get update notifications only if you have an active Theme License. Here you find Theme License Faq.

  3. Manual Update ↑ top

    There are a few different ways to manually update your theme. We recommend using a child theme if you are going to customize your theme files, as this simplifies updating your parent theme.

    Download latest version

    Signin to our website and download the latest version of your theme.
    If you dont’t have an account, you can create a new one with the email that was used to purchase the theme.

    Upload the new version

    The easiest way to manually update your theme is to upload it via the WP dashboard.
    However, if you try to upload a new version of a theme that is already in your site’s themes directory, you will get a error.
    The reason is because you already have a theme folder on your server with the same name as the folder inside your ZIP file.
    You can do one of the following:

    1. Delete the theme on your server

    • Go to Appearance » Themes
    • Activate Twenty Fifteen (or another theme)
    • Delete the old theme (Make sure you make a backup just in case something goes wrong)
    • Upload new version via Appearance » Themes » Install Themes » Upload
    • Activate the new version

    If you have done any customizations to your theme files, these customizations will be lost if you use this method.

    2. Rename the folder (via FTP)

    • Login to your site via FTP or cPanel
    • Navigate to wp-content/themes/ and find your old theme
    • Rename your old theme something like “theme-old” (replacing “theme” with the name of your theme).
    • Upload your new theme folder

    The old and new versions of the theme will both appear in the themes interface, but you will be able to distinguish them by their folder names and version numbers.

  4. Menu ↑ top

    The Box supports two Menu Locations:

    1. Primary Menu
    2. Footer Menu

    By default, the Primary Menu will fallback to Pages.
    To add Navigation Menus in your site go to Appearance » Menus page in your WordPress admin and create or edit a new menu.

    Create a new menu

    1. Select “Create a new menu” at the top of the page
    2. Enter a name
    3. Click the “Create Menu” button
    4. Add links to the menu by using the options on the left sidebar

    Then at the bottom of the menu structure you will see the Menu Settings, where you can assign your menu to specific locations on your website.
    For more details of adding, deleting, and maintaining menus, please visit WordPress Menu User Guide.

  5. Add Post Thumbnails

    1. Create a new post or edit an existing one
    2. Scroll down a little to see if there is a meta box called “Featured Image” on the right hand side of the screen.
    3. Click on “Set Featured Image” link. This will open the WordPress Media Uploader.
    4. Upload an image from your computer or use an existing image from your media library.
  6. Colors

    Click on the Colors tab and adjust your site colors.
    We create our themes to provide basic color changing options for the links, buttons, highlights and background.
    We have tried to keep the options minimal to reduce the risk of a color disaster.

    General
    1. Background Color
    2. Site Title and Tagline Color
    3. Accent Color
    4. Text Color
    5. Social Icons Color
    Navbar
    1. Navbar Background
    Footer
    1. Footer background
  7. Header Image ↑ top

    For Custom Header image this theme uses WordPress Custom Header functionality.
    Go to Appearance » Header, upload header image using WordPress Media Uploader or select image which is already uploaded and click on the Publish button. Suggested size is 980 x 340 pixels.
    You can also set Custom Header Image from the Theme Customizer.

  8. Background Image ↑ top

    The Box supports Custom Background, a theme feature that provides for customization of the background color and image.
    Click on the Background Image tab to upload your custom Background Image.

  9. Theme Settings ↑ top

    This theme makes use of the WordPress Theme Customizer for all your theme options!

    To access the Customizer from the dashboard, simply go to Appearance » Customize

    In “Theme Settings” Panel you’ll find most of your theme options.

    Theme Customizer allows you to tweak theme’s settings and see a preview of those changes in real time.
    After making changes, click the “Save & Publish” button at the top of the Theme Customizer.

    • Click on the Theme Settings » Logo tab.
      Upload your logo by clicking on the Select Image button.
      After you upload the logo image, click on Save & Publish button to save the changes.

      Options:
      1. Logo Size and Position (Medium Left Aligned and Large Centered)
      2. Original Size
      3. Enable Tagline under the Logo (with this option you can display both Logo and Tagline)
    • Header

      Click on the Theme Settings » Header tab.

      Options:
      1. Show the Home icon in the Main Menu
      2. Sticky Menu
      3. Hide Header Image on Homepage (this option is useful when you have a Full Width Slider on Homepage)
      4. Custom Text: you can add custom text (for example company info) on the top of the header
    • Layout

      Click on the Theme Settings » Layout tab.

      The Box documentation Layout

      Layout Options:

      Layout Settings for Blog Index Page, Category, Tag, Search and Archive Pages.

      1. Right Sidebar
      2. Left Sidebar
      3. One Column
      4. Grid Two Columns
      5. Grid Three Columns
      Other Options:
      1. Layout Style (Full Width, Boxed)
      2. Post length (Excerpt, Full Content),
      3. Post Thumbnails Size (Thumbnail, Medium, Large).
      4. Display Post Thumbnails
    • Typography

      Click on the Theme Settings » Font tab.
      The Box Plus integrates the most popular Google Fonts.

      Options:
      1. Font Size (adjust Text font size and Title font size)
      2. Site Title Font
      3. Title Font
      4. Text Font
    • Post

      Click on the Theme Settings » Post tab.

      Here you find options to customizer Single Posts.

      Sidebar options
      1. Right Sidebar
      2. Left Sidebar
      3. Full width
      Other Options:
      1. Show Date
      2. Show Date in the circle
      3. Show Author
      4. Show Comments
      5. Enable Featured Image
      6. Enable Related Posts (If yoy have a lot of tags and categories this option colud make slow your site)
      7. Enable Breadcrumbs
    • Page

      Click on the Theme Settings » Page tab.

      Sidebar options
      1. Right Sidebar
      2. Left Sidebar
      Other Options:
      1. Enable Featured Image
      2. Enable Breadcrumbs
    • Slider

      Click on the Theme Settings » Slider tab.
      Check “Display Slider” to add the Posts Slider at the top of the Homepage.

      Options:
      1. Full Width Slider
      2. Filter by category

      To make the Slider work you need to add Post Thumbnails.
      How to add Post Thumbnails

    • Click on the Theme Settings » Featured Posts tab and check “Show Featured Posts” to add featured posts in the Homepage.
      You can select the category you want to display for it.

    • Click on the Theme Settings » Footer tab and edit Footer text.

    • Google Analytics

      Click on the Theme Settings » Google Analytics tab.
      Copy and Paste your Google Analytics code to start tracking your site.

    • Social Links

      Click on the Theme Settings » Social Links tab to add Social Links.
      This allows you to add an icon at the top of your site to link to your social profiles.
      The RSS Icon is default on. Check “Hide the RSS feed icon” to hide it

  10. Full width Page Template ↑ top

    To have a Full width Page and remove the Sidebar go to your Page editor.
    On the right side you’ll see a box named Page Attributes.
    Select “No-sidebar Page Template” and then update the page.

  11. Widgets ↑ top

    The Box Plus comes with different widget areas you can use to customize your site.

    Sidebar – Widget area on the right/left side of the web page.

    Footer – Widget area in the footer of your site. There are three widget columns that you can use to add widgets to the footer.

    To setup widgets, go to Apperance » Widgets and use the drag and drop interface to insert widgets into the desired widget areas.

    You can also click on a widget title from the list of available widget. WordPress will show you the list of sidebars where you can add this widget.
    Simply select the sidebar where you want to add the widget, and then click on Add widget button to add it.

    As an addition to the built-in WordPress widgets, The Box Plus also has 6 custom widgets:

    1. Banner Widget
    2. Image Widget
    3. Profile Widget
    4. Recent Posts Widget
    5. Social Links Widget
    6. Video Widget

    The Box documentation Widgets

    1: Banner Widget

    Use this Widget to add a Banner (300×250) to your Sidebar.

    2: Image Widget

    Image Widget allows you to show an image, with optional text and link.

    3: Profile Widget

    Profile Widget displays your profile: short bio, an image and Social Links.
    Options:

    1. Image size (Medium or Thumbnail)
    2. Link

    4: Recent Posts Widget

    Recent Posts Widget allows you to show your recent posts.
    Options:

    1. Filter by Category: select All Categories or filter posts by a category
    2. Number of posts to show
    3. Show excerpt: check this option to show post excerpt
    4. Show thumbnail: check this option to show thumbnail

    5: Social Links Widget

    Social Links Widget allows you to show social links with icons.

    6: Video Widget

    Video Widget allows you to show a video and a description. To embed a video enter its URL, for example:

    https://www.youtube.com/watch?v=GGOksApHzeo
  12. Translation ↑ top

    The Box comes with POT file included under the wp-content/themes/the-box/languages folder.
    (For The Box Plus Theme the slug is the-box-plus)

    Method 1:

    To translate a theme into your language, follow these steps:

    1. Log into WordPress Admin and install Loco Translate plugin:
      https://wordpress.org/plugins/loco-translate/
    2. Make sure the following folder exists on your site, and is writeable by the web server:
      wp-content/languages/themes
    3. In the WordPress Dashboard go to “Loco Translate » Themes” and find the Theme in the list
    4. Click on “New language” link
    5. Choose language and “System” location
    6. Add your translations and save

    If you have automatic updates enabled then the wp-content/languages folder probably exists already. The themes subfolder is there to protect your custom translations from automatic translation updates.
    Loco Translate also lets you save translations inside the theme’s own folder (“Author” location), but this is provided for theme developers only. Files inside the theme folder will get deleted by WordPress updates.

    Please visit Plugin Documentation.

    Method 2:

    1. Download and install the free application Poedit
    2. Open Poedit and click on File -> New catalog from POT file in the main menu and select the POT file in your theme’s languages folder.
    3. A properties box will open up where you must enter the language name you want to translate. ( the default for English it’s en_US ; for English (UK) it’s en_GB ; for French it’s fr_FR ; for German it’s de_DE.po)
      Each language and country has a specific code you will need to use when saving translation files.
      Languages list can be found here
    4. Save your new language file, a new .mo file should be created.
    5. Upload the generated .mo and .po files into your xmag/languages folder on your live site.
    6. Save a backup of these files somewhere safe. If you upgrade the theme from WordPress admin, the language files will have to be re-uploaded.

    How to configure your WordPress language
    Go to Settings -> General in the WordPress Dashboard and scroll to the bottom.
    You should see a dropdown list with the label “Site Language”. Select Site Language and save.
    Changing this will set a new default language for all site visitors.

  13. Child Themes ↑ top

    You can use it to edit and customize your own theme, without losing your customizations when you update the theme.

    About child themes: WordPress Child Themes