updates adding tests in and updating readme/composer file

Author: detain

.github/workflows/tests.yml

@@ -0,0 +1,33 @@
+name: Tests
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        php-version: ['8.1', '8.2', '8.3']
+
+    name: PHP ${{ matrix.php-version }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+          extensions: soap
+          coverage: xdebug
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress
+
+      - name: Run tests
+        run: vendor/bin/phpunit --coverage-text

README.md

@@ -1,28 +1,53 @@
-# Cpanel Addon for VPS Module in MyAdmin
+# cPanel VPS Addon for MyAdmin
 
-Cpanel Addon for VPS Module in MyAdmin
+[![Tests](https://github.com/detain/myadmin-cpanel-vps-addon/actions/workflows/tests.yml/badge.svg)](https://github.com/detain/myadmin-cpanel-vps-addon/actions/workflows/tests.yml)
+[![Latest Stable Version](https://poser.pugx.org/detain/myadmin-cpanel-vps-addon/version)](https://packagist.org/packages/detain/myadmin-cpanel-vps-addon)
+[![Total Downloads](https://poser.pugx.org/detain/myadmin-cpanel-vps-addon/downloads)](https://packagist.org/packages/detain/myadmin-cpanel-vps-addon)
+[![License](https://poser.pugx.org/detain/myadmin-cpanel-vps-addon/license)](https://packagist.org/packages/detain/myadmin-cpanel-vps-addon)
 
-## Build Status and Code Analysis
+A MyAdmin plugin that provides cPanel license management as a VPS addon. This package integrates with the MyAdmin hosting management platform to allow automated provisioning, activation, and deactivation of cPanel licenses on VPS instances.
 
-Site          | Status
---------------|---------------------------
-![Travis-CI](http://i.is.cc/storage/GYd75qN.png "Travis-CI")     | [![Build Status](https://travis-ci.org/detain/myadmin-cpanel-vps-addon.svg?branch=master)](https://travis-ci.org/detain/myadmin-cpanel-vps-addon)
-![CodeClimate](http://i.is.cc/storage/GYlageh.png "CodeClimate")  | [![Code Climate](https://codeclimate.com/github/detain/myadmin-cpanel-vps-addon/badges/gpa.svg)](https://codeclimate.com/github/detain/myadmin-cpanel-vps-addon) [![Test Coverage](https://codeclimate.com/github/detain/myadmin-cpanel-vps-addon/badges/coverage.svg)](https://codeclimate.com/github/detain/myadmin-cpanel-vps-addon/coverage) [![Issue Count](https://codeclimate.com/github/detain/myadmin-cpanel-vps-addon/badges/issue_count.svg)](https://codeclimate.com/github/detain/myadmin-cpanel-vps-addon)
-![Scrutinizer](http://i.is.cc/storage/GYeUnux.png "Scrutinizer")   | [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/myadmin-plugins/cpanel-vps-addon/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/myadmin-plugins/cpanel-vps-addon/?branch=master) [![Code Coverage](https://scrutinizer-ci.com/g/myadmin-plugins/cpanel-vps-addon/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/myadmin-plugins/cpanel-vps-addon/?branch=master) [![Build Status](https://scrutinizer-ci.com/g/myadmin-plugins/cpanel-vps-addon/badges/build.png?b=master)](https://scrutinizer-ci.com/g/myadmin-plugins/cpanel-vps-addon/build-status/master)
-![Codacy](http://i.is.cc/storage/GYi66Cx.png "Codacy")        | [![Codacy Badge](https://api.codacy.com/project/badge/Grade/226251fc068f4fd5b4b4ef9a40011d06)](https://www.codacy.com/app/detain/myadmin-cpanel-vps-addon) [![Codacy Badge](https://api.codacy.com/project/badge/Coverage/25fa74eb74c947bf969602fcfe87e349)](https://www.codacy.com/app/detain/myadmin-cpanel-vps-addon?utm_source=github.com&utm_medium=referral&utm_content=detain/myadmin-cpanel-vps-addon&utm_campaign=Badge_Coverage)
-![Coveralls](http://i.is.cc/storage/GYjNSim.png "Coveralls")    | [![Coverage Status](https://coveralls.io/repos/github/detain/db_abstraction/badge.svg?branch=master)](https://coveralls.io/github/detain/myadmin-cpanel-vps-addon?branch=master)
-![Packagist](http://i.is.cc/storage/GYacBEX.png "Packagist")     | [![Latest Stable Version](https://poser.pugx.org/detain/myadmin-cpanel-vps-addon/version)](https://packagist.org/packages/detain/myadmin-cpanel-vps-addon) [![Total Downloads](https://poser.pugx.org/detain/myadmin-cpanel-vps-addon/downloads)](https://packagist.org/packages/detain/myadmin-cpanel-vps-addon) [![Latest Unstable Version](https://poser.pugx.org/detain/myadmin-cpanel-vps-addon/v/unstable)](//packagist.org/packages/detain/myadmin-cpanel-vps-addon) [![Monthly Downloads](https://poser.pugx.org/detain/myadmin-cpanel-vps-addon/d/monthly)](https://packagist.org/packages/detain/myadmin-cpanel-vps-addon) [![Daily Downloads](https://poser.pugx.org/detain/myadmin-cpanel-vps-addon/d/daily)](https://packagist.org/packages/detain/myadmin-cpanel-vps-addon) [![License](https://poser.pugx.org/detain/myadmin-cpanel-vps-addon/license)](https://packagist.org/packages/detain/myadmin-cpanel-vps-addon)
+## Features
 
+- Automated cPanel license activation when a VPS addon is purchased
+- Automated cPanel license deactivation on cancellation with admin email notification
+- IP-based license status checking before activation/deactivation
+- Integration with MyAdmin's event dispatcher for hook-based plugin loading
+- Configurable addon cost via the MyAdmin settings interface
 
 ## Installation
 
-Install with composer like
+Install via Composer:
 
 ```sh
 composer require detain/myadmin-cpanel-vps-addon
 ```
 
-## License
+The package registers itself automatically through the MyAdmin plugin system. The following event hooks are registered:
+
+| Event                   | Handler            | Purpose                                    |
+|-------------------------|--------------------|--------------------------------------------|
+| `function.requirements` | `getRequirements`  | Registers the page requirement function     |
+| `vps.load_addons`       | `getAddon`         | Registers the cPanel addon with the VPS module |
+| `vps.settings`          | `getSettings`      | Adds the cPanel cost setting to the admin UI |
+
+## Configuration
+
+The addon cost is configurable through the MyAdmin admin panel under VPS module settings. The setting `VPS_CPANEL_COST` controls the price charged for the cPanel license addon.
 
-The Cpanel Addon for VPS Module in MyAdmin class is licensed under the LGPL-v2.1 license.
+## Running Tests
+
+```sh
+composer install
+vendor/bin/phpunit
+```
+
+To generate a coverage report:
+
+```sh
+vendor/bin/phpunit --coverage-html build/coverage
+```
+
+## License
 
+This package is licensed under the [LGPL-2.1](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html) license.

composer.json

@@ -26,16 +26,16 @@
 		"detain/cpanel-licensing": "dev-master"
 	},
 	"require-dev": {
-		"phpunit/phpunit": "*",
-		"phpunit/phpunit-mock-objects": "*",
-		"vlucas/phpdotenv": "*",
-		"codeclimate/php-test-reporter": "*",
-		"satooshi/php-coveralls": "*",
-		"codacy/coverage": "*"
+		"phpunit/phpunit": "^9.6"
 	},
 	"autoload": {
 		"psr-4": {
 			"Detain\\MyAdminVpsCpanel\\": "src/"
 		}
+	},
+	"autoload-dev": {
+		"psr-4": {
+			"Detain\\MyAdminVpsCpanel\\Tests\\": "tests/"
+		}
 	}
 }

phpunit.xml.dist

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.6/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+         verbose="true"
+         failOnRisky="true"
+         failOnWarning="true"
+         cacheResultFile=".phpunit.cache/test-results">
+    <testsuites>
+        <testsuite name="Unit">
+            <directory suffix="Test.php">tests</directory>
+        </testsuite>
+    </testsuites>
+    <coverage cacheDirectory=".phpunit.cache/code-coverage"
+              processUncoveredFiles="true">
+        <include>
+            <directory suffix=".php">src</directory>
+        </include>
+        <report>
+            <html outputDirectory="build/coverage"/>
+            <text outputFile="php://stdout" showOnlySummary="true"/>
+            <clover outputFile="build/logs/clover.xml"/>
+        </report>
+    </coverage>
+</phpunit>