PolyCMS Installation and Activation Guide for RISE CRM
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)
- Log in to RISE CRM as an Administrator.
- Navigate to Settings > Plugins.
- Click Install Plugin and upload your
polycms.ziparchive. - Locate PolyCMS in the installed plugins list and click Activate.
Option B: Manual Upload via FTP or File Manager
- Extract
polycms.zipon your local machine. - Upload the extracted
polycms/folder into{rise_crm_root}/plugins/polycms/so the entry point resides atplugins/polycms/index.php. - 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.sqlusing your RISE table prefix ($db->getPrefix(), defaultrise_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, pluswritable/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_postsis empty,Polycms_Demo_Seederautomatically 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/dashboardand/signincontinue 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:
- Go to Settings > Access Permission > Roles > [Role].
- Scroll to the PolyCMS permissions section injected by
app_hook_role_permissions_extension. - 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
settingsautomatically). - REST API: Enable
/cms/api/v1/*access and generatepcms_*API keys if you plan to build decoupled frontends.
Verify Theme and Navigation Menus
- Go to Appearance > Themes (
/polycms/themes) and confirm Head Random is active. Customize logos, colors, and typography at Appearance > Theme Options. See Theme Management. - 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 (
/dashboardand/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:
- Quick Start: Your First Blog Post - Publish your first article in 3 minutes.
- Media Library Guide - Upload and organize images in
files/polycms/. - SEO Configuration Guide - Configure MTOptimize meta tags, social cards, and structured data.