Readme: BR
PopUpJSClient is an addon module for WHMCS that allows administrators to create, manage, and display announcements elegantly through pop-ups in the client area. Ideal for urgent notices, seasonal promotions, or service updates.
- Simplified Management: Intuitive interface in the WHMCS admin panel to create, edit, and delete announcements.
- Multimedia Support: Creation of rich announcements with support for images and custom links.
- Group Targeting: Display specific announcements only for certain client groups.
- Priority System: Ensures that critical information is viewed first.
- Automatic Scheduling: Set start and expiration dates to automate your campaigns.
- Multilingual: Native support for Portuguese (BR), English, Spanish, and Farsi.
- Responsive Design: Pop-ups optimized for desktop and mobile devices.
This extended version includes critical improvements for professional use:
- Smart Content Detection: Automatically identifies whether the content is text or image for perfect rendering.
- Display Control (Dismiss 24h): Cookie implementation so the client is not bothered by the same pop-up for 24 hours after closing it.
- Language Standardization: Fixes in language detection logic to align with WHMCS global standards.
- Visual Upgrade: Improvements to the modal interface with new colors, transition effects, and tables following the native WHMCS style.
- Custom URLs: Support for external links in image or text announcements (Recommended: Images in 800x600).
1 Clone the Repository:
git clone https://github.com/sr00t3d/PopUpJSClient/
2 File Upload: Copy the contents of the modules/addons/popupjsclient folder to the corresponding directory in your WHMCS installation.
3 Activation:
- Go to WHMCS Admin at Settings > Addons > Addon Modules.
- Locate PopUpJSClient and click Activate.
- Configure access permissions for the desired administrative roles.
The project uses a modern organization to facilitate maintenance:
/modules/addons/popupjsclient
|-- lib
| | `-- Model.php
| | `-- ModuleController.php
| | `-- ModuleView.php
| |
|-- resources
| |-- lang
| | |-- english.php
| | `-- farsi.php
| | `-- spanish.php
| | `-- portuguese-br.php
|-- popupjsclient.php
|-- hooks.php
- WHMCS: Version 7.0 or higher.
- PHP: Version 7.2 or higher.
This project is an extended fork based on the original work of Reza Karimi. Contributions are welcome!
- Original Author: Reza Karimi
- Improvements and Maintenance: Percio Andrade
Warning
This software is provided "as is." Always ensure you have explicit permission before executing it. The author is not responsible for any misuse, legal consequences, or data impact caused by this tool.
For a complete, step-by-step guide, check out my full article:
👉 Create modal popups in WHMCS
This project is licensed under the GNU General Public License v3.0. See the LICENSE file for more details.