PeepSo Docs

Navigation, Pages & Shortcodes

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]
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: http://domain.com/profile

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.

Navigation Engine

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

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