PluginCams Documentation

Getting Started

PluginCams is a powerful WordPress plugin that allows you to integrate live adult cams from multiple platforms directly into your website. This documentation will guide you through installation, configuration, and advanced usage.

Installation

Standard Installation

1. Download the PluginCams zip file from your purchase confirmation email or account dashboard
2. Log in to your WordPress admin panel
3. Navigate to Plugins → Add New
4. Click "Upload Plugin" and select the PluginCams zip file
5. Click "Install Now" and then "Activate Plugin"

Manual Installation (FTP)

1. Unzip the PluginCams package on your computer
2. Connect to your WordPress installation via FTP
3. Navigate to the /wp-content/plugins/ directory
4. Upload the entire PluginCams folder
5. Log in to your WordPress admin panel and navigate to Plugins
6. Locate "PluginCams" in the list and click "Activate"

Configuration

Initial Setup

1. Navigate to PluginCams → Settings in your WordPress admin
2. Activate the plugin with your license code provided by us when you purchased the plugin.
3. Now you see the "Webcams Settings" tab
4. For each platform you want to use (Chaturbate, Stripchat, BongaCams), you'll need to:
   • Obtain your affiliate API key or affiliate user from the platform (details below).
   • Enter the API key or the affiliate code/user id in the corresponding field.
   • Configure any additional platform-specific settings.
   • Enable Auto Import and wait or trigger a manual import.
   • For manual import to work, you must have Auto Import enabled. Manual import only triggers the cron job instantly.
5. Save your settings

General Settings

API Reference

PluginCams integrates with multiple adult cam platforms through their official APIs (or partner integrations). Below are the specific requirements and setup instructions for each supported platform.

Shortcodes

If you enable the Include webcams on home option, webcams will be injected into your theme’s homepage using your theme’s default post layout. Alternatively, you can render webcams anywhere using the new [webcams] shortcode.

New Shortcode: [webcams]

Quick examples:

• Default grid with pagination (20 per page): [webcams]
• List view: [webcams template="list"]
• Change page size: [webcams per_page="32"]
• Limit total results (with pagination): [webcams limit="60" per_page="20"]
• Filter by service: [webcams service="chaturbate"]
• Filter by gender and country: [webcams gender="female" country="spain"]
• Dark mode with meta fields: [webcams theme="dark"]
• Display custom fields above cards: [webcams meta="service,language"]
• Combine filters: [webcams service="stripchat" gender="female" language="english"]

There are many more options available (taxonomy filters, meta filters, ordering, search, include/exclude, etc.). Please check the full documentation above for the complete reference.

Legacy Shortcodes (Still Supported)

The legacy shortcode [webcam_list] continues to work for backward compatibility, but we recommend migrating to [webcams] for new features and better performance.

Themes & Templates

Included Pro Theme (Optional)

We ship an optional, ready-made theme optimized for cam directories. You don’t need it to use PluginCams, but it’s available if you want a plug-and-play layout.

1. Download the theme zip from your PluginCams account
2. WordPress → Appearance → Themes → Add New → Upload
3. Install & activate, then adjust under Appearance → Customize

Generic Module (for Random Themes)

The Generic Module makes single webcam pages look complete on any WordPress theme. It automatically injects the webcam player (embed), essential custom fields (service, country, language, gender, tags, etc.), and an extra action button so visitors can jump straight to the live room. Use it when you’re not using a PluginCams theme and still want a polished single page without custom coding.

Fallbacks (Legacy)

Our themes include a legacy Fallback option that prevents 404 pages for deleted performers. When enabled, if a webcam post has been removed, the original permalink still resolves and displays a lightweight page with a faker player and essential info instead of a 404. This helps preserve user experience and internal links.

JSON Fallback (Legacy Permalinks)

Recommended modern fallback. When enabled, each imported/saved webcam generates a JSON file at /wp-content/plugincams-json/{slug}.json. If the post is later deleted, the exact same permalink renders a rich fallback page (player + related) using your theme. If the post exists, WordPress serves the normal post as usual.

# robots.txt example (replace with your domain)
Sitemap: https://your-domain.tld/cams-sitemap.xml

Troubleshooting

Common Issues

Debugging

To enable debug mode:

1. Edit your wp-config.php file
2. Add or modify these lines:

   define('WP_DEBUG', true);
   define('WP_DEBUG_LOG', true);
   define('WP_DEBUG_DISPLAY', false);

3. Check the wp-content/debug.log file for errors

Whitelabels & Advanced Features

Frequently Asked Questions