Flexible Media Gallery for Perfex CRM
Flexible Media Gallery for Perfex CRM Overview & Functional Engine
Flexible Media Gallery for Perfex CRM is a CodeIgniter module built for agencies, construction firms and support teams that need structured image documentation inside their CRM records. The package solves a concrete operational bottleneck: native attachment fields and file managers scatter visual evidence across emails and flat upload lists, forcing staff and customers to reconstruct project history manually. In production and staging workflows, the module functions as a workflow extension that binds media albums to the exact project, task, ticket, lead, contract or proposal record where the work happens.
Technical Specifications & Deployment Matrix
| Engineering Metric | Deployment Specification |
|---|---|
| Base Technology / Framework | CodeIgniter module for Perfex CRM (not a standalone application) |
| Runtime / Language Requirements | PHP 7.x or PHP 8.x server environment |
| Database / Persistence Footprint | MySQL 5.x or MySQL 8.x; SQL schema files included in the package |
| Files Included | JavaScript JS, HTML, CSS, PHP, SQL |
| Browser Compatibility | IE9, IE10, IE11, Firefox, Safari, Opera, Chrome, Edge |
| Integration Surface | Projects, Tasks, Tickets, Customers, Leads, Contracts, Proposals |
Album-Based Media Architecture & Execution Pipeline
Albums bind to a parent CRM entity and render inside that record’s native tab structure. From a data-flow perspective, each album acts as a container record attached to its parent module row, and uploaded images are grouped, indexed and surfaced through that binding rather than through the generic attachments table. The result is a layered retrieval model: staff open a project, task or ticket and immediately see the relevant visual timeline without querying the flat file manager.
Architectural & Functional Highlights
- Entity-Scoped Album Binding: Gallery views are injected into the native interfaces of seven CRM surfaces. Projects receive a gallery tab, tasks embed the gallery inside the task view and modal, tickets gain a gallery tab, and customers, leads, contracts and proposals each hold their own album sets for customer-specific or sales-related visuals.
- Slider and Full-Screen Rendering Layer: The front-end renders album contents as a scrollable reel; clicking any thumbnail dispatches a full-screen viewer so reviewers can inspect project progress, design work or delivery proof image by image without leaving the record context.
- Access and Visibility Controls: Every album can be flagged as internal-only or visible to customers where the parent entity supports customer-facing access, which allows teams to keep internal reviews private while exposing approved deliverables through the customer portal.
- Batched Notification Pipeline: Uploading multiple gallery photos to a project, task or ticket triggers a single bell notification and a single email for the entire batch, including the file count, instead of flooding recipients with one alert per image (introduced in version 1.0.2).
- Whole-Album ZIP Export: Staff, customers and public proposal viewers can download every file in an album as one zip archive, with a fallback fix in version 1.0.2 for servers where the default PHP temp folder is not writable.
Operationally, this architecture targets teams whose deliverables are inherently visual: construction and installation crews documenting milestones such as site visits or delivery proof, field service units capturing issue and repair evidence, support desks handling hardware defects, and creative agencies storing drafts and revisions. For operations teams that additionally require OCR-indexed document workflows outside the CRM runtime, EasyDocMgt exists as a standalone document management system with file sharing and workflow automation.
Production Deployment & Implementation Considerations
Deployment requires a working Perfex CRM installation, since the package is a module rather than an independent application; the bundled documentation covers uploading and activating the module inside the CRM. The server must run PHP 7.x or 8.x with MySQL 5.x or 8.x, and administrators should verify that the PHP temp directory is writable before enabling album downloads, because the ZIP export routine depends on server-side write access to that location. Implementation boundaries are defined by the parent CRM: the module surfaces galleries only within the seven supported entities, and customer visibility depends on whether the parent record exposes a customer-facing portal view. Customization scope centers on album structure and permission configuration; teams define unlimited named albums such as Before, During, After or Issue Photos per record and set internal versus customer-visible flags per album. No template overrides or hook-level modifications are documented, so teams planning deeper interface changes should treat the module as configuration-driven rather than extension-driven. For decoupled implementations outside Perfex entirely, Botble stands as an independent Laravel CMS path with its own modular system.
Frequently Asked Questions
Can this package run without Perfex CRM installed?
No. The package is a Perfex CRM module, not a standalone application. A functioning Perfex CRM installation is a hard prerequisite, and the included documentation walks through uploading and activating the module inside that environment.
Can an entire album be downloaded as a single archive?
Yes. Since version 1.0.2, staff members, customers and public proposal viewers can download one zip containing every file in an album, replacing the previous behavior of saving images individually.
Does uploading several photos at once send multiple notifications?
No. Version 1.0.2 batches the alerting, so adding several gallery photos to a project, task or ticket produces one bell notification and one email that states the number of uploaded files.
Are galleries available inside proposals?
Yes. Proposal support was added in version 1.0.1, extending the gallery surface beyond projects, tasks, tickets, customers, leads and contracts to include the proposal module as well.
-
v1.0.1 Latest