WELCOME TO OSHIN

This is one of the finest WordPress themes. Oshin is packed with a lot of powerful features. We have put together this documentation in the best possible way to explain these features and help you set up your website using Oshin. Let's get Started! 

Server Requirements


Server Requirements are very critical in order to seamlessly upload the theme and import the demo data. Below are the list of configuration parameters that should be verified before installing the theme. 

  • max_execution_time = 300 (900 if you are using GoDaddy) 
  • max_input_time = 120
  • memory_limit = 128M
  • post_max_size = 15M
  • upload_max_filesize = 15M
How can this be checked ? 
  1. You can check this in the php.ini file on your server and modify them as necessary. If you are not familiar with modifying this, you can reach out to your server hosting provider who should be able to configure this for you.
  2. You can install and activate a plugin called Host PHP Info. On activating the plugin, the PHP Info can be found by navigating to Tools > PHP Info. You can then reach out to your server hosting provider who should be able to configure/modify this if required.

Installing the theme


Installing the theme via WordPress

Step 1 – Download the theme package(All files and documentation) from Themeforest and extract it.
Step 2 – Login to your WordPress admin panel
Step 3 – Go to Appearances > Themes
Step 4 – Click on Upload Theme
Step 5 – Upload the theme file named oshine.zip. The Theme package that you downloaded from themeforest is the Master file that will include Theme File, Child Theme file, Documentation and Sample Content. You have to extract this and upload the just the file in it named oshine.zip.
Step 6 – Install and Activate the theme

Common Issues while uploading the theme

1.      Broken theme and/or stylesheets missing

While uploading the theme via WordPress, if you are getting an error that reads Broken theme and/or stylesheets missing, This error message does not mean that the theme you have purchased is broken, it simply means it has been uploaded incorrectly. Please ensure that you upload the correct file which is ‘oshine.zip’. This article from Envato explains about this common issue.

installarion-issue

2.    Are you sure you want to do this? – ERROR

While uploading the theme via WordPress, if the upload is unsuccessful with the error message Are you sure you want to do this? Try Again’ it is likely that file upload limit is less than the theme’s file size. Kindly increase your file upload limit to around 10 MB, alternatively upload the theme via FTP and install it.

are-you-sure

Installing the theme via FTP

Step 1 – Log into your Hosting server using FTP service like Filezilla
Step 2 – In the Theme’s buyers package, unzip the file called oshine.zip
Step 3 – Upload only the Extracted folder ‘oshine’  to  the folder
wp-content/themes/
Step 4 – To activate the theme, navigate to Appearances > Themes in your wordpress Dashboard
Step 5 – Click on ‘Activate’ button under the theme name

alternative-theme-upload

Installing Required Plugins


The theme is tightly coupled with a few plugins that are required for it to work best. Here is the list of the required Plugins that you have to install and activate prior to importing the demo content. Upon activating the theme, you will get the notification to install and activate these plugins

Mandatory Plugins
  1. BE Page Builder
  2. BE Portfolio Post
  3. BE One Click Import – This plugin which is used for One Click Import of demo data can be found in the folder named plugins in the Buyers package.
The other plugins that you might need are
  1. Master Slider – The theme comes with Master Slider included along with the theme package, which you can install and activate.
  2. Slider Revolution – The theme comes with Slider Revolution included along with the theme package, which you can install and activate.
  3. WooCommerce – This plugin is required if you need shop in your website.
  4. Contact Form 7 – The theme comes with a default Contact Form. Incase you need more options, the theme is compatible with this plugin called Contact Form 7.
  5. Sidekick – This plugin provides Walkthroughs with voice-over on topics about WordPress and the Theme. This tool will make Theme and WP usage absolutely easy for beginners and first-timers.

Importing Demo Data


As mentioned in the previous sections, you need to install & activate all the required plugins. Upon activation you are all set to import the demo content using the plugin.

Note –
  • If you have not installed the WooCommerce plugin prior to importing the demo content, you will get Error messages saying the Products and Shop related pages did not get imported. You can ignore these, if you do not require shop.
  • If you have not installed the BE Portfolio Post Plugin, you will get Error messages saying the Portfolio items did not get imported.
Step 1 – Install Required Plugins

Install Mandatory Plugins, if you have not done that yet!

Step 2 – Import Primary Content

Navigate to Appearances > Import Demo Data, and from the list Import Primary content. It is very important that you import the Primary content first, as all the common elements in the theme like the Portfolio, Blog Posts, Shortcode Pages are included only in the Primary data.

Step 3 – Import Individual Demo content

Once the Primary content, is imported successfully, you can go ahead and import the other versions as per your need – say Oshin v3. The unique pages that belong to that demo will be imported. Along with this the Options Panel data and Widgets of the respective version will also be imported. Now you will have the pages from both the Primary content and the Demo that you imported. You are just a couple  steps away from setting the site just like demo. You now have to Save the Menu and Setup Home and Blog Pages.

plugins

primary-content

Common Issues while Importing Demo Content

1.      500 Internal Server Error with blank page

This will occur when you do not have the sufficient server limits. Below is the basic server requirement for a WP theme.You can check this in the php.ini file and modify them as necessary. If you are not familiar with modifying this, you can reach out to your server hosting provider who should be able to configure this for you.

server-reqt

500-internal-server-error

2.      404 Page Not Found

Step 1 – You need to increase the Max Execution Time a bit more than what is mentioned above. Increase the limit to 900ms- max_execution_time = 900 . Try Importing the data again. 

Step2 – If you  still get the 400 Page Not Found error, you have to follow the steps here to import the content manually. Before importing, check if the Media files are all imported. On your dashboard, navigate to Media >Library . You will see around 60-70 images imported. If this is in place you can import the content now.

Step 3 – Navigate to Tools > Import   and Click on WordPress. You will be prompted to install the importer plugin if you do not have it yet. Choose the demo xml file from Sample Content > Theme Content > DemoName > content.xml  and click Import. Make sure you Uncheck the option ‘Import Media Files’.

Step 4 – Final step will  be to import the Options Setting.  Navigate to Appearances > Import Demo Data. Choose to import the ‘Options‘  setting of the Demo of your choice, and click on Import.

Set up Home and Blog Page


Step 1 – Create Blog Page
Navigate  to Pages > Add New. Give the page a name of your choice and PUBLISH the page.

blog

Step 2 – Assign Blog Page and Home Page
On your dashboard Navigate to Settings > Reading. Set up the Home Page under the ‘Front Page’ and Blog Page(The empty page that you created in Step -1) under ‘Posts Page’ drop down.

blog-home-page

Updating the theme


We will be updating the theme periodically with additional features and refinements. So it is vital that you know how to update the theme to stay current. 

Backing up Options Panel Data

Before you update the theme, it is recommended that you take a backup of the Options Panel settings. Log on to your site’s admin panel. On your Dashboard, navigate to Oshin Options  -> Import / Export  and then download (Export) the options panel settings. This backup is to ensure that you can restore your options & settings incase something goes wrong during the theme update process. We strongly recommend doing this, though it is not mandatory

Updating the Theme

OPTION 1
If the version of the theme you are having is Oshine 1.9 or higher, updating the theme is just a button click away.
Step 1 – Update your Purchase Code under Appearances > Oshin Purchase Code option. You can download the purchase code from your account in Themeforest under the Downloads tab, as shown in the image. This is required to validate your purchase and enable One Click Update.
Step 2 – On your dashboard navigate to Appearances > Themes. Click on Oshin Thumbnail and Update the Theme.

purchase-code

OPTION 2
If the version of the theme is lower than Oshine 1.9, you will not have the One Click Update feature. To update the theme manually, follow the steps below.
Step 1 – Download the latest version of the theme by logging on to your Themeforest account  and then navigating to the “Downloads” section.
Step 2 – Extract the theme package and unzip the ‘oshine.zip’ file. Connect to your server via FTP and navigate to /wp-content/themes folder of your wordpress installation, replace the existing folder named “oshin” with the unzipped folder.

Mega Menu


The steps below will explain how to create a Mega Menu in your site .
Navigate to Appearances > Menu and follow the steps below –

Step 1 –  On Right top corner of the screen you should be ‘Screen Options’, Enable ‘Css Classes’ in this list of options

Step 2 –  Open the Menu item, that needs to be configured as Mega Menu. And add the classes ‘mega‘ and (‘columns-2’ , ‘columns-3’ or ‘columns-4’)  in the Css Classes options, depending on the number of columns you need.

Step 3 – In addition to this, if you need the First Item in the Sub Menu Columns to be highlighted , you need to assign the class ‘highlight’ to the First Item in the sub menu in respective columns.

megamenu

submenu

Image Dimensions


Logo – Logo can be upto 250px wide.
Portfolio Thumbnail  – 650px wide
Portfolio Multi Grid Thumbnail – 1250px by 770px
Portfolio Carousel – 650px wide
Single Portfolio – Upload the max size of 1920px wide so that the images will look good in all screen sizes.
Blog – 1160px by 700px
Shop – On your Dashboard, navigate to WooCommerce > Settings > Products > Product Image Sizes and set up the size for thumbnail and Single Product Images. Note that after you alter the Image sizes, be sure to Regenerate the thumbnails (using Plugin) so that the images get re-cropped to the right dimension.