Hacks are extension modules for AlterCPA. You can work with them in the "Control - Hacks and modules" section. In this section, you can view available hacks from AlterCPA developers, create your own hack and change any of its settings.
Installing and configuring the hack
Downloaded and available for installation hacks are displayed in the "Hacks and modules" section. Before use, the module must be installed by clicking the "Install" button. At this point, the database is being prepared for the installed hack.
After installation, you can make basic settings for the hack and activate it. Some hacks, once activated, may provide you with additional customization options. The basic configuration of the hack is performed by clicking the "Settings" button. Once activated, the hack connects to the system.
Important! It is recommended to activate third party hacks on test sites and not on a live system. Once activated, a corrupted hack can bring down the network.
Creating a new hack
You can create your own hacks, or upload third-party hacks through the built-in interface.
To create your own hack, use the form above the list in the control section. Specify the name of the new hack folder. As a name, you can use small Latin characters and numbers. The name must always begin with a letter. It is forbidden to use capital letters and symbols, including hyphenes and underscores.
After creation, the initialization file and the main working file of the hack will be automatically added to the hack. You can change them to your liking through the built-in editor or via FTP.
To install third party hacks, you first need to create a new empty hack with the same name. Name matching is strictly required. If in doubt about the name, open the archive and look at the name of the function in the start file.
Downloading and updating a hack from third-party developers is done by clicking the "Import" button. Select the previously created hack folder, select the hack archive on your computer and click "Import". The hack settings will be updated within a minute.
You can share your created hacks with other AlterCPA users. To do this, click on "Export" in the list of hacks and send the downloaded file. Be sure to specify the name of the hack to install!
Hack structure
All hacks are located in the hack folder on your network. Each hack may include the following files and folders:
start.php- hack start file. Contains the initialization function and the critical functions of the hack itself. Returns a list of hack settings.main.php- hack main file. Super class responsible for loading libraries, including style files, scripts, templates and modules. Can be extended with any desired functions.lib- hack libraries.mod- hack modules.lang- language files.tpl- HTML template files.img,css,js- hack styling files.delivery- delivery service connectors.adv- ad network connectors.params.json- basic settings file, same as styles .schema.php- database schema.update.json- configure hack update.
The hack must contain the start.php file, all other files are optional. Even if you're only creating modifications to language files, use the startup file added by default.
Deleting hacks
The interface does not provide for the removal of hacks through a simple button. This task may not be trivial. Hacks can leave behind configurations, tables, files, and folders. It is recommended to simply disable hacks from the system. If necessary, you can remove the hack folder from the hack folder on your network.