Introduction

Splash - Basketball, Sports WordPress Theme

A short guide and general information to help you get to know your new theme.

Above all, We would like to thank you for purchasing this theme, your contribution is very much appreciated.


This document covers the installation and use of this theme and reveals answers to common problems and issues - We encourage you to read this document thoroughly if you are experiencing any difficulties. If you have any questions that are beyond the scope of this document, feel free to pose them in the dedicated support forum.

Getting Started

Installation of the theme

Installation of the theme

To install this theme you must have a working version of WordPress already installed. For information regarding the installing of the WordPress platform, please see the WordPress Codex - http://codex.wordpress.org/Installing_WordPress

Installation

When you are ready to install a theme, you must first upload the theme files and then activate the theme itself. The theme files can be uploaded in two ways:
FTP Upload - Using your FTP client, upload the non-zipped theme folder into the /wp-content/themes/ folder on your server
WordPress Upload - Navigate to Appearance -> Add New Themes -> Upload. Go to browse, and select the zipped theme folder. Hit “Install Now” and the theme will be uploaded and installed.
Some webservers have a limitation for the maximum allowed size of files being uploaded to them and that value may be exceeded by the theme file. If that is the case you can receive an error that states: The uploaded file exceeds the upload_max_filesize directive in php.ini. or Are you sure you want to do this? Please try again. If you get any of these errors please increase the values of upload_max_filesize and post_max_size directives in your php.ini file to 20M or follow the Installation via FTP section described above.
Once the theme is uploaded, you need to activate it. Go to Appearance -> Themes and activate your chosen theme.
After that you need to activate the pre-installed plugins:
1. WPBakery Visual Composer
2. Woocommerce
3. SportsPress
4. STM Configurations
5. Breadcrumb NavXT
6. Revolution Slider
7. Contact Form 7
8. Instagram Feed
9. STM Importer
10. MailChimp for WordPress Lite
All the plugins which are not free come under our EXTENDED License, so you don’t need to pay for their license to use them. Some of them might have messages requiring activation, but they are already activated on our side. No purchase code needed. When using them under our license you will need to wait for the plugin updates in our regular theme updates. If you want to be able to auto update them from wp-admin, you will need to buy your own personal license for that.
Also you can update included plugins via upgrading the theme. We include latest versions of plugins in every update of the theme.
Here you can see video tutorial of Installation the theme:

Activate the theme and Import the demo content

Activate the theme and Import the demo content

After completing installation of the theme, you need to activate your product under Splash -> Product registration following these instructions:

1. Click on this Generate A Personal Token link. IMPORTANT: You must be logged into the same Themeforest account that purchased Motors. If you are logged in already, look in the top menu bar to ensure it is the right account. If you are not logged in, you will be directed to login then directed back to the Create A Token Page.

2. Enter a name for your token, then check the boxes for View Your Envato Account Username, Download Your Purchased Items, Verify Purchases You've Made and List Purchases You've Made from the permissions needed section. Check the box to agree to the terms and conditions, then click the Create Token button.

3. A new page will load with a token number in a box. Copy the token number then come back to this registration page and paste it into the field below and click the Submit button.

4. You will see a green check mark for success, or a failure message if something went wrong. If it failed, please make sure you followed the steps above correctly.
Then you can install included plugins under Splash -> Plugins (if you have not installed them).
After this you can choose and install the demo content under Splash -> Demo Import:
Please note: Most of images replaced with a placeholder image because of licensing. Also demo content doesn’t include WP options and widgets, so you need to create them manually via Appearance -> Widgets.

What if the Import fails or stalls?

If the import stalls and fails to respond after a few minutes You are suffering from PHP configuration limits that are set too low to complete the process. You should contact your hosting provider and ask them to increase those limits to a minimum as follows:
  • max_execution_time 600
  • memory_limit 128M
  • post_max_size 32M
  • upload_max_filesize 32M
You can verify your PHP configuration limits by installing a simple plugin found here: http://wordpress.org/extend/plugins/wordpress-php-info. And you can also check your PHP error logs to see the exact error being returned.

Setting up the Homepage

Setting up the Homepage

To set up the homepage you must create a new page, you can do so by navigating to Pages > Add New. The title for this page can be up to your liking. Under Settings -> Reading or Appearance -> Customize -> Site Settings -> Static Front Page please setup the new Homepage.
Actually you can set any page to be your homepage. Once it’s created you can compose your homepage layout. The design layout is created under Bootstrap framework which is split into 12 columns grid. Each widget has its own maximum and minimum widths, so depending on that you can work out the layout for each page.
As you can see the homepage just like any the page is now 100% constructible out of the modules we have in Visual Composer. The homepage can be created by any element in Visual Composer. To view the short manual on how to use the Visual Composer, please follow this link:
http://codecanyon.net/item/visual-composer-page-builder-for-wordpress/full_screen_preview/242431
The detailed documentation of Visual Composer can be found here also - http://vc.wpbakery.com/video-tutorials/

Theme Features

Theme Customization

Theme Customization

WordPress Customize allows you to setup the general styling of the website visually. In WordPress menu go to Appearance > Customize. Here you can setup most important options of your theme.
Site Settings:
  • Static Front Page: You can select default Front and Blog pages here.
  • Logo & Title: You can setup basic site options like: Site title, Tagline, Logo & its dimensions and Favicon.
  • Style: There are Color Skins and default Layout options. Here you can select one of one of the basic color schemas or set your custom colors, enable/disable Boxed version and show/hide Frontend Customizer.
  • Typography: Set up the fonts out of free google fonts. Besides this you can setup font weight, font size and line height also.
Header: Here you can setup all header section options.
Footer:
  • Main settings: You can set up Footer Call to Action section settings here.
  • Footer bottom: Here you can select displayable social icons, the copyright text and split the footer into widgets.
Blog: You can setup/change Title, Sidebars and Sidebar positions for post types.
  • Socials: You can add your company social URLs here.
    Menus: You can add/edit menus here
    Widgets: You can set up the widgets into the precreated areas. You can do the same later Appearance > Widgets.
    Custom CSS: Here you can add your custom styles.
    Also you can setup Custom Post Type Renaming Settings under Tools -> STM Post Type. After these changes it needs to RE-SAVE your site Permalinks.

    Footer area setup

    Footer area setup

    The footer is the same on all pages. You can see whole options via Appearance -> Customize -> Footer -> Main settings.
    Also you can set other areas up on the Widgets page (Appearance > Widgets) and choose from the suggested widgets. Please see the attached screenshot.
    PS: Please note the Demo Content doesn’t contain these widgets. So they need to be added manually.

    How to set up the sidebar

    How to set up the sidebar

    In this theme we paid special attention to Sidebars for your biggest convenience and on multiple previous requests.
    We have two types of sidebar: right sidebar and left sidebar, which can be selected for both of archive and single posts/pages.
    In addition to that, you can add/create a new sidebar with VC Widgets/Elements, in this case you will need to go here:
    Edit or create a new sidebar, and add any sections you need by means of Visual Composer
    For archive pages you can set sidebar options up via Appearance -> Customize -> Layout.
    For single pages/posts you can add sidebar via Widgetised Sidebar or STM Sidebar VC element

    Adding Images to Revolution slider

    Adding Images to Revolution slider

    You will need to upload various images to the Layer slider. You can add items from Revolution Slider plugin in the WordPress backend. When you go there first you need to create the new Slider, and add new slides.
    More detailed manual you can find here - http://www.themepunch.com/revslider-doc/slider-revolution-documentation/.

    Menus

    Menus

    There are two navigations on the site – Header menu and Footer menu, so you can adjust them under Appearance -> Menus
    This is standard Wordpress functionality, you can choose from the pages, post categories, or custom links.

    Localization

    Localization

    You can change your site main language via Settings -> General -> Site Language
    It’s easy to localize your site using Loco Translate plugin. Here you can see related tutorial - https://localise.biz/help/wordpress/translate-plugin/beginners.
    Another way is to add your translations via creating your own .po files. Before adding translations for static strings it needs to rename language files correctly according your site languages. Theme language files are located in a ../wp-content/themes/theme-folder/languages/ folder. You can find a list of language codes at WordPress in your Language. As an example, the language code for English is en_EN, so you would save the translated files as en_EN.po first, then en_EN.mo.
    There are several ways to fill up translations. One of them if using PoEdit platform. You can add translation via editing your .po file and at the end PoEdit generates .mo file for you. Then you needs to upload ready translation files to primordial folder (../wp-content/themes/theme-folder/languages/).

    Content

    Setting up Content Pages and Posts

    Setting up Content Pages and Posts

    All pages can be created as simple content pages or built by means of Visual Composer page builder. You will need to first set up the page and then add and set up content blocks. Just add a row and add the modules to row from the Visual Composer dashboard.
    Now you can choose how to compose your template. Add Content modules, Testimonials, etc. You have everything to realize your imagination.
    We have also included extension packages for Visual Composer. You can use them free.
    Just pick the module you like and add it to the row. Then you can edit it.
    You can also edit the row background, add video or parallax images to the background. Just click on Row edit icon and you will see the options & features, which are available for this row.
    Custom added shortcodes in our theme are on a separate tab:
    Besides this, each page contains these options which include header color or background image, title fonts and colors, breadcrumbs and button settings:

    SportsPress Features

    SportsPress Features

    There is a SportsPress plugin for Events, Matches, Team and Players - https://www.themeboy.com/sportspress/:
    Here you can find a tutorial related on SportsPress plugin - http://support.themeboy.com/category/327-getting-started

    Blog page

    Blog page

    TThe Blog page is a usual blog, formed from the posts which belong to categories created by you, which have tags and featured images that show in the post listings on the blog page. You can set a page as a Blog posts archive page via Appearance -> Customize -> Site Settings -> Static Front Page:
    The blog page can have the sidebar on the left, right or no sidebar, and the contents of the sidebar, as described above, are set under the Appearance -> Widgets. Other settings of this archive page you can setup via Appearance -> Customize -> Blog:
    Blogs can be posted by someone who has the access to the backend of the site with admin or author role. Anyway that person will be able to log into the WordPress panel and have a user profile.
    Default blog layout is grid layout and once you set up an empty page in the theme setting where it is said blog, it will show posts in grid layout.
    If you want to have List layout, you will need to create a page and set a template for it named Blog-list.

    Testimonials

    Testimonials

    In order that you could create testimonials in one place and then use all over the site, just inserting a VC element, we have created custom posts.
    Each testimonial is a simple post:

    Media Gallery

    Media Gallery

    You can add Media elements like a single post each of them under Media Gallery.
    Besides Title and Images you can set Gallery Format, Category(es), Description, Link or Embed code for each gallery post. Also it’s possible to set a post as a Featured. For displaying your Media Gallery you can use one of the extra VC Modules in any page.

    Donations

    Donations

    Donations are created as another custom post type called Testimonials. It has Categories that can be ordered as needed and All Donors list. Here you create just single donation.
    So basically, you create an individual post describing for each work in your Cases archive. After that you go to the Donations -> Add new.
    You can add an Image, Title and Category(es) for each Work post. Besides this you need to add Donation information under Information tab:
    You can set up Donation archive page settings and PayPal API credentials under Customize section .

    WooCommerce shop

    WooCommerce shop

    WooCommerce is the most popular e-commerce plugin for WordPress. Now you can have a shop with all e-commerce features on WordPress.
    Before you start adding products, please go through the WooCommerce plugin settings and specify everything you need for your shop:
    Adding the products: You can easily add new products via Products > Add Product
    Here you can find WooCommerce Documentation - https://docs.woothemes.com/documentation/plugins/woocommerce/getting-started/.

    Update the theme

    Update the theme

    There are 3 methods to update our wordpress themes to newer version. These new updates are essential if you want to have a bug free website as we give new features and improvements to the theme over time. Some of these updates might be needed in order to make the theme compatible with wordpress newer versions. There is no risk on losing your settings and pages. However if you have done modifications on core theme files, then they will be lost, so you should back up those files.
    After upgrading the theme, you can update extra plugins via Appearance -> Install Plugins.

    Update Through Wordpress Admin Panel (Envato Extension)

    It’s possible to update the theme easily via Dashboard -> Updates, after activating the theme - https://stylemixthemes.com/forums/topic/token-activation/.

    Update Through Wordpress Admin Panel (using extra plugin)

    • For this method you should first install Theme Upgrades Tool (http://wordpress.org/plugins/easy-theme-and-plugin-upgrades/)
    • Unzip the file you just downloaded from ThemeForest and locate the WordPress Theme.
    • Click on Appearance > Themes in your Dashboard. Still within the Themes section, on header tab, click on Add New, then on header second tab click Upload Theme.
    • Click Browse… and locate the new theme file.
    • In the Upgrade existing theme? Option choose Yes from the dropdown list.
    • Click Install Now and Activate the theme.

    Updating using a FTP software

    • Login into your Themeforest account and go to downloads (Dashboard > Downloads)
    • Download the theme into your computer
    • Install an FTP program (Filezilla is free) Retrieve your FTP login information from your hosting admin panel and login into your hosting via FTP
    • Unzip the item main file and locate theme archive file and unzip it. Make sure your unzipping software do not create extra directory with the same name nested into each other.
    • Drag and drop theme main folder into your FTP program with the destination : YOUR_HOSTING_ROOT/YOUR_SUBDIRECTORY/wp-content/themes/
    • FTP program will give a warning that there is an existing with the same directory name, choose replace all.
    Also, remember to clear your browser cache after each update if you notice anything off. Old theme files can persist in your local cache and make you think something's wrong.
    Again, thank you for purchasing this theme!
    If you have any questions that are beyond the scope of this document, feel free to pose them in the dedicated support forum at www.stylemixthemes.com