{"id":30310224,"url":"https://github.com/quantumbytestudios/qlyx","last_synced_at":"2025-08-17T14:09:16.322Z","repository":{"id":295302228,"uuid":"989692561","full_name":"QuantumByteStudios/QLYX","owner":"QuantumByteStudios","description":"A lightweight PHP-based web analytics tracker for capturing visitor behavior, user agents, referrers, and more plug-and-play for any page. Decode. Decide. QLYX.","archived":false,"fork":false,"pushed_at":"2025-07-18T08:53:46.000Z","size":86,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-18T12:14:39.152Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/QuantumByteStudios.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-24T16:19:08.000Z","updated_at":"2025-07-18T08:53:50.000Z","dependencies_parsed_at":"2025-05-24T19:36:34.506Z","dependency_job_id":"50f5d733-b1dd-469f-8952-c8e93e45ec65","html_url":"https://github.com/QuantumByteStudios/QLYX","commit_stats":null,"previous_names":["quantumbytestudios/qylx"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/QuantumByteStudios/QLYX","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QuantumByteStudios%2FQLYX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QuantumByteStudios%2FQLYX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QuantumByteStudios%2FQLYX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QuantumByteStudios%2FQLYX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/QuantumByteStudios","download_url":"https://codeload.github.com/QuantumByteStudios/QLYX/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QuantumByteStudios%2FQLYX/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270856775,"owners_count":24657700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-17T14:09:15.769Z","updated_at":"2025-08-17T14:09:16.308Z","avatar_url":"https://github.com/QuantumByteStudios.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QLYX Analytics\n\n**QLYX** is a lightweight PHP-based website analytics tool designed to track and visualize user activity and trends with zero front-end integration.\n\n## Getting Started\n\nQLYX automatically tracks each visit to your page and stores the data for statistical analysis.\n\n## View Analytics\n\nAccess the dashboard to view detailed analytics and visitor trends:\n\n[QLYX Dashboard](QLYX/)\n\n## Integration Guide\n\nTo enable visit tracking on any PHP page, simply include the QLYX script and initialize it as shown below:\n\n```php\n\u003c?php\nrequire_once \"QLYX/qlyx.php\";\nrequire_once \"db-connect.php\";\n\n$qlyx = new QLYX($pdo);\n$qlyx-\u003etrack();\n?\u003e\n```\n\nPlace this code on any page where you want to enable tracking. Make sure to establish a working database connection before calling `$qlyx-\u003etrack()`.\n\n## Setup Requirements\n\nEnsure your `db-connect.php` file contains valid database credentials. This file is used to create a PDO connection instance passed into QLYX.\n\n**Example structure of `db-connect.php`:**\n\n```php\n\u003c?php\n// Configuration for both environments\n$DB_DATABASE_PROD = ''; // Remote/Production DB name\n$DB_USERNAME_PROD = ''; // Remote/Production DB username\n$DB_PASSWORD_PROD = ''; // Remote/Production DB password\n$DB_DATABASE_LOCAL = 'qlyx_local'; // Local DB name\n\n// Determine environment based on hostname\n$isLocalhost = ($_SERVER['SERVER_NAME'] === 'localhost');\n\n// Set connection parameters accordingly\n$SERVER_NAME = 'localhost'; // Assuming DB is on the same server in both cases\n$USERNAME    = $isLocalhost ? 'root' : $DB_USERNAME_PROD;\n$PASSWORD    = $isLocalhost ? ''     : $DB_PASSWORD_PROD;\n$DATABASE    = $isLocalhost ? $DB_DATABASE_LOCAL : $DB_DATABASE_PROD;\n\ntry {\n\t// Establish PDO connection\n\t$pdo = new PDO(\n\t\t\"mysql:host={$SERVER_NAME};dbname={$DATABASE};charset=utf8mb4\",\n\t\t$USERNAME,\n\t\t$PASSWORD,\n\t\t[\n\t\t\tPDO::ATTR_ERRMODE =\u003e PDO::ERRMODE_EXCEPTION, // Throw exceptions on error\n\t\t\tPDO::ATTR_DEFAULT_FETCH_MODE =\u003e PDO::FETCH_ASSOC, // Safe default fetch mode\n\t\t]\n\t);\n} catch (PDOException $e) {\n\t// Output error in development; log it in production\n\tdie(\"Database connection failed: \" . htmlspecialchars($e-\u003egetMessage()));\n}\n?\u003e\n```\n\n## Project Structure\n\n```\n├── QLYX/\n│   └── qlyx.php           # Main tracking logic\n|   └── index.php          # Analytics dashboard\n├── db-connect.php         # Database connection setup\n├── index.php              # Landing page (tracks visits)            \n```\n\n## License\n\nThis project is licensed under the MIT License. See `LICENSE.md` for details.\n\n## Author\n\nDeveloped by QuantumByteStudios. Contributions and suggestions are welcome.  \nFor inquiries, email us at [contact@quantumbytestudios.in](mailto:contact@quantumbytestudios.in).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquantumbytestudios%2Fqlyx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquantumbytestudios%2Fqlyx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquantumbytestudios%2Fqlyx/lists"}