Installing WPLMS on an Existing WordPress site.

If you have an existing WordPress site. First and foremost ensure that the content that you built in the site is built using a theme independent page builder. Which means switching the theme to WPLMS

Prepare a backup

Even thought we are absolute certain that nothing can go wrong during while following this wizard, there are still contigencies which we can not tackle alone from the wizard itself. A network failure, server overload, traffic congestion are few examples why we should always prepare a backup of the site before migrating to WPLMS.

WPLMS is a BuddyPress theme and BuddyPress is the required plugin. If you need to sell courses you will be required to install WooCommerce. If you need Discussion forums in your site, you will need to install BBPress.

The Hosting recommendations posted by these plugins are the basis for WPLMS Hosting recommendations as well.

  • PHP Version 7.2.1 [tested upto version 7.4.8 as of 20th August 2020]

  • Mysql/MariaDb Version 5.6+/10.1+

  • Upload Limit 10 MB or more

  • PHP Memory Execution Limit 128 MB or more

  • PHP Time Limit 128 MB or more

  • PHP Post Max Size 128 MB or more

  • PHP Max Input Vars 128 MB or more

  • PHP extensions required dom,gmagick,SimpleXML,ssh2,xml, xmlreader,curl,date,exif,filter,ftp,gd,hash,iconv,imagick,json,libxml, openssl,pcre,posix,sockets,SPL,tokenizerz,lib,mbstring,mysqli.

The Upload limit is required for the theme even before you can begin uploading. Other wise you will see an error “The link you followed has expired.” while uploading the theme. Learn how to increase upload limit ›

As a principle we are not affiliated to any hosting company. So the recommendations posted here are unbiased and based on feedback we collected from our users.

Although any hosting plan should work for WPLMS. A VPS or above plan provides better compatibility and lesser issues in the long run. Sharing hosting with everything unlimited usually do not work out good because the server is shared among many entities. From our observation : WPEngine, HostGator, KnownHost, OVH, DigitalOcean and SiteGround are good hosting providers. This list by no means is an exhaustive list, you are free to try other options and if they work great you can help us in updating this list. Just send out an email here

Uploading the theme

Uploading the WPLMS theme is just like any other theme. Following are the steps you can follow to upload the theme.

Downloading the theme

Download the WPLMS WordPress theme from your Themeforest Account.Log in to your WordPress Admin [a.k.a WP Admin]

themeforest screenshot

Login to your WordPress administration panel. You can simply append wp-admin to your site's url. So if your site is ABC.com , ABC.com/wp-admin is your WP Admin area.Go to Apperance - Themes - Upload

wp screenshot

Locate the Apperance in the left menu. Click on it, locate the themes sub-menu item, click on it. Locate the Add new button on your screen.Upload the Theme

wp screenshot

Click on Upload Theme button. A Upload form will appear. Drag and drop the theme downloaded in the previous step here. Click on Install Button

wp screenshot

If you see the below error while uploading the theme, it most likely means that yoursame server is restricting the upload.

wp screenshot

The possible reasons for above are :

  1. Server Upload limit less than 8MB.

  2. PHP Zip library not installed

  3. File permissions incorrect.

  4. WordPress incorrectly configured.

  5. Previous attempt of uploading the theme failed due to network issues.

The best course of action in all above cases is to contact your web host. For the last step "previous failed attempt", you can login via FTP and locate for wp-content/themes/wplms folder and remove it.

Setup Wizard

On uploading and activating the theme, you will see a setup wizard automatically taking control of the things. This is expected and recommended method of installing the theme.

The Purpose of the setup wizard is to configure a lot of settings automatically and avoid the hassle of manually configuring the theme.

Selecting an Installation Type

We have categorised the WPLMS theme usage into 4 broad categories : Instructor, Academy, University and MOOC (massive open online courses ). We've Demonstrated the theme into above broad categories and selected a feature set for each of these categories. However, this is just a classification factor and during the course of setup wizard you are free to enable recommended feature, designs for the type of installation you are selecting in this step.

Even after the setup has been completed you can always re-run the setup wizard and enable disable features which you may need later on. For example : Enabling BigBlueButton Meetings in existing site.

themeforest screenshot

You will also see configuration checks and file permission checks which indicate any potential problem theat may arise during the setup wizard. Mouse over to see more details.

It is always better to make sure there is no failed configuration and file permission checks. However, sometimes failed check in configuration can also appear if the wordpres is unable to identify them.

Select a Demo Style

If you want to install a Theme Demonstration [Demo] then click on the image to select it. When a Demo installation is selected, you will see a check mark over it. To switch to another demo click on its image select it. To see how the demo works, click on the pop-out icon and you can go through the demos.

Chosing latest demos is always a good idea as they have better design and import wizard has been tested thorroughly for the demos.

You can skip this step from the bottom skip option to not install any content or demo style.

The images in this screen require an active internet connection, if you do not see images then please check your internet connection.

themeforest screenshot

Below the demos you will find import content section. This expects a upload file to use as a demo style. We will come back to this area in later sections.

If you have an existing WPLMS site or you are developing WPLMS site in your local computer. You can use the WPLMS Export wizard to take out the export zip from your site and import that zip file here.

Select Features for this Site

In this area you select features for your site. To select a feature click on it and a check mark would appear over it. Click on it again to remove the check mark. Some of the features will come pre-selected based on the demo style you've selected in previous step.

themeforest screenshot

Authenticate and setup updates

Authenticate your purchase by either authenticating from Envato account or by entering purchase code.

Authenticating with Envato account also sets up the theme for auto-updates. Otherwise you can authenticate again from WP admin - WPLMS - Getting started section.

This is also required to download the plugins in the next step. Hence you will not be able to skip this step and proceed to the next step in installation.

themeforest screenshot

Item Purchase code.

How to locate your item purchase code : Link

Installing Plugins

The theme comes with required and recommended set of plugins.Note that recommendations are good to have but not absolute necessity for the theme to work.

The required plugins for the theme to work as advertised are BuddyPress , WPLMS and VibeBP.

Based on your selection of previous "Features" step you will see the install plugins options here. Note that this is a sub-set of recommended plugins. Post installation you can view the complete set of recommended plugins from WP admi - Appearance - Install plugins section.

themeforest screenshot

You need an active internet connection to download these plugins. The plugins are hosted on Amazon servers and they are always available on the internet.

Ajax Error while installing plugins.

You may see some plugins returning status of ajax error. Such messages are safe to ignore as the plugin is trying to take you away from the installation wizard and we stop it from doing so.Failed Plugins.In case you see a failed error message, this means the plugin installation failed. It means the the rest of the setup process may face further issues. In such cases if the plugin is not a required plugin [BuddyPress, WPLMS & VibeBP] you can still proceed with the installation. If it is a required plugin then download the plugin manually and install it from the WP admin - Plugins add new screen.

In case you see failed error messages, you can follow these direct links for plugin downloads for required plugins :

  1. BuddyPress : Download link

  2. WPLMS : https://wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/wplms_plugin.zip

  3. VibeBP : https://wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/vibebp.zip

  4. Vibe-Helpdesk : https://wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/vibe-helpdesk.zip

  5. Vibe Drive : https://wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/vibedrive.zip

  6. Eventon : https://wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/eventON.zip

  7. Revolution Slider : https://wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/revslider.zip

  8. Layer Slider : https://wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/layersliderwp.zip

  9. Visual Composer : https://wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/js_composer.zip

  10. Vibe Zoom : https://wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/vibe-zoom.zip

  11. Vibe BigBlueButton : https://wplms.io/verify-purchase/?purchase_code=XXX&plugin=vibe-bbb.io/vibe-bbb.zip

  12. Vibe Affiliate : http://wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/vibe-affiliatewp.zip

For themes like Divi you can download the Divi addons :

Replace XXX with your WPLMS Theme purchase code

wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/vibebp-divi.zip

http://wplms.io/verify-purchase/?purchase_code=XXX&plugin=wplms.io/wplms-divi.zip

Copy and paste above links in the browser after replacing XXX with the WPLMS purchase code and you will be able to download the plugin files. You'll need to upload at WP dmin - plugins - add new and activate. Once the install and activation of the plugins is complete. Reload this page and you will see the updated status of the plugins.

Required Pages

This step setups up various pages and layouts in the theme. This is one of the required steps we advise everyone to follow even if you are not installing any demo content.

If the pages are already installed you will see the checks in green color. On fresh installation they'll appear as faded.

themeforest screenshot

Installing Sample Data

The most important step for installing demo content.

We strongly advise not to select all data blindly and import .

The data import would add a lot of sample posts which is garbage into your site. So take caution and select appropriately.

We recommend selecting Member Profiles, Member Cards, Course Cards, Course layouts, Group Layouts and Group cards. You can also select pages to get the demo pages from the site.

This is how the import content screen looks like.

themeforest screenshot

If your screen does not appear like this and there is an error in red. It means that your server was unable to load the demo content file which is uploaded in our Amazon servers.

This could be a temporary network issue and you can reload this page to load the data. Or try after few minutes to reload this page and load the data. In case the issue persists, the only alternative to this situation is to upload the content manually.Export package download links

  1. Academy Demo : Download link

  2. V4 Base Demo : Download link

  3. Demo 10 : Download link

  4. Demo 6 : Download link

  5. Demo 14 : Download link

  6. Demo 1 : Download link

Unable to see "Posts","Pages" in import content. You need to download the Zip files of our demos from below links and go back to step 1 "Select a demo style", click on this step on the left menu and upload the downloaded zip file from below links.Video walkthrough ›

If you are unable to download the slider, check FAQ section for direct link for sliders.

Video Walkthrough

Video walkthrough of how to install WPLMS version 4 on a blank WordPress site.

Video

FAQs

FAQ's common mistakes which might happen during the installation.