Configuring CashMan H.A.: URL, SMTP, Database, CSS

After completing the installation and database import, several environment-specific values must be updated in the source files before the application is ready to use. CashMan H.A. does not use a single .env file — configuration is distributed across a small number of PHP controller files and one CSS file. This page documents every setting, where to find it, and what value to assign for your environment.

Configuration Reference

Setting	File(s)	Variable / Key	Default	Description
Global URL	`controlador/cIniciosSesionesUsuarios.php`, `controlador/cGestionesCashman.php`	`$UrlGlobal`	`http://localhost:90/CashManHA/`	Base URL used for all session redirect targets and links embedded in automated emails
SMTP Host	`controlador/cIniciosSesionesUsuarios.php`, `controlador/cGestionesCashman.php`	PHPMailer `Host`	Papercut (localhost)	SMTP server hostname or IP for outbound email
SMTP Port	Same files	PHPMailer `Port`	`2525`	SMTP port — use `587` for production TLS
SMTP Username	Same files	PHPMailer `Username`	`""` (empty)	SMTP authentication username
SMTP Password	Same files	PHPMailer `Password`	`""` (empty)	SMTP authentication password
DB Host	`modelo/conexion.php`	MySQLi `$servidor`	`localhost`	MySQL server host
DB Name	`modelo/conexion.php`	MySQLi `$base`	`cashmanha`	Database schema name
Timezone	`controlador/cGestionesCashman.php`	`date_default_timezone_set()`	`America/El_Salvador`	PHP runtime timezone for all date/time calculations
CSS Base URL	`vista/css/style.css`	Hardcoded `@import url(...)`	`http://localhost:90`	Base URL used in CSS `@import` rules for icon font stylesheets

Global URL (`$UrlGlobal`)

Both main controller files construct the application base URL at the top of the file. The hostname is read dynamically from $_SERVER['SERVER_NAME'], but the port and path are hardcoded:

// controlador/cIniciosSesionesUsuarios.php  (line ~51)
// controlador/cGestionesCashman.php         (line ~74)

$UrlGlobal = "http://" . $_SERVER['SERVER_NAME'] . ":90" . "/CashManHA" . '/';

Update :90 to reflect the port your web server actually listens on. If running on standard HTTP port 80, omit the port segment entirely:

// Example: standard port 80
$UrlGlobal = "http://" . $_SERVER['SERVER_NAME'] . "/CashManHA/";

// Example: custom port 8080
$UrlGlobal = "http://" . $_SERVER['SERVER_NAME'] . ":8080" . "/CashManHA/";

PHPMailer (SMTP Email)

CashMan H.A. uses PHPMailer to send three categories of transactional email: password-recovery security codes, credential-update confirmation notices, and money-transfer security codes. The same SMTP block appears in both controller files.

$mail = new PHPMailer(true);

$mail->SMTPDebug = 0;       // 0 = no debug output; set to 2 for verbose logging
$mail->isSMTP();
$mail->Host     = '';       // SMTP server hostname (e.g., 'smtp.gmail.com')
$mail->SMTPAuth = true;
$mail->Port     = 2525;     // Default: Papercut local port
$mail->Username = '';       // Your SMTP username / email address
$mail->Password = '';       // Your SMTP password or app password

Update all three instances — two in cIniciosSesionesUsuarios.php (password recovery request and password-change confirmation) and one in cGestionesCashman.php (money-transfer security code) — with your SMTP provider’s details.

For production deployments, replace the Papercut defaults with a real SMTP provider. Gmail SMTP with TLS on port 587 is a common choice:

$mail->Host       = 'smtp.gmail.com';
$mail->Port       = 587;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Username   = 'your-address@gmail.com';
$mail->Password   = 'your-app-password';  // Use a Google App Password, not your account password

Other providers like Mailgun, SendGrid, and Brevo (Sendinblue) work equally well — consult their SMTP credentials documentation for the correct Host and Port values.

Database Credentials

All database connectivity is managed in modelo/conexion.php. The file instantiates the conexion class eight times to create parallel MySQLi connections — one primary ($conectarsistema) and seven auxiliary ($conectarsistema1 through $conectarsistema7) — used across pages with multiple concurrent queries.

class conexion
{
    private $servidor = "localhost"; // MySQL server host
    private $usuario  = "root";      // MySQL username
    private $clave    = "";          // MySQL password
    private $base     = "cashmanha"; // Database schema name
}

Edit these four private properties to match your MySQL server. If you created the schema with a name other than cashmanha, update $base here and re-verify every stored procedure call — the application assumes the default schema name in the connection layer only, not in individual queries.

Timezone

The PHP runtime timezone is set once, at the top of controlador/cGestionesCashman.php:

// controlador/cGestionesCashman.php (line ~64)
date_default_timezone_set('America/El_Salvador');

CashMan H.A. defaults to America/El_Salvador (UTC−6). All date/time values stored and displayed by the application — loan payment due dates, transaction timestamps, scheduled event execution times — are calculated relative to this timezone. If your server is hosted in a different region, update this value to the appropriate PHP timezone identifier (e.g., America/New_York, Europe/Madrid, Asia/Manila) to ensure all timestamps are correct.

CSS Base URL

Several icon font libraries are loaded via absolute @import url(...) rules near the top of vista/css/style.css (lines 62–73). These imports hardcode the default local address:

/* vista/css/style.css — lines 62–73 (default) */
@import url("http://localhost:90/CashManHA/vista/icons/simple-line-icons/css/simple-line-icons.css");
@import url("http://localhost:90/CashManHA/vista/icons/font-awesome-old/css/font-awesome.min.css");
@import url("http://localhost:90/CashManHA/vista/icons/material-design-iconic-font/css/materialdesignicons.min.css");
@import url("http://localhost:90/CashManHA/vista/icons/themify-icons/css/themify-icons.css");
@import url("http://localhost:90/CashManHA/vista/icons/line-awesome/css/line-awesome.min.css");
@import url("http://localhost:90/CashManHA/vista/icons/avasta/css/style.css");
@import url("http://localhost:90/CashManHA/vista/icons/flaticon/flaticon.css");
@import url("http://localhost:90/CashManHA/vista/icons/icomoon/icomoon.css");

Find and replace every instance of http://localhost:90 with your server’s base address. Failure to update these imports will result in missing icons throughout the application UI, because the browser will request the stylesheets from a non-existent host.

Configuration Checklist

Use this checklist before testing your deployment:

Pre-launch configuration checklist

$UrlGlobal updated in controlador/cIniciosSesionesUsuarios.php
$UrlGlobal updated in controlador/cGestionesCashman.php
PHPMailer Host, Port, Username, Password set in cIniciosSesionesUsuarios.php (both instances)
PHPMailer Host, Port, Username, Password set in cGestionesCashman.php
$servidor, $usuario, $clave, $base set correctly in modelo/conexion.php
date_default_timezone_set() updated to your region in controlador/cGestionesCashman.php
All @import url(...) references in vista/css/style.css updated to your server address
Database fully imported and object counts verified (21 tables, 148 stored procedures, 67 views, 21 triggers, 5 events)

Overview

Getting Started

Authentication

Core Modules

Role Portals

Configuring CashMan H.A.: URL, SMTP, Database, CSS

Configuration Reference

Global URL (`$UrlGlobal`)

PHPMailer (SMTP Email)

Database Credentials

Timezone

CSS Base URL

Configuration Checklist

Build docs developers (and LLMs) love

Overview

Getting Started

Authentication

Core Modules

Role Portals

Documentation Index

​Configuration Reference

​Global URL ($UrlGlobal)

​PHPMailer (SMTP Email)

​Database Credentials

​Timezone

​CSS Base URL

​Configuration Checklist

Build docs developers (and LLMs) love

Configuration Reference

Global URL (`$UrlGlobal`)

PHPMailer (SMTP Email)

Database Credentials

Timezone

CSS Base URL

Configuration Checklist