Logtracker Module for Perfex CRM

Logtracker is a module for Perfex CRM that provides a centralized interface for managing and accessing log files generated by the application. It offers an intuitive dashboard, log viewing, filtering, downloading, deletion, and integration with Telegram for critical error notifications.

Features

• Dashboard with log statistics (total, error, debug, info)
• View logs by date and level
• Download log files (plain or as ZIP)
• Delete individual or all log files
• Send error logs via email
• Telegram integration for instant log notifications
• Permissions management for staff roles
• Multi-language support (English, Arabic)

Installation

1. Copy the module: Place the logtracker directory inside your modules folder in Perfex CRM.
2. Activate the module: Go to Setup > Modules in Perfex CRM admin and activate Logtracker.
3. Set permissions: Assign appropriate permissions (view, create, edit, delete) to staff roles via Setup > Staff > Roles.

Usage

• Access the Logtracker dashboard from the sidebar menu.
• View log summaries by date and level.
• Download or delete log files using the action buttons.
• Use the settings page to configure environment mode and Telegram integration.

Permissions

Logtracker supports granular permissions:

• View: Access the dashboard and view logs
• Create: Reserved for future features
• Edit: Reserved for future features
• Delete: Delete log files or clear all logs
• Download: Download log files

Assign these via Perfex CRM's staff roles management.

Telegram Integration

To receive log notifications on Telegram:

1. Enable Telegram notifications in Logtracker settings.
2. Enter your Telegram Bot Token and one or more Chat IDs.
3. Select which log levels should trigger notifications.
4. Use the test button to verify your configuration.

No Telegram credentials are stored in the codebase. All configuration is done via the admin UI.

Screenshots

Log Dashboard Overview

---

Live Log Viewer & Filtering

---

Settings && Telegram Integration

Multi-language Support

• English and Arabic language files are included.
• You can add more languages by creating a new folder in language/ and translating logtracker_lang.php.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request.

License

This module is released under the MIT License. See LICENSE for details.

Author: Amolood