Theme Setup, Installation And Update

Installing the Gecko theme is simple as uploading the proper zip file.
If this is your first time installing the theme in the WordPress, please follow these few steps.

  • Go to your purchases tab in profile page on PeepSo site and download PeepSo Theme: Gecko
  • Download the installer file on your desktop
  • On your site, go to WP Admin -> Appearance -> Themes and press Add new button
  • Upload the installer file and activate the theme

That’s it, you have Gecko theme installed.

Adding The License

In order for Gecko theme to work properly and receive updates, you need to enter the license. Please follow these steps;

  • Find the license number at your purchases tab in profile page on PeepSo site.
  • Copy the license number and go to WP Admin -> Gecko -> License
  • Paste your license number and press “Save Changes” button

Your license should now be activated

Updating Gecko Theme

If your license is still valid, update should show up automatically as soon as it is available, however, you will have to manually trigger the update. Simply go to the WP Admin -> Dashboard -> Updates and check if there is available update. If there is one, you can update the Gecko theme from there.

Note: We advise against updating theme from the Themes screen. Always use WP dashboard -> Updates for all updates.

First Setup – Like a Demo

One often asked question is if your site can look like our demo. Of course it can. Here is the quick rundown of the necessary steps. After the installation of the Gecko theme, follow these;

  • Go to WP Admin -> Appearance -> Menus and publish a menu in the Header Menu position
  • Go to WP Admin -> Apperance -> Widgets and publish PeepSo UserBar widget in the Header Widgets position
  • Publish some widgets in left and right sidebars
  • Keep at it until you are satisfied with the look of the site

That is really it, there is no complicated dummy content import, and your site will have a same structure as our demo.

Integration Or Monetization Plugins Won’t Activate

PeepSo integration and monetization plugins require some third-party plugins to be installed and activated on the site before they can be used. If you don’t have appropriate plugin installed, then PeepSo integration and monetization plugins will show following warning.

The Plugins License Is OK. Why They Won’t Activate?

The integration and monetization plugins actually require the respective plugins they are trying to integrate with.
For example, PeepSo Monetization: Woocommerce plugin won’t activate if you don’t have actual Woocommerce plugin installed and enabled on the site.

Same is true for every other integration or monetization plugin that shows this warning.

Where Can I Download Required Plugins

PeepSo Integrations: BadgeOS – Download BadgeOS plugin from developers website
PeepSo Integrations: myCRED – Download MyCRED plugin from WP plugin directory
PeepSo Monetization: Paid Memberships Pro – Download  Paid Membership Pro from developer website
PeepSo Monetization: WPAdverts – Download WP Adverts from WP plugin directory
PeepSo Monetization: Advanced Ads – Download Advanced Ads from WP plugin directory
Peepso Monetization: LearnDash – Download LearnDash from developer website
Peepso Monetization: Woocommerce – Download Woocommerce from WP Plugin directory
Peepso Monetization: EDD – Download Easy Digital Downloads from developer website

After downloading and installing these plugins, make sure to activate them before activating PeepSo integration and monetization plugins.

I Don’t Use Those Plugins

That’s completely fair, but make sure to disable PeepSo plugins that want to integrate with the software not available on the site.

Setting Up The Cron Job

This article use images from third-party sources. CPanel is commonly used on majority of hosting services, but if you need to access Cron Job configuration differently, please consult your hosting provider.

PeepSo Configuration

PeepSo runs the built-in maintenance scripts and for the small sites, they are usually enough, but for the active and large sites, it is better to offload this process directly to server to improve performance. Some features like video uploads even require external cron job to be set. Before you start adding external cron jobs, please enable “External Maintenance Cron Job” in WP Admin -> PeepSo -> Configuration -> Advanced -> Cron jobs section.

Creating a New Cron Job

Cron is the utility software installed on Unix-like computer operating system. In website development it is used to trigger a certain action at fixed times, dates, or intervals.

Adding the cron job is commonly done through the hosting CPanel interface. If you’re not sure how to access it, please consult your hosting provider.

CPanel Cron Job Interface

  1. Common settings field allows you to select one of the commonly used configurations, like running the cron every minute, every 5 minutes, once a day etc. If you chose the common setting, the options in box #2 will be filled automatically.
  2. If you ever need to fine tune the cron schedule, you can do it here
  3. In this field, the command to execute should be entered. We will provide all, but you will need to modify them slightly to match the domain name or change the HTTP to HTTPS if you enable SSL certificate on your site.

Cron Command Structure

Every cron command consist out of three parts. The software that is going to be used (wget, curl), the cron command (url in the middle)  and additional arguments at the end (> /dev/null)
This third part of the cron command is particularly important.
We suggest using the one outlined bellow, but you can also opt for using different, or no arguments at all.

  • Our example (> /dev/null) – Sends a cron output to /dev/null and notifies the email owner set in cron MAILTO when errors or debug messages occur
  • > /dev/null 2>&1 – Output is sent to /dev/null. No email is sent.
  • No argument – log file is created, email is sent to MAILTO address set in cron.

What is /dev/null?

It is just a special file on UNIX-like systems that accepts to be written but it never saves what’s written in it. Consider it be a book that is constantly being written, but it has no beginning, middle, or the end.

Maintenance Cron

Maintenance Cron is part of PeepSo Foundation Plugin. Setup scripts that clean up orphaned data, recounts hashtags, deletes temporary videos, delete items that are no longer needed. You can set the cron interval to run every 5 minutes and it works best for most sites.

Commands you can use:

wget > /dev/null
curl > /dev/null

Mail Queue

Mail queue is part of PeepSo Foundation Plugin. The email notifications that are queued will be sent in batches.
Before you setup the cron, make sure that the send mail function works properly, otherwise the email will stuck in the mail queue. You can set the cron interval to run every 5 minutes and it works best for most sites.

Commands you can use:

wget > /dev/null
curl > /dev/null

Local Video Conversion queue

Video Conversion queue is part of Videos Plugin. The cron will convert videos that are queued. Conversion process is starting from the oldest to newest, one video in one process. You can set the cron interval to run every 15 minutes or it depend on your server capability. Bear in mind that Video Conversion are an advanced experimental feature in a BETA phase – one that comes with a number of strict technical requirements and limitations.

Commands you can use:

wget > /dev/null
curl > /dev/null

Amazon Elastic Transcoder Video Conversion queue

Similarly to local video conversion, you can offload this task to Amazon Elastic Transcoder
Use this commant when you enable that integration.

wget > /dev/null
curl > /dev/null

GDPR Queue

GDPR queue is part of PeepSo Foundation Plugin. This cron triggers the execution for users who want to export their data. You can set the cron interval to run every 15 minutes.

Commands you can use:

wget > /dev/null
curl > /dev/null

Email Digest

Email Digest Cron is part of Email Digest Plugin. The cron creates and send email digest data for users. You can set the cron interval to run every 15 minutes.

Commands you can use:

wget > /dev/null
curl > /dev/null

Please note that curl must be installed on the server if you want to use curl commands

Using Third-Party Services To Schedule Cron Jobs

If for whatever reason, setting up the Cronjob is not a possibility on your server, you can choose to offload this task to third-party provider.
We recommend EasyCron that can provide advanced webcron solutions for all common and tricky needs.
EasyCron is in the business of handling Cron jobs since 2010 and have over 140.000 customers happily using their service.
You can see the full instructions on how to setup Cron jobs on EasyCron website by following this tutorial.



PeepSo Familly 1.x.x

  1. Go to WP Admin > Dashboard > Updates
  2. Select all PeepSo plugins that need to be updated
  3. Click ‘Update Plugins’ (note: this will deactivate all of the add-on plugins), don’t worry, they’ll come back during Step 6!
  4. Update PeepSo Core
  5. Go to the WP Admin > Plugins
  6. Reactivate all PeepSo plugins

PeepSo Family 2.x.x

If you are on version 2.x.x already:

Wait for all PeepSo plugins to show that the update is available and then update them all. We deploy our plugins through two independent systems (WordPress SVN and our own website), it usually takes a few hours for all updates to propagate properly.
Should you update only PeepSo foundation plugin, or paid add-ons, the plugins which are not updated will enter the “version mismatch lock” and you will not be able to use them until everything is on the same version.

In PeepSo 2.x.x the order of updates is no longer important – just make sure at the end of it everything has the same version number.

Plugins not activating / updating

  • No PeepSo Add-on will activate if PeepSo base plugin (Foundation) is inactive.
  • For version 1.x.x No PeepSo Add-on will activate if PeepSo base plugin (Foundation) has a different version number. This is a precaution against fatal errors about missing classes / methods / functions
  • Some “Integration” plugins also require a third party plugin to be active, for example WooCommerce, Advanced Ads, LearnDash, Paid Membership Pro, etc.
  • For version 2.x.x, integration plugins will still be active but their functionality won’t.
  • All PeepSo plugins need to be ACTIVE in order to check for updates
  • They also need a valid license key
If a plugin is inactive, it won’t get updated. For version 1.x.x, if you update Foundation, it will be impossible to activate it anymore. So you might get stuck with an outdated, inactive integration plugins. Then the only thing that helps is manual re-installation.

File System

PeepSo allows users to upload images and store them on your server.
The folder where images are stored must be a directory that is writable by your Web server and and is accessible via the Web. If the directory specified does not exist, PeepSo will create one.

If you chose to ignore this option, PeepSo will follow the system path where WordPress is installed.

Access this setting through WP Admin -> PeepSo -> Configuration -> Advanced. Scroll down till you reach the File System Override panel

File System Override setting



PeepSo Bundle License Key

If you have PeepSo Bundle license key, it can be used as one key to rule all additional PeepSo plugins.
To add your PeepSo Bundle license key navigate to:

– WP Admin > Peepso > Configuration and find the License Key Configuration panel

Click on the toggle Use a PeepSo Bundle license and enter your license key. Don’t forget to save the settings to apply the keys.

All Licenses:

  • All licenses are valid for the exact number of domains (sites) you purchased the license with.
  • If you need staging, development or local domains, you need to use a license seat just like any other website. If you need more domains than your license allows, you can always upgrade it.
  • Supported domains can be edited in Your Account > Purchases > Licenses > Manage Sites
  • For details, please see the description of each bundle and our License Agreement.

What to do if my license doesn’t validate?

If you encounter issues validating your license key, try to click the Bundle switch on-off and click save button to save configuration again.

Please note!

The Domain Name on which the license keys are activated is added as The Supported Domain Name.

All licenses include include services as described in the License Agreement. Subject to the limited Refund Policy.

PeepSo Shortcodes

User Profile: [peepso_profile]
Recent Activity: [peepso_activity]
Members: [peepso_members]
Recover Password: [peepso_recover]
Site Registration: [peepso_register]
External Redirect Warning: [peepso_external_link_warning]
PeepSo Search: [peepso_search]
Messages: [peepso_messages] (optional if Chat Plugin is installed)
Messages (silent): [peepso_messages guest_behavior="silent"] More information about this shortcode
Messages (login): [peepso_messages guest_behavior="login"] More information about this shortcode
Groups: [peepso_groups] (optional if Groups Plugin is installed)

Implementing Shortcodes

Upon Installation PeepSo creates a number of pages with shortcodes inside to render it’s content. It is a common practice in WordPress. These pages can be accessed through standard WordPress pages interface in WP Admin -> Pages

Default pages created after installing PeepSo

Shortcodes follow few specific rules. First and foremost they are tightly connected to PeepSo navigation. Meaning navigation in PeepSo toolbar and others will rely on the URL of the pages containing the shortcodes.

User Profile page with a shortcode

For example Profile page, as shown in the screenshot above contains [peepso_profile] shortcode. And if you notice the slug / URL is:

That way PeepSo knows where to redirect and how navigation should go to /profile/. You can change the Slug in the page to something else if you want to. It can be anything, really. When you save changes of the page, the navigation will be updated.

Navigation Engine

Starting from PeepSo 1.11.3 a new engine with a whole new set of settings to manage your community navigation is introduced.
Access these settings through WP Admin -> PeepSo -> Configuration -> Navigation Admin can now decide which pages with PeepSo shortcodes to use in navigation.

On top of that PeepSo keeps an eye out for any navigation-related issues and if there are any, you’ll see a notification in the backend of your site with an explanation and a link to the proper configuration page to remedy the situation.

Navigation error occured

Quick way to remedy the issue

Following and Saved in the community navigation

Starting from PeepSo, Administrator can expose “Following” & “Saved” in the community navigation. The ability to view only followed and saved content has existed in PeepSo for quite a while now, but some users reported concerns that these features are a bit hard to find when buried in the stream filters area.

We let you enable the PeepSo navigation links related to these two stream filters. You can only enable them if Default stream filter is set to “Community” and  “Remember the last selected stream filter” is disabled.

When enabled, the new menu items will show right under / next to the Community link.



Debugging Old PeepSo Versions Without Navigation Engine

Text bellow refers to PeepSo versions before 1.11.3

If you create another page containing the same shortcode, the first one will no longer be valid. The page will still render PeepSo and show profile, but navigation in PeepSo will point to the new URL.

Case study

  • Create a page with slug: /profile/ and containing [peepso_profile] shortcode
  • Create another page with slug: /user/ and containing [peepso_profile] shortcode

The result is: both pages will show PeepSo profiles but navigation within PeepSo will point to the latest created (saved) page. So in this case /user/.

Note: This example is for [peepso_profile] but it’s the exact same behavior for all of PeepSo shortcodes.

Fixing issues with navigation, broken links, trashed pages

If your website is experiencing:

  • broken / malformed / strangely looking links
  • 404 messages
  • any other issues that seem related to page URLs

Do the following:

  1. Go to Admin > Pages and find the page with a related PeepSo shortcode
  2. Edit The Page
  3. Click “Update” button
  4. Check if permalink is working. It should be fixed now.

Saving the permalink for the page

Known issues

Trashed pages: Make sure that the page you try to open is not trashed

Possible solution:

  1. Delete the existing page along with the trashed page.
  2. Empty the trash inside your “pages” in the Dashboard.
  3. Recreate the page that had the issue (for example profile page)
  4. Include the PeepSo Shortcode for that page

Pages not showing or only visible to Administrator: Make sure that all PeepSo Pages are set to Public Visibility and have their Status set to: Published.

Page visibility options

PeepSo Installation

Installing the Free PeepSo Foundation

  1. Go to [Admin > Plugins > Add New].
  2. A) Use the search field to search for PeepSo.
    B) Click [Upload plugin] and add the ZIP file downloaded from > Profile > Purchases
  3. Click [Install Now].
  4. When installation is finished, [Activate] the plugin.

Installing paid PeepSo add-ons

The PeepSo Installer

Introduced in PeepSo, the PeepSo Installer is the most convenient way to install the paid PeepSo add-ons.

  1. Go to [Admin > PeepSo > Installer]
  2. Copy & paste your license key into the license field and click the [Check] button.
  3. After your license is verified, you will be able to install and activate any add-ons included in your plan.
  4. To install & activate multiple add-ons, use the [Show bulk actions] button, select multiple add-ons and use the [Install] or [Activate] buttons in the toolbar.
PeepSo Installer

PeepSo Installer was introduced in version You can install single add-ons or enable Bulk Mode to perform actions on multiple add-ons at the same time.

Manual installation

For PeepSo older than version 3.5 or if for any other reason you prefer manual installation, follow the steps 1, 2B , 3 and 4 from the Free PeepSo Foundation installation guide.

The video tutorial that covers installation:

Important to note:

  • Child plugins require the PeepSo Foundation Plugin
  • The first three numbers in the version number of all PeepSo software (plugins and themes) must be the same. We always release all software with the same version number.
  • The integration / monetization plugins require third party plugins that are not included in our Bundles. Most of them are free or freemium.