PHPackages fahim8401/hplink-crm - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. fahim8401/hplink-crm ActiveProject fahim8401/hplink-crm ==================== HPLink CRM - Raw PHP CRM for cPanel/shared hosting 00PHP Since Sep 28Pushed 2mo agoCompare [ Source](https://github.com/fahim8401/crmphp)[ Packagist](https://packagist.org/packages/fahim8401/hplink-crm)[ RSS](/packages/fahim8401-hplink-crm/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (4)Used By (0) HPLink CRM (Raw PHP, cPanel-ready) ================================== [](#hplink-crm-raw-php-cpanel-ready) **Version:** 1.0.0 Requirements ------------ [](#requirements) - PHP 8.0+ or 8.1+ - MySQL (5.7+ recommended) - Extensions: `pdo_mysql`, `mbstring`, `json`, `fileinfo` - Shared hosting/cPanel compatible (no Composer or external PHP packages) Setup & Installation (Local or cPanel) ------------------------------------------ [](#setup--installation-local-or-cpanel) **Recommended: Use the Install Wizard** 1. Upload the entire `hplinkcrm` folder to your desired location (e.g., `public_html/hplinkcrm`). 2. Set permissions for `storage/exports` and `storage/logs` to writable (`chmod 755` or `chmod 775` as needed). 3. Visit `install/index.php` in your browser. - The wizard will check PHP extensions and folder permissions. - Enter your database credentials, timezone, and currency. - The wizard will write `config.php` and import the database schema and seed data. - On completion, you will see the default admin login and security reminders. 4. **Important:** Delete the `install/` folder after installation for security. **Manual Setup (Advanced):** - Copy `config.php.example` to `config.php` and update DB credentials and app settings. - Import `database/schema.sql` and `database/seed.sql` using phpMyAdmin or MySQL CLI. - Set permissions for `storage/exports` and `storage/logs` to writable. - Open `index.php` in your browser. **Pending Transaction Reminder:** - Each pending transaction now has a `settle_date` field (date to remind for collection). - Use this field to track when to follow up for payment. **Cron Example (Month Close):** - `php /home/username/hplinkcrm/close_month.php 2025-09` Security -------- [](#security) - Change the default admin password after first login (`admin@example.test` / `Admin@123`). - Remove seed users after deployment. - All passwords are hashed with `password_hash()`. - CSRF protection has been removed at user request. - Output escaped with `htmlspecialchars()`. - Delete the `install/` folder after installation for security. Troubleshooting --------------- [](#troubleshooting) - **DB Connection:** Check credentials in `config.php`. - **Permission Denied:** Ensure `storage/` subfolders are writable. - **Session Path:** Ensure PHP session path is writable. Use `install/session_test.php` to verify session persistence. If sessions do not persist, login will fail. - **exec() Disabled:** Some features (month close via web) require `exec()`. Manual Test Checklist --------------------- [](#manual-test-checklist) - Login as admin, HR, employee; verify role restrictions. - Create transaction as HR with salary deduction; check salary tracker. - Mark pending transaction as received; check changed\_by/changed\_at. - Run close\_month script; verify CSV and pending moved to next month. Database Schema Notes --------------------- [](#database-schema-notes) - The `transactions` table includes a `settle_date` column for pending transactions. - Use this date to trigger reminders or reports for money collection. File Structure -------------- [](#file-structure) ``` hplinkcrm/ ├─ index.php ├─ .htaccess ├─ assets/ ├─ controllers/ ├─ services/ ├─ lib/ ├─ views/ │ └─ layout/ ├─ storage/ │ ├─ exports/ │ └─ logs/ ├─ database/ │ ├─ schema.sql │ └─ seed.sql ├─ install/ │ └─ index.php ├─ config.php.example ├─ config.php ├─ close_month.php └─ README.md ``` Deployment (cPanel) ------------------- [](#deployment-cpanel) - Upload the entire `hplinkcrm` folder to your desired location (e.g., `public_html/hplinkcrm`). - Visit `install/index.php` in your browser to run the installer, or copy `config.php.example` to `config.php` and edit manually. - Create MySQL DB & user, set credentials in `config.php`. - Import `database/schema.sql` and `database/seed.sql` via phpMyAdmin or MySQL CLI, or use the installer. - Set permissions for `storage/` to 755/775 as required. - Cron example: `php /home/username/hplinkcrm/close_month.php 2025-09` run monthly. Troubleshooting --------------- [](#troubleshooting-1) - **DB Connection:** Check credentials in `config.php`. - **Permission Denied:** Ensure `storage/` subfolders are writable. - **Session Path:** Ensure PHP session path is writable. - **exec() Disabled:** Some features (month close via web) require `exec()`. Manual Test Checklist --------------------- [](#manual-test-checklist-1) - Run the install wizard and verify all requirements and permissions are checked. - Login as admin, HR, employee; verify role restrictions. - Create transaction as HR with salary deduction; check salary tracker. - Mark pending transaction as received; check changed\_by/changed\_at. - Run close\_month script; verify CSV and pending moved to next month. Changelog --------- [](#changelog) ### Version 1.1.0 (2024) [](#version-110-2024) - **Added**: Complete Clients management system (CRUD) - **Added**: Complete Transactions management system (CRUD) with filtering - **Added**: Reports page with financial summaries - **Added**: Users management (admin only) - **Added**: User profile page - **Added**: Activity logs viewer with filters - **Added**: Month Close web interface - **Added**: Improved dashboard with statistics widgets - **Added**: Mobile responsive navigation menu - **Added**: Developer documentation (DEVELOPERS.md) - **Added**: PHPDoc comments for better code documentation - **Added**: Input validation and error handling - **Added**: Flash messages for user feedback - **Improved**: Security with proper input sanitization - **Improved**: UI/UX with Tailwind CSS enhancements - **Fixed**: Flash message display with proper styling - **Fixed**: Mobile menu functionality ### Version 1.0.0 (2024) [](#version-100-2024) - **Fixed**: Missing dependencies in lib/helpers.php - added required includes for auth.php and database.php - **Fixed**: Incomplete employee management routing - enabled full employee CRUD functionality - **Added**: Employee management views and interface - **Added**: Version tracking in composer.json - **Improved**: Code structure and dependency management - **Enhanced**: Employee listing with proper table layout and actions ### Health Score 21 — LowBetter than 19% of packages Maintenance57 Moderate activity, may be stable Popularity0 Limited adoption so far Community8 Small or concentrated contributor base Maturity17 Early-stage or recently created project Bus Factor1 Top contributor holds 65.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/91ea8afd73b0ee599c31b2dab8291064db7f890552edd9cc619f6d849a2baa37?d=identicon)[fahim8401](/maintainers/fahim8401) --- Top Contributors [![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (15 commits)")[![fahim8401](https://avatars.githubusercontent.com/u/112126196?v=4)](https://github.com/fahim8401 "fahim8401 (8 commits)") ### Embed Badge ![Health badge](/badges/fahim8401-hplink-crm/health.svg) ``` [![Health](https://phpackages.com/badges/fahim8401-hplink-crm/health.svg)](https://phpackages.com/packages/fahim8401-hplink-crm) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)