myadmin-plugins

Creates a new AddonHandler registration block inside a `getAddon` method. Use when user says 'add addon', 'register addon', 'new webhosting addon', or adds a new `load_addons` hook handler. Generates `function_requirements('class.AddonHandler')`, fluent `->set_text()`, `->set_cost()`, `->setEnable()`, `->setDisable()`, `->register()` chain followed by `$service->addAddon()`. Do NOT use for editing existing addons or for non-addon hook handlers.

Adds a new settings field inside getSettings() using add_text_setting or similar method on the MyAdmin\Settings object. Use when user says 'add setting', 'new config option', 'add cost field', 'register a setting', or extends the webhosting.settings handler. Always wraps label/description in _() for i18n and calls setTarget('module') before and setTarget('global') after. Do NOT use for reading settings at runtime or for non-settings configuration.

Adds a new Symfony EventDispatcher hook to src/Plugin.php in the myadmin-ip-webhosting-addon plugin. Use when user says 'add hook', 'register event', 'listen to webhosting event', 'add a new hook key to getHooks', or needs a new static handler method. Generates the getHooks() array entry and the corresponding static handler method with GenericEvent $event signature. Do NOT use for modifying existing hook handlers (getAddon, getSettings) or for non-Plugin.php event wiring.

Writes PHPUnit ^9.6 test cases in `tests/PluginTest.php` for the `Plugin` class static methods. Use when user says 'add test', 'write test', 'test getHooks', 'add coverage', or wants tests for `src/Plugin.php`. Bootstrap is `vendor/autoload.php`, run via `vendor/bin/phpunit`. Do NOT use for integration tests requiring a live WHM server or real DB connections.

Scaffolds WHM/cPanel \xmlapi API calls inside doEnable or doDisable methods. Use when user says 'call WHM', 'use xmlapi', 'set site IP', 'assign dedicated IP', or adds server interaction logic to Plugin.php. Handles function_requirements loading, xmlapi init with hash auth on port 2087, myadmin_log of every response, and admin mail on error. Do NOT use for DirectAdmin or storage service types — those are silently skipped by convention.

Codifies the PayumBuilder + gateway factory + capture/prepare/done/config flow for adding new payment gateways. Use when user says 'add gateway', 'new payment provider', 'configure paypal', 'set up stripe', or adds files to `src/paypal_express_checkout_nvp/` or `src/getting_started/`. Key capabilities: `PayumBuilder->addGateway()`, `Capture` execution, `GetHumanStatus`, token invalidation pattern. Do NOT use for recurring payment setup (use payum-recurring-payment skill instead).

Configures Payum storage backends (Doctrine ORM, MongoDB ODM, Filesystem, Propel2) including Payment/PaymentToken models and DoctrineStorage wiring. Use when user says 'add storage', 'configure doctrine', 'new storage backend', 'payment model', or modifies files in src/storages/. Do NOT use for gateway config, capture flows, or recurring payment setup.

Generates PHPUnit static-analysis tests using assertFileExists + assertStringContainsString(file_get_contents(...)) patterns. Use when user says 'add test', 'write tests', 'test this file', or adds new files to tests/. Covers declare(strict_types=1), Detain\MyAdminPayum\Tests namespace, setUp() with dirname(__DIR__) path construction. Do NOT use for integration tests, live gateway calls, or tests that execute PHP scripts directly.

Codifies the src/Plugin.php static method + GenericEvent pattern for MyAdmin plugin integration. Use when user says 'add hook', 'register event', 'plugin method', 'getMenu', 'getRequirements', 'getSettings', or modifies src/Plugin.php. Covers GenericEvent->getSubject(), has_acl(), add_page_requirement(), function_requirements(). Do NOT use for gateway capture/prepare flows or Payum builder config.

Codifies the PayPal recurring billing lifecycle using Payum: AgreementDetails model → prepare (capture token) → create_recurring_payment (isCaptured guard + CreateRecurringPaymentProfile + Sync + doneToken redirect) → cancel flow. Use when user says 'recurring payment', 'billing profile', 'subscription', 'recurring setup', or modifies src/recurring_payments/. Do NOT use for one-time capture flows or non-PayPal gateways.

Writes PHPUnit 9 tests in `tests/` under namespace `Detain\MyAdminWebhosting\Tests\`. Follows ApiTest.php static string-inspection pattern for `src/api.php` and PluginTest.php ReflectionClass pattern for `src/Plugin.php`. Use when user says 'write test', 'add test case', 'test this function', 'add coverage'. Do NOT use for integration tests that require a live database or MyAdmin framework bootstrap.

Adds a new event hook to src/Plugin.php::getHooks() and implements the corresponding static handler accepting a GenericEvent. Follows the run_event() / get_module_settings() / get_module_db() pattern used in loadProcessing(). Use when user says 'add hook', 'listen to event', 'handle dispatcher event', or adds a new event name. Do NOT use for modifying existing lifecycle callbacks already in loadProcessing() (setEnable, setReactivate, setDisable, setTerminate).

Registers new admin settings in src/Plugin.php::getSettings() using add_dropdown_setting(), add_text_setting(), add_master_checkbox_setting(), or add_master_label(). Includes the defined('CONST') ? CONST : fallback default pattern and correct setTarget('module')/setTarget('global') scope. Use when user says 'add setting', 'new config option', 'expose admin toggle', 'add dropdown toggle', 'add text config'. Do NOT use for settings outside the webhosting plugin or for runtime service-lifecycle changes.

Implements service lifecycle callbacks (setEnable, setReactivate, setDisable, setTerminate) inside src/Plugin.php::loadProcessing(). Covers DB status updates via get_module_db(), TFSmarty email rendering, \MyAdmin\Mail::adminMail(), myadmin_log() error paths, and GenericEvent subevent dispatch. Use when user says 'implement suspend', 'handle termination', 'add reactivation logic', or modifies loadProcessing(). Do NOT use for adding new hook types or creating new Plugin methods outside of loadProcessing.

Creates a new procedural API function in `src/api.php` following the `api_place_buy_website` / `api_validate_buy_website` pattern. Handles `get_custid()`, `function_requirements()`, destructured return arrays, and `$return['status']`/`$return['status_text']` response shape. Use when user says 'add API function', 'new api_*', 'expose endpoint in api.php'. Do NOT use for class-based methods in `src/Plugin.php` or `include/Api/` in the parent myadmin project.

Adds a new static method to src/OpenSRS.php following existing patterns: StatisticClient::tick(), opensrs\Request::process(), request_log(), error handling with myadmin_log(). Use when user says 'add API method', 'new OpenSRS function', 'add domain operation', 'wrap OpenSRS call'. Do NOT use for Plugin.php hooks, test files, or bin/ CLI scripts.

Creates a new OpenSRS CLI script in bin/. Follows the project pattern: require autoload + openSRS_loader.php, json_encode func+attributes, process via opensrs\Request, print formatted output. Use when user says 'add bin script', 'new CLI command', 'add opensrs command', or creates files in bin/. Do NOT use for modifying existing bin scripts.

Creates or extends PHPUnit 9 tests in tests/ following project patterns: ReflectionClass for structure tests, stub functions from tests/bootstrap.php, namespace Detain\MyAdminOpenSRS\Tests. Use when user says 'add test', 'write tests', 'test coverage'. Do NOT use for non-test PHP files.

Adds a new Symfony EventDispatcher hook to src/Plugin.php following the getHooks() pattern: register event name → [Plugin::class, 'methodName'], implement as public static method accepting GenericEvent. Use when user says 'add hook', 'new event handler', 'plugin event', 'register hook', 'listen to event'. Do NOT use for OpenSRS API wrapper methods in OpenSRS.php, CLI bin/ scripts, or test files.

Creates a ReactPHP async SOAP script in bin/async/ for the myadmin-hyperv-vps plugin. Use when user says 'async version', 'non-blocking', 'ReactPHP', or wants a bin/async/ variant of a SOAP operation. Uses React\EventLoop, React\Socket\Connector (TLS verify disabled), React\Http\Browser, Clue\React\Soap\Client and Proxy. Do NOT use for standard synchronous bin/ scripts — those follow a different pattern in bin/ directly.

Writes PHPUnit 9.6 test cases in tests/PluginTest.php under namespace Detain\MyAdminHyperv\Tests\. Use when user says 'write a test', 'add test coverage', 'test this method', or modifies src/Plugin.php. Bootstraps via vendor/autoload.php, references phpunit.xml.dist config. Do NOT use for integration tests against live Hyper-V hosts or bin/ script testing.

Adds or modifies event handler methods in src/Plugin.php for the Detain\MyAdminHyperv namespace using Symfony GenericEvent. Use when user says 'add event', 'hook into', 'register listener', 'plugin event', or extends Plugin.php functionality with new event subscriptions. References getSoapClientParams() and getHooks() patterns. Do NOT use for standalone bin/ scripts or bin/async/ scripts.

Creates a new synchronous SOAP operation script in bin/ following the exact boilerplate from bin/GetVM.php, bin/DeleteVM.php, etc. Use when user says 'add a bin script', 'new SOAP operation', 'create a hyperv command', or adds a new HyperVService method. Generates the ini_set block, argc check, get_service_master() call, getSoapClientParams(), SoapClient instantiation, and exception handler. Do NOT use for async variants (use async-soap-script instead) and do NOT use for Plugin.php method additions.

Adds a new DirectAdmin API function to `src/directadmin.inc.php` using the `directadmin_req()` cURL wrapper. Use when user says 'add API call', 'new DA endpoint', 'call directadmin', or needs a new function in `directadmin.inc.php`. Handles `DIRECTADMIN_USERNAME`/`DIRECTADMIN_PASSWORD` auth and `myadmin_log()` logging automatically via the wrapper. Do NOT use for modifying `Plugin.php` hooks or settings registration.

Implements a complete paid or free DirectAdmin license lifecycle operation (activate/deactivate/change-IP) across Plugin.php and directadmin.inc.php. Use when user says 'add license type', 'support new lifecycle event', 'handle IP change', 'extend free/paid branching logic', or modifies getActivate()/getDeactivate(). Covers run_event('get_free_da_service_types') check, function_requirements() loading, and $serviceClass->setKey()->save() pattern. Do NOT use for settings changes, OS modification, or non-DirectAdmin license plugins.

Writes PHPUnit test methods matching patterns in `tests/DirectadminIncTest.php` and `tests/PluginTest.php`. Use when user says 'write tests', 'add test for', 'test this function', or adds new functions to `src/`. Covers `assertStringContainsString()` source-scan tests, `ReflectionClass` method signature tests, and return value assertions. Do NOT use for integration tests requiring a live DA API or database.

Adds a new event hook to src/Plugin.php following the getHooks() + getRequirements() pattern. Use when user says 'add hook', 'register event', 'handle new license event', or adds a handler method to Plugin. Covers getHooks() registration, getRequirements() loader entry, and static method with GenericEvent $event signature. Do NOT use for modifying existing hooks or adding functions to directadmin.inc.php alone.

Adds or modifies license activation/deactivation functions in `src/litespeed.inc.php` using `\Ganesh\LiteSpeed\LiteSpeedClient`. Covers duplicate-check guard, credit-balance guard, `request_log()` + `myadmin_log()` calls, and admin error email via `\MyAdmin\Mail`. Use when user says 'add activation', 'new provision function', 'deactivate by serial', 'change_ip handler', or modifies LiteSpeed API calls. Do NOT use for Plugin.php hook registration or UI/list page changes.

Applies the dual-logging pattern (request_log + myadmin_log) after every LiteSpeed API call. Use whenever adding or reviewing code that calls LiteSpeedClient or LiteSpeed methods (order, cancel, getLicenseDetails, getBalance). Trigger phrases: 'add logging', 'log the response', 'why no log', 'missing log'. Do NOT use for non-API code paths or generic PHP logging outside the licenses module.

Writes PHPUnit 9 tests in `tests/` under `Detain\MyAdminLiteSpeed\Tests` namespace for the myadmin-litespeed-licensing plugin. Use when user says 'write test', 'add test coverage', 'add tests for X', or adds new functions/methods. Covers three test categories: Plugin class structure (ReflectionClass), procedural function signatures (ReflectionFunction), and file content assertions (string-contains). Do NOT use for integration tests requiring a real database, live LiteSpeed API calls, or tests that exercise actual activation/deactivation logic.

Adds a new static hook handler method to `src/Plugin.php` and registers it in `getHooks()`. Use when user says 'add hook', 'new handler', 'register event', 'add event listener', or when modifying `src/Plugin.php`. Key capabilities: GenericEvent pattern, get_service_define guard, stopPropagation, myadmin_log. Do NOT use for modifying procedural functions in `src/litespeed.inc.php` or `src/litespeed_list.php`.

Registers a new Symfony EventDispatcher hook in getHooks() and implements the handler method in src/Plugin.php. Use when user says 'add hook', 'handle new event', 'listen for X', or needs to respond to a new vps.* event. Follows the GenericEvent type check and stopPropagation() pattern. Do NOT use for modifying existing hooks or adding shell templates (see add-operation skill).

Adds a new setting entry to getSettings() in src/Plugin.php for the myadmin-openvz-vps plugin. Use when user says 'add setting', 'new config option', 'add dropdown', 'new pricing field', or 'out of stock for new location'. Follows the $settings->add_text_setting() / add_dropdown_setting() / add_select_master() pattern with _() i18n wrapping. Do NOT use for reading settings or adding settings to other plugins.

Adds a new shell operation template pair to templates/ and templates/backup/. Use when user says 'add operation', 'new VPS action', 'create template for X', or needs a new shell command executed on containers. Requires creating both templates/{op}.sh.tpl and templates/backup/{op}.sh.tpl. Do NOT use for modifying existing templates or adding PHP hook logic.

Writes or runs PHPUnit tests in tests/PluginTest.php for the myadmin-openvz-vps plugin. Use when user says 'add test', 'write test for', 'run tests', or 'test the plugin'. Covers static property assertions, hook registration, method signature checks, source-code analysis via ReflectionClass, and file/template existence. Do NOT use for integration tests against a live OpenVZ server or tests in other packages.

Writes ModernBill DB queries using get_module_db('mb'). Handles single-row lookup (num_rows check + next_record), multi-row fetch (while loop), real_escape for strings, and int-cast for IDs. Use when user says 'query modernbill', 'look up client', 'fetch invoices from DB', or adds functions to src/modernbill.functions.inc.php. Do NOT use for non-ModernBill modules or PDO.

Creates ACL-gated page handler functions matching the pattern in src/modernbill_client.php, src/modernbill_invoices.php, and src/modernbill_packages.php. Includes page_title, add_js('tablesorter'), has_acl('client_billing') guard, TFTable, TFSmarty with tablesorter/tablesorter.tpl, and Plugin.php registration. Use when user says 'add page', 'new view', 'create handler', or adds files to src/. Do NOT use for Plugin.php class methods or DB helper functions in modernbill.functions.inc.php.

Writes PHPUnit tests following patterns in tests/PluginTest.php, tests/ModernBillFunctionsTest.php, and tests/PageFilesTest.php. Covers file-existence assertions, function-declaration string checks, and ReflectionClass method inspection. Use when user says 'add test', 'write tests for', or adds files to tests/. Do NOT use for integration tests requiring a live DB or for testing runtime behavior that depends on global state ($GLOBALS['tf'], get_module_db).

Adds or modifies Symfony EventDispatcher hooks in src/Plugin.php. Covers getHooks() map entries, add_page_requirement and add_requirement calls with vendor paths, and static method signatures accepting GenericEvent. Use when user says 'add hook', 'register page', 'add requirement', or modifies Plugin.php. Do NOT use for non-plugin class files or page handler files in src/*.php.

Creates a new CLI script in `bin/` following the bootstrap + `function_requirements('class.Swift')` + `new Swift()` pattern. Handles auth via `$sw->authenticate()`, argument parsing via `$_SERVER['argv']`, and output via `echo`/`print_r`. Use when user says 'add bin script', 'new CLI tool', 'command line utility', or adds files to `bin/`. Do NOT use for src/ class changes or Plugin.php modifications.

Writes PHPUnit 9.6 tests under `tests/` in the `Detain\MyAdminSwift\Tests` namespace. Use when user says 'write tests', 'add test coverage', 'PHPUnit', or creates files in `tests/`. Covers structural assertions via ReflectionClass and anonymous-class stubs for dependency injection. Do NOT trigger for production code changes in `src/` or `bin/`.

Adds or modifies event hooks in `src/Plugin.php` using Symfony `GenericEvent` and the `getHooks()` registry. Covers `system.settings` text/password settings and `function.requirements` loader patterns. Use when user says 'add setting', 'register hook', 'new plugin event', or edits `src/Plugin.php`. Do NOT use for `src/Swift.php` or `bin/` changes.

Adds a new method to `src/Swift.php` following the cURL options pattern. Sets up `CURLOPT_HTTPHEADER` with `X-Auth-Token`, disables SSL verify, calls `getcurlpage()`, and parses the response. Use when user says 'add Swift method', 'new container operation', 'add endpoint to Swift', or modifies `src/Swift.php`. Do NOT use for bin scripts or Plugin hook changes.

Adds a new global-namespace API function to `src/api.php` following the existing pattern. Registers it in `Plugin::getRequirements()` and `Plugin::apiRegister()`. Use when user says 'add API function', 'new license operation', 'add endpoint to api.php', or adds a new license action. Do NOT use for modifying `src/Plugin.php` hooks unrelated to API registration.

Adds a new Symfony EventDispatcher hook to src/Plugin.php via getHooks(). Implements handler method receiving GenericEvent $event and calling $event->getSubject(). Use when user says 'add event hook', 'new plugin event', 'handle event', or extends plugin behavior. Do NOT use for adding api.php functions.

Constructs DB queries for the licenses module using `get_module_db('licenses')` and `get_module_settings('licenses')` with proper PREFIX/TABLE interpolation. Use when querying or updating the licenses table, checking license status, or performing CRUD on license records. Trigger phrases: 'query licenses', 'look up license', 'update license status', 'insert license row', 'check if licensed'. Do NOT use PDO, do NOT hardcode table name 'licenses' or column prefix 'license_' directly — always use $settings['TABLE'] and $settings['PREFIX'].

Creates PHPUnit 9 tests in `tests/` using the ReflectionFunction/ReflectionClass pattern from `tests/ApiTest.php` and `tests/PluginTest.php`. Covers function existence, parameter names, parameter counts, optionality, and default values. Use when user says 'write test', 'add test for', 'test the API function', or adds a new function to src/api.php. Do NOT use for integration tests that require a live database, real MyAdmin global functions, or HTTP calls.

Adds admin settings fields via getSettings(GenericEvent $event) using $settings->add_dropdown_setting() or similar methods. Follows the pattern in Plugin::getSettings(). Use when user says 'add setting', 'add config option', 'toggle feature', 'out-of-stock flag', or 'admin configuration'. Do NOT use for service lifecycle changes, hook registration for non-settings events, or $settings array keys in Plugin::$settings.

Writes PHPUnit 9.6 tests under `tests/` using the `Detain\MyAdminDomains\Tests\` namespace and bootstrap from `tests/bootstrap.php`. Use when user says 'add test', 'write unit test', 'test the plugin', or 'test hook handler'. Covers Plugin::getHooks(), Plugin::$settings, static properties, and event handler signatures via ReflectionClass — without requiring the MyAdmin runtime. Do NOT use for integration tests that need a live DB or full MyAdmin bootstrap.

Adds a new Symfony EventDispatcher hook to the Plugin class in src/Plugin.php. Registers in getHooks(), implements a static handler accepting GenericEvent $event, accesses subject via $event->getSubject(). Use when user says 'add hook', 'new event', 'listen for event', or 'register handler'. Do NOT use for modifying existing hooks or for creating new plugin packages.

Implements the setEnable/setReactivate/setDisable callback chain inside loadProcessing() for a MyAdmin plugin module. Use when user says 'add activation logic', 'handle enable', 'send email on reactivate', 'update service status', or 'implement lifecycle callbacks'. Do NOT use for settings panel changes (getSettings) or billing/invoice logic.