Documentation

Welcome to the PHPPayroll Documentation, your complete guide to installing, configuring, and using PHPPayroll effectively. PHPPayroll is a powerful employee attendance and payroll management system built using PHP and MySQL, designed to automate salary calculations, attendance tracking, and leave management for businesses of all sizes.

This documentation covers both PHPPayroll Cloud and PHPPayroll Open-Source, helping businesses and developers understand system features, setup processes, and customization options. PHPPayroll Cloud provides a secure, fully hosted payroll solution with minimal setup, while PHPPayroll Open-Source offers complete access to the source code for self-hosting and advanced customization.

The guide includes step-by-step installation instructions, detailed feature explanations, configuration guidelines, and best practices. Whether you are managing payroll through the cloud or customizing PHPPayroll to meet specific business requirements, this documentation helps streamline HR operations, reduce manual effort, and ensure accurate payroll processing through a reliable and scalable system.

PHP Payroll Configuration is a critical step in customizing the payroll system to meet your organization’s specific requirements. This process involves setting up core system parameters such as currency, server environment, and timezone to ensure smooth and reliable operation. You can also configure essential elements like the company logo for branding, default language preferences for localization, and time format settings for consistent attendance and payroll records. In addition, the payslip prefix can be customized to match your internal documentation standards. Along with email settings for automated payslip delivery and user role permissions, these configurations help ensure accurate salary processing, regulatory compliance, and a professional, seamless payroll experience.

Key Points:

• Set the default currency to reflect the company’s operating region
• Configure the server environment and timezone for reliable system performance
• Upload the company logo to maintain brand consistency
• Select a default language to support multi-lingual users
• Customize the time format for accurate attendance and payroll records
• Define a payslip prefix that aligns with company documentation standards
• Set up the email server for automated payslip distribution and notifications
• Manage user roles and access permissions to secure sensitive payroll data
• Enable the Employee Self-Service (ESS) portal for payroll and attendance access
• Customize payroll and email templates for consistent communication
• Ensure compliance with local payroll laws and tax regulations

Language editing in your PHP Payroll system allows you to localize the application, making it accessible and user-friendly for employees and administrators across different regions. By customizing language files, you can modify labels, messages, notifications, and other text elements to match your organization’s preferred terminology and support multiple languages. This improves communication clarity and ensures consistency throughout the platform.

Frontend template editing focuses on customizing the system’s visual appearance and layout. You can modify the HTML structure, CSS styles, and JavaScript functionality to adjust themes, color schemes, fonts, and overall design. This ensures the user interface aligns with your company’s branding guidelines and delivers a seamless, professional user experience. Together, language and template editing help create a payroll system that is both visually appealing and culturally relevant.

Key Points:

• Customize language files for localization and multi-language support
• Modify system text, labels, and notifications for clarity and consistency
• Edit HTML templates to change page layouts and content structure
• Adjust CSS for branding, color schemes, and responsive design
• Update JavaScript to enhance interactivity and overall user experience
• Maintain separation of content and design for easier maintenance and updates

Setting up SMTP email configuration in your PHP Payroll system is essential for reliable and secure communication, including automated payslips, notifications, alerts, and reminders. This process involves specifying SMTP server details such as the host, port, encryption type (SSL/TLS), and authentication credentials to ensure efficient email delivery and to avoid spam filtering issues.

In addition to SMTP setup, customizing email templates allows you to control the content, formatting, and branding of all outgoing messages. This ensures consistent communication and reinforces your company’s identity. Templates can include dynamic placeholders for personalized employee information, making each email professional and relevant.

Key Points:

• Configure SMTP server settings, including host, port, encryption, and authentication
• Test email delivery to confirm the configuration is working correctly
• Customize email templates for payslips, alerts, and notifications
• Use dynamic placeholders to automatically personalize email content
• Maintain consistent branding with company logos and color schemes in templates

The User Role Management System defines and controls access levels for different users within the HRM environment. Administrators can create custom roles such as HR Manager, Finance Officer, Team Lead, or Employee, and assign specific module permissions including view, add, edit, or delete. This ensures that sensitive information, such as payroll data or personal employee records, is accessible only to authorized personnel.

The system supports role-based dashboards, activity logs, and permission-driven menus, which streamline navigation while enhancing security. It also allows administrators to easily update roles and permissions, making the system scalable and adaptable as the organization grows or undergoes structural changes.

Key Points:

• Custom role creation and editing
• Module-level permission control (view, add, edit, delete)
• Role-based dashboards and navigation
• Secure access to sensitive employee and payroll data
• Scalable design for growing teams and departments

The Employee Management System is a core module in any HRM, designed to store and manage comprehensive employee information. This includes personal details, contact information, job titles, departments, joining dates, identification documents, and more. It enables HR teams to view, update, and maintain employee records efficiently.

Features such as document uploads, employment history tracking, and real-time status updates help streamline workforce management. The system also supports bulk import and export of employee data, making it ideal for growing organizations. As the backbone of HR operations, this module integrates seamlessly with payroll, attendance, and performance management systems.

Key Points:

• Centralized employee database
• Employment history tracking
• Document upload and management
• Role and department linking
• Bulk import and export options

The Attendance Management System enables employers to monitor daily employee attendance, track working hours, and analyze punctuality. It supports both manual attendance entries and automatic data synchronization from biometric or RFID systems. Real-time dashboards provide clear insights into late arrivals, early departures, absences, and overall time adherence.

The system integrates directly with payroll, ensuring accurate salary calculations based on actual attendance. It also supports leave deductions and overtime tracking, improving accuracy and transparency. This feature strengthens workplace discipline and provides reliable attendance records for both employees and management.

Key Points:

• Daily clock-in and clock-out tracking
• Manual attendance entry support
• Overtime and late entry monitoring
• Real-time attendance reports and dashboards
• Seamless payroll integration

This module streamlines leave tracking, approval workflows, and balance management across multiple leave types such as casual, sick, and earned leave. Employees can submit leave requests through the system, while managers can review, approve, or reject them with comments. Leave balances are calculated automatically and synchronized with payroll to ensure accurate salary deductions.

The module provides full transparency in leave records, reducing disputes and improving trust. Calendar views display planned absences, holidays, and overlapping leave, enabling better workforce planning. With customizable leave policies and approval hierarchies, this module is well suited for organizations of all sizes.

Key Points:

• Leave request and approval management
• Automatic leave balance calculation
• Customizable leave types and policies
• Calendar integration for planning and visibility
• Seamless payroll synchronization for leave deductions

The Payroll Management System automates the entire salary processing workflow by calculating basic pay, allowances, deductions such as PF, ESI, and TDS, as well as bonuses and incentives. It generates payslips and bank-ready payment files, ensuring timely and accurate salary disbursements. By integrating with attendance, leave, and loan modules, the system minimizes manual errors and improves payroll accuracy.

The system also manages tax declarations, generates statutory reports such as Form 16, and supports compliance with local regulations. With multi-currency support and region-specific tax configurations, it is well suited for organizations with global teams. Secure, role-based access ensures that only authorized HR or finance personnel can manage payroll activities.

Key Points:

• Automated salary calculations
• Payslip generation and bank-ready payment files
• Tax, PF, and ESI deductions
• Integration with attendance and leave modules
• Secure, role-based payroll access

The Loan Management System enables employees to apply for loans directly through the HR portal by specifying the loan amount, purpose, and repayment terms. HR teams can review applications and approve or reject them based on company policies. Once approved, the system automatically schedules EMI deductions through payroll, ensuring timely and accurate repayment.

The module tracks outstanding loan balances, repayment history, and remaining tenure, providing complete visibility for both employees and employers. This structured and transparent approach simplifies employee financial assistance while maintaining accurate payroll records.

Key Points:

• Employee loan application management
• Approval workflows based on company policies
• Automated EMI scheduling and payroll deductions
• Loan balance and repayment history tracking
• Transparent and structured financial management

The Document Management System securely stores employee documents such as ID proofs, resumes, certificates, contracts, and official letters. It enables HR teams to upload, organize, and retrieve files quickly and efficiently. Built-in version control ensures access to the most recent documents, while expiry reminders notify users to update expiring records like visas or employment contracts.

Documents are categorized by type and employee, allowing fast filtering and retrieval. This centralized digital repository reduces paperwork, improves compliance, and simplifies audit preparation. Role-based access controls ensure confidentiality and protect sensitive employee information.

Key Points:

• Centralized document storage
• Expiry alerts for critical documents
• Easy upload and download functionality
• Document categorization by employee and type
• Secure, role-based access control

This module enables organizations to define and manage employee shifts such as day, night, or flexible schedules. Shifts can be assigned to individual employees or entire departments, ensuring proper workforce coverage and balanced workload distribution. The system tracks shift attendance and overtime, integrating seamlessly with attendance and payroll modules for accurate compensation.

Features like shift swap requests and automated notifications help improve employee satisfaction and flexibility. Managers can generate detailed reports on shift patterns, attendance trends, and labor costs, allowing better planning and optimized workforce deployment. This module is especially useful for multi-shift environments commonly found in manufacturing, healthcare, and retail industries.

Key Points:

• Define and assign employee shifts
• Track shift-based attendance and overtime
• Support shift swap requests and notifications
• Generate reports on shift patterns and labor costs
• Seamless integration with payroll and attendance systems

The Grievance Management System provides a structured and confidential platform for employees to report workplace issues or concerns in a professional manner. Employees can submit grievances through their portal, selecting categories such as harassment, policy violations, or work-related disputes. HR teams or designated officers receive notifications, assign cases for investigation, and track resolution status with timestamps and remarks.

This system promotes transparency and builds employee trust while helping reduce workplace conflicts. It maintains proper documentation and audit trails, supporting compliance with labor laws and internal policies. Automated reminders, status updates, and defined resolution timelines ensure grievances are handled fairly, consistently, and on time.

Key Points:

• Confidential grievance submission
• Categorized complaint tracking
• HR escalation and assignment workflows
• Resolution tracking with documentation
• Compliance and audit-ready records

This system streamlines the hiring process by managing job postings, applications, and candidate data within a single platform. Recruiters can create job openings, publish them across multiple channels, and track applicants through each stage, including screening, interviews, and offers. Resume parsing and keyword-based filtering help speed up candidate shortlisting.

Built-in communication tools support automated emails and interview scheduling, improving coordination and candidate experience. The system also maintains a complete candidate history for future openings, enhancing long-term hiring efficiency. Seamless integration with employee onboarding ensures a smooth transition from candidate to employee.

Key Points:

• Job posting and application tracking
• Resume parsing and candidate filtering
• Interview scheduling and automated communication
• Candidate history and talent pool management
• Integration with employee onboarding

The Employee Self-Service (ESS) System empowers employees by providing direct access to their personal and work-related information through a secure portal. Employees can view payslips, attendance records, leave balances, loan status, assigned tasks, and shift schedules, as well as request certificates or profile updates. They can also submit leave applications, grievances, and other requests while tracking their status in real time without needing direct HR intervention.

This self-service approach significantly reduces administrative workload for HR teams, improves transparency, and enhances overall employee satisfaction. With role-based access controls and mobile-friendly support, the ESS system enables secure and flexible self-service across departments and locations.

Key Points:

• Access to payslips, attendance records, and leave balances
• Submit leave, grievance, and loan requests online
• Request certificates and employee documents
• Real-time tracking of request and approval status
• Reduced HR dependency with improved transparency

The Expense Management System simplifies the tracking, submission, and reimbursement of employee expenses. Employees can submit expense claims with receipts for travel, meals, utilities, and other business-related costs. HR or finance teams can review, approve, or reject claims through defined workflows, ensuring compliance with company expense policies.

Each expense claim is tracked by category, project, and employee, with real-time status updates and complete audit trails. Approved expenses are seamlessly integrated with payroll for direct reimbursement, reducing manual effort and processing time. This system improves financial oversight, minimizes paperwork, and increases transparency across departments and projects.

Key Points:

• Submit and manage employee expense claims
• Multi-level approval workflows
• Receipt and document attachment support
• Real-time expense tracking and claim history
• Payroll integration for fast reimbursements

The Asset Management System helps organizations efficiently track and manage physical assets assigned to employees, such as laptops, mobile devices, furniture, and access cards. Each asset is recorded with key details including serial number, purchase date, warranty status, and current condition. HR or administrative teams can assign, transfer, or recover assets during employee onboarding, role changes, or exit processes.

The system also supports maintenance schedules and warranty alerts, reducing downtime, losses, and replacement costs. Employees can request new assets or report damaged items directly through their portal. With detailed logs and comprehensive reports, the Asset Management System supports audits, ensures accountability, and helps optimize asset utilization and cost control.

Key Points:

• Asset issuance, transfer, and return management
• Serial number, warranty, and condition tracking
• Maintenance alerts and asset lifecycle monitoring
• Employee asset requests and issue reporting
• Audit-ready logs and asset inventory reports

The Task or Work Management System enables HR and department managers to assign, monitor, and evaluate tasks and work activities across teams and individual employees. Tasks can be defined with descriptions, deadlines, priority levels, and attachments. Employees can update task status, upload deliverables, add comments, and mark tasks as complete directly from their dashboard.

Managers gain real-time visibility into task progress, can reassign responsibilities when needed, and generate productivity and performance reports. This system enhances communication, improves accountability, and supports performance evaluations. It is especially valuable for project-based teams and departments handling multiple responsibilities at the same time.

Key Points:

• Create and assign tasks with deadlines and priority levels
• Employee self-updates with real-time progress tracking
• Support for comments, attachments, and detailed status logs
• Productivity insights and task completion reports
• Task assignment for individuals or entire teams

PHPPayroll provides a reliable, flexible, and efficient solution for managing payroll and HR operations. Whether you use PHPPayroll Cloud for a fully hosted, hassle-free experience or PHPPayroll Open-Source for complete control and customization, the platform is designed to adapt to your business needs. With powerful features, secure architecture, and scalable design, PHPPayroll helps reduce manual effort, improve accuracy, and simplify payroll management. This documentation equips you with the knowledge needed to successfully implement, customize, and maintain PHPPayroll for smooth and dependable payroll operations.