Back to Main Site

PolyCMS Plugin Management for RISE CRM

Last updated on Nov 22, 2026 10:54 AM 10:54 AM 2,036.39 ms

PolyCMS for RISE CRM includes a self-contained plugin ecosystem that extends your website, SEO tools, analytics, and visual page building without modifying core CMS or RISE CRM files. Administrators manage all CMS sub-plugins from PolyCMS > Plugins (/polycms/plugins), separate from the main RISE CRM plugin manager at Settings > Plugins.

Plugin System Overview

Every PolyCMS sub-plugin resides inside plugins/polycms/plugins/ and integrates with the CMS core through actions, filters, shortcodes, and dashboard hooks. Separating CMS sub-plugins from RISE CRM core plugins keeps your editorial extensions modular, portable, and easy to toggle on or off per environment.

Access to plugin actions follows RISE CRM role permissions configured under Settings > Access Permission > Roles:

  • View Plugins: Requires polycms_view permission.
  • Activate / Deactivate Plugins: Requires polycms_edit permission.
  • Upload ZIP Packages: Restricted to RISE CRM Administrators (polycms_is_admin()).

Managing Installed Plugins

Navigate to PolyCMS > Plugins to inspect all discovered sub-plugins. Each entry displays:

  • Plugin name, installed version, and author details parsed from its PHP docblock header
  • Short functional description
  • Current status (Active, Inactive, or Not Installed for folders copied manually that have not yet been activated)
  • One-click Activate or Deactivate controls
  • A Settings link whenever an active plugin registers a dedicated settings page
  • Grid and list view switches for managing larger plugin collections

When you activate a newly copied plugin for the first time, PolyCMS automatically registers its metadata in {db_prefix}blog_plugins (default rise_blog_plugins) and fires its activation hook so any required tables or default options are initialized cleanly.

Installing New Plugins

Installing via ZIP Upload

  1. Navigate to PolyCMS > Plugins and click Upload Plugin (/polycms/plugins/upload).
  2. Select a .zip archive containing the plugin folder and main PHP entry file.
  3. Click Upload to extract, validate, and register the package into plugins/polycms/plugins/.
  4. Return to PolyCMS > Plugins and click Activate to enable the new extension.

Manual Installation via FTP or File Manager

  1. Extract the plugin archive locally so its files sit inside a single slug folder (for example, my-custom-plugin/).
  2. Upload that folder into {rise_crm_root}/plugins/polycms/plugins/.
  3. Open PolyCMS > Plugins in RISE CRM. PolyCMS automatically detects the folder and displays it ready for one-click activation.

Plugin Discovery and Security Validation

PolyCMS discovers plugins by scanning subdirectories inside plugins/polycms/plugins/ for a main PHP file ({slug}/{slug}.php or the first .php file containing a Plugin Name: header). Supported docblock metadata fields include Plugin Name:, Description:, Version:, Author:, and Plugin URI:. Active plugins can also register sidebar entries under the PolyCMS or Appearance menus using an optional menu.json descriptor or the polycms_register_plugin_menus hook.

All uploaded .zip packages pass through strict security checks before installation:

  • Archive Extraction Defense: Uses polycms_safe_extract_zip() to block Zip Slip directory traversal, symbolic link exploits, and zip bombs during temporary extraction.
  • Path and Slug Validation: Enforces strict alphanumeric/slug naming rules and validates file paths via polycms_validate_file_path().
  • Header Integrity Verification: Rejects archives that lack a valid main PHP file or a Plugin Name: header.
  • Automatic Rollback: Removes temporary files and rolls back extracted directories immediately if database registration fails.

All 7 Bundled Plugins

PolyCMS for RISE CRM ships with 7 production-ready plugins pre-installed in plugins/polycms/plugins/:

Plugin Version / Scope Description
MTBuilder Visual Page Builder Drag-and-drop landing page and template builder with 17 blocks, Template Parts, 6 full-page presets, and live responsive preview.
MTOptimize v1.3.0 SEO Toolkit Injects Google Search Preview, real-time character counters, Focus Keyword analysis, Open Graph, Twitter Card, Schema.org JSON-LD, and robots/canonical controls directly inside the Core SEO box via polycms_seo_box_before_fields and polycms_seo_box_content hooks.
XML Sitemap v1.1.0 SEO Indexing Generates root SEO routes (/sitemap.xml, /sitemap_index.xml, /post-sitemap.xml, /page-sitemap.xml, /category-sitemap.xml, /sitemap.xsl, /robots.txt) plus prefix-aware chunked sitemaps of 1,000 URLs and configurable exclusions.
Google Analytics Analytics & Views Injects GA4 tracking for public visitors, runs a session-deduplicated local post view counter, and adds a Top Performing Posts widget to the PolyCMS Dashboard.
Maintenance Mode Site Operations Displays a customizable maintenance screen returning HTTP 503 with a Retry-After header while allowing logged-in RISE CRM staff and administrators to bypass normally.
Banner Slider Promotional UI Builds responsive hero and promotional carousels with scheduling, desktop/mobile imagery, and CTA controls at PolyCMS > Banner Slider.
API Explorer Developer Sandbox Interactive REST API tester at PolyCMS > API Explorer featuring live endpoint execution, Media database testing, and code snippets in cURL, PHP, JavaScript, and Python.

Plugin Settings and Storage

Each active plugin manages its own configuration independently without colliding with RISE CRM global settings. Plugin options are persisted in {db_prefix}blog_plugin_options (default rise_blog_plugin_options), while plugin registration status is tracked in {db_prefix}blog_plugins. Plugins that require specialized structured storage (such as Banner Slider banners, MTBuilder templates, MTOptimize SEO metadata, or Google Analytics post views) initialize their tables automatically on activation.

Plugin Directory Structure

A typical sub-plugin inside PolyCMS for RISE CRM follows this folder layout:

plugins/polycms/plugins/
|-- xml-sitemap/
|   |-- xml-sitemap.php       (Main plugin file with PHP docblock header)
|   |-- menu.json             (Optional sidebar menu registration)
|   |-- languages/            (Translation files)
|   \-- assets/               (CSS/JS assets)
|-- mtoptimize/
|   \-- mtoptimize.php
|-- mtbuilder/
|-- google-analytics/
|-- maintenance-mode/
|-- banner-slider/
\-- api-explorer/

Plugins interact with PolyCMS core through the Hooks & Filters System and the collision-proof RISE compatibility helpers (polycms_ci(), polycms_admin_url(), polycms_get_option(), polycms_staff_can()).

Related Documentation