By risbl

About Risbl Admin

Risbl Admin is a lightweight PHP-based tool designed to make it easy for web developers to create admin menus and fields for their plugins. It’s specifically built for WordPress CMS, offering a simple and efficient way to manage plugin settings.

Check the plugin out and discover the code in GitHub:

Risbl admin repository

You may also want to see the working plugin built on top of it: Risbl Default Page after User Login. Below is the quick preview of it:

Important:

Risbl Admin is currently in BETA mode, which is currently under initial finalization. That’s why supported input fields are still limited. We are working hard to add more.

Documentation:

Code example to configure plugin menu, features administration screen, and pages:

Details:

Risbl Admin Object Call

$setting_page = new Risbl_Admin();

Configuring an Admin Page

$setting_page->config( string[] $config )->add_setting_screen();

Parameter:

$config ( string[] )
An array to define configuration

Config array keys:

  • parent_admin: ( string ) Parent menu page.
  • parent_admin_slug: ( string ) Parent menu page slug.
  • page_title: ( string ) Title of the settings page (appears in the browser tab).
  • menu_title: ( string ) Title of the menu item (appears in the WordPress admin sidebar).
  • capability: ( string ) User capability required to access the menu and settings page. Ref.
  • menu_slug: ( string ) Unique slug for the menu item (used in URLs).
  • icon_url: ( string ) URL or Dashicon class for the menu icon. Ref.
  • position: ( string ) Position of the menu item in the WordPress admin sidebar.
  • tabs: ( string[] ) Associative array of tabs (key: tab slug, value: tab name).
  • tab_param: ( string ) URL parameter used to identify the active tab.
  • tab_index: ( string ) Default tab to display when the settings page is first loaded.
  • has_group: ( string ) Indicates if the settings page uses grouped fields (‘yes’ or ‘no’).
  • group_index: ( string ) Identifier for default group to open.
  • form_wrap: ( string[] ) Opening and closing HTML tags for the settings form (e.g., tag).

Note: parent_admin can accept page slug value.

Adding Admin Page(s)

$setting_page->add_page($page_id, $callback_function);

Parameters:

$page_id ( string )
ID for tab or page

$callback_function ( string )
Function or method name that renders the page content

Note: If the tab ID matches one from the tabs array in $config, the page will appear under that tab. Otherwise, it will be created as a standalone page.