Development Guides Home >> Guide to WHM Plugins

Guide to WHM Plugins - AppConfig Checks

Introduction

The AppConfig system's utilities automate several AppConfig functions. This document describes how to perform the following actions via AppConfig utilities:

Check a WHM plugin's AppConfig registration.
List the registered WHM plugins on the server and their configuration settings.

You can also perform the following other actions via AppConfig utilities:

Important:

AppConfig utilities also return information about specific applications in cPanel and Webmail. However, you cannot use the AppConfig system to register cPanel plugins. To register cPanel plugins, read our Guide to cPanel Plugins - Add Plugins documentation.

Note:

The system retrieves the majority of this data from each application's AppConfig configuration file.

Check plugin registration

The /usr/local/cpanel/bin/is_registered_with_appconfig script checks whether an application registered with a specific service in AppConfig.

To use this script, run the following command:

/usr/local/cpanel/bin/is_registered_with_appconfig service appname

Replace service with the desired cPanel & WHM service:
- cpanel — Check for specific cPanel applications.
- whostmgr — Check for WHM plugins .
- webmail — Check for specific Webmail applications.
Replace appname with the desired application's internal name.

For example, to check whether the myplugin plugin exists in WHM, run the following command:

/usr/local/cpanel/bin/is_registered_with_appconfig whostmgr myplugin

The script returns the following output:

1 — The application registered in AppConfig with the specified service.
0 — The application did not register in AppConfig with the specified service.

List registered plugins

The /usr/local/cpanel/bin/show_appconfig script prints a YAML-formatted list of AppConfig applications and their configuration settings.

To use this script, run the following command:

/usr/local/cpanel/bin/show_appconfig

Example output

---
cpanel:
  -
    features:
      - webmail
    name: roundcube
    phpConfig: roundcube
    url: /3rdparty/roundcube/
    user: cpanelroundcube
  -
    features:
      - logaholic
    name: logaholic
    url: /3rdparty/Logaholic
    user: cpanellogaholic
webmail:
  -
    features:
      - webmail
    name: roundcube
    phpConfig: roundcube
    url: /3rdparty/roundcube/
    user: cpanelroundcube
whostmgr:
  -
    acls:
      - all
    name: internal_dnsclustering_root
    url:
      - /cgi/adjustclusterdns.cgi
      - /cgi/adjustclusteroptions.cgi
    user: root