Back to Main Site

PolyCMS Installation and Activation Guide for RISE CRM

Last updated on Nov 22, 2026 7:37 AM 7:37 AM 241.60 ms

Installing PolyCMS for RISE CRM takes less than five minutes through RISE CRM's native Settings > Plugins uploader or manual FTP upload. Upon activation, PolyCMS automatically creates 19 isolated InnoDB tables, enables the responsive Head Random theme, registers 7 bundled plugins, and safely protects your existing CRM /dashboard and /signin routes.

Before You Start

Verify that your server and RISE CRM installation meet these minimum requirements:

Requirement Minimum Specification
RISE CRM 3.9+ (fully tested on 4.1+, CodeIgniter 4 and Bootstrap 5)
PHP 8.1+
Database MySQL 5.7+ or MariaDB 10.3+
Web Server Apache (mod_rewrite enabled) or Nginx (try_files configured)
Writable Directories files/polycms/ and writable/polycms/

To verify your PHP version, check your hosting control panel or run php -v via SSH/CLI on your server.

Step 1: Download the Plugin Package

Purchase and download polycms.zip from the official PolyXGO portfolio on CodeCanyon. The archive is self-contained and bundles the core plugin, self-hosted TinyMCE, Select2, SweetAlert2, HTMLPurifier (vendor/ezyang/htmlpurifier), 16 language packs, the Head Random theme, and 7 production sub-plugins.

Step 2: Install and Activate in RISE CRM

Choose either the built-in admin uploader or manual upload via FTP/File Manager.

Option A: Via RISE CRM Admin Panel (Recommended)

  1. Log in to RISE CRM as an Administrator.
  2. Navigate to Settings > Plugins.
  3. Click Install Plugin and upload your polycms.zip archive.
  4. Locate PolyCMS in the installed plugins list and click Activate.

Option B: Manual Upload via FTP or File Manager

  1. Extract polycms.zip on your local machine.
  2. Upload the extracted polycms/ folder into {rise_crm_root}/plugins/polycms/ so the entry point resides at plugins/polycms/index.php.
  3. Open Settings > Plugins in RISE CRM and click Activate next to PolyCMS.

What Happens on First Activation

PolyCMS uses RISE CRM's native lifecycle hooks (register_installation_hook and register_activation_hook in plugins/polycms/index.php) to bootstrap your CMS automatically:

  • Creates 19 Database Tables: Runs plugins/polycms/install/database.sql using your RISE table prefix ($db->getPrefix(), default rise_blog_*) for content, taxonomies, comments, media, navigation, plugins, themes, and settings.
  • Prepares Writable Storage: Initializes files/polycms/ (secured with .htaccess) for media and permalink prefix cache, plus writable/polycms/ subdirectories (cache/, rate_limit/, backups/, htmlpurifier/).
  • Activates the Default Theme: Registers the Bootstrap 5 Head Random theme from plugins/polycms/themes/head-random/.
  • Registers 7 Bundled Plugins: Makes MTBuilder, MTOptimize, XML Sitemap, Google Analytics GA4, Maintenance Mode, Banner Slider, and API Explorer available under PolyCMS > Plugins.
  • Seeds Initial Demo Content: On a fresh install where blog_posts is empty, Polycms_Demo_Seeder automatically generates starter posts, pages, categories, tags, menus, widgets, and MTBuilder showcase layouts.
  • Injects Sidebar Navigation: Adds the PolyCMS and Appearance groups to the Staff Left Sidebar (app_filter_staff_left_menu) and optionally adds Blog to the Client Portal sidebar (polycms_show_in_client_menu).
  • Keeps CRM Routes Safe: Leaves Homepage Redirect OFF (0) by default so /dashboard and /signin continue functioning normally.

Step 3: Configure Role Permissions (RBAC)

RISE Administrators and roles with can_manage_all_kinds_of_settings automatically receive full PolyCMS access. To grant tailored access to editors, marketers, or content managers:

  1. Go to Settings > Access Permission > Roles > [Role].
  2. Scroll to the PolyCMS permissions section injected by app_hook_role_permissions_extension.
  3. Enable the required permissions and save the role:
Permission Key Label What It Allows
polycms_view PolyCMS: View Access Dashboard and browse posts, pages, categories, tags, comments, and media
polycms_create PolyCMS: Create Create new posts, pages, categories, tags, and upload media files
polycms_edit PolyCMS: Edit Modify existing content, publish or unpublish posts, and moderate comments
polycms_delete PolyCMS: Delete Delete posts, pages, taxonomies, comments, and media items
polycms_settings PolyCMS: Settings Configure Settings, Permalinks, Themes, Theme Options, Menus, Widgets, Plugins, and Tools

Step 4: Essential Post-Installation Configuration

Review these four core areas right after activation to tailor PolyCMS to your domain.

Configure Permalink Settings

Navigate to PolyCMS > Permalinks (/polycms/permalink-settings) to define your URL structure:

  • Blog Prefix: Base path for your public blog (default /blog, or customize to /news, /articles, or empty root mode).
  • Category Base: URL segment for category archives (default category).
  • Tag Base: URL segment for tag archives (default tag).

Saving updates files/polycms/.blog_prefix_cache.php immediately. See the Permalink and URL Settings Guide for full routing rules.

Review General, Reading, and Performance Settings

Open PolyCMS > Settings (/polycms/settings) and review the 5 configuration tabs (#tab-reading, #tab-general, #tab-performance, #tab-localization, #tab-api):

  • Reading: Choose whether your blog homepage displays latest posts or a static page, set posts per page, and assign a default featured image.
  • General: Toggle comments, breadcrumbs, client login requirements, branding display, and homepage redirect (keep OFF unless you want the root domain to render PolyCMS directly).
  • Performance: Enable frontend HTML caching (writable/polycms/cache/) and configure cache duration.
  • Localization: Confirm site language, timezone, date format, and time format (falls back to RISE CRM settings automatically).
  • REST API: Enable /cms/api/v1/* access and generate pcms_* API keys if you plan to build decoupled frontends.

Verify Theme and Navigation Menus

  1. Go to Appearance > Themes (/polycms/themes) and confirm Head Random is active. Customize logos, colors, and typography at Appearance > Theme Options. See Theme Management.
  2. Open Appearance > Menus (/polycms/menus) to organize links to your pages, categories, and custom URLs. See the Menu Builder Guide.

Activate Bundled Plugins

Open PolyCMS > Plugins (/polycms/plugins) and activate the bundled sub-plugins your site needs:

  • MTBuilder: Visual drag-and-drop page builder with 17 blocks and 6 preset templates. Learn more.
  • MTOptimize: SEO toolkit adding Google Search Preview, Focus Keyword analysis, Open Graph, Twitter Cards, and Schema.org JSON-LD. Learn more.
  • XML Sitemap: Serves /sitemap.xml, chunked sub-sitemaps, and /robots.txt. Learn more.
  • Google Analytics: Injects GA4 tracking and powers Dashboard view metrics. Learn more.
  • Maintenance Mode: Displays a branded HTTP 503 maintenance notice while letting staff preview the site. Learn more.

See Plugin Management for full plugin controls.

Step 5: Verify Your Installation

Confirm these checkpoints to ensure everything is working smoothly:

  • PolyCMS > Dashboard (/polycms/dashboard) loads overview metrics and recent activity without errors.
  • PolyCMS > Posts opens the post listing, and clicking New Post loads the TinyMCE rich-text editor.
  • Visiting https://your-domain.com/blog (or your chosen blog prefix) renders your public frontend cleanly using the Head Random theme.
  • Your RISE CRM internal routes (/dashboard and /signin) continue working normally.

Data Safety on Deactivation and Uninstallation

PolyCMS follows non-destructive lifecycle practices in plugins/polycms/index.php:

  • Both Deactivation (register_deactivation_hook) and Uninstallation (register_uninstallation_hook) preserve all 19 CMS database tables by default.
  • Posts, pages, categories, tags, media records, menus, and settings stay intact in your database so you can reactivate the plugin at any time without losing content.

If you ever want to wipe demo or blog content deliberately, use Clear All Blog Data under PolyCMS > Tools (after taking a backup in the Backup / Restore tab).

Troubleshooting Quick Reference

Issue Resolution
PolyCMS or Appearance menu missing Clear browser cache, confirm PolyCMS is active under Settings > Plugins, and verify role permissions at Settings > Access Permission > Roles
404 error on public blog URLs Re-save PolyCMS > Permalinks to regenerate files/polycms/.blog_prefix_cache.php and verify Apache mod_rewrite or Nginx try_files
Permission denied in admin screens Assign polycms_view, polycms_create, polycms_edit, polycms_delete, or polycms_settings to the staff member's role
Upload or cache write errors Confirm files/polycms/ and writable/polycms/ exist and are writable by the web server user (chmod 775)

For deeper diagnostics, see the Troubleshooting and Common Issues Guide.

Next Steps

Now that PolyCMS is running inside RISE CRM, continue with: