PHPackages loureirorg/settings-as-woocommerce - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. loureirorg/settings-as-woocommerce ActivePackage loureirorg/settings-as-woocommerce ================================== Create WordPress settings pages for your plugin on WooCommerce style. 0.0.4(5y ago)26811[1 issues](https://github.com/loureirorg/settings-as-woocommerce/issues)[2 PRs](https://github.com/loureirorg/settings-as-woocommerce/pulls)mitPHP Since Mar 15Pushed 4y ago2 watchersCompare [ Source](https://github.com/loureirorg/settings-as-woocommerce)[ Packagist](https://packagist.org/packages/loureirorg/settings-as-woocommerce)[ RSS](/packages/loureirorg-settings-as-woocommerce/feed)WikiDiscussions master Synced yesterday READMEChangelogDependencies (1)Versions (7)Used By (0) Settings as Woocommerce ======================= [](#settings-as-woocommerce) Create settings pages for your WordPress plugin on WooCommerce style. This library is a wrapper to actual WooCommerce code. It is not my code, but WooCommerce code, packed in a way that you can use to build your own plugins. Right now this library is manually synced with WooCommerce code from time to time. But in the future it will be automatically updated, whenever WooCommerce pushes a new version to their repo. Settings page structure ----------------------- [](#settings-page-structure) Settings pages are structured on WordPress as: `Menu` > `Submenu` > `Tabs` > `Sections [optional]`. The most basic element on this library is the **Tab**. Each settings page here is a tab. ### Sections or Field Sections? [](#sections-or-field-sections) - `Section`: The menu below tabs; - `Field Section`: A group of fields on each page; Install ------- [](#install) ``` composer require loureirorg/settings-as-woocommerce ``` Usage I - Adding sub-menu to the "Users" menu --------------------------------------------- [](#usage-i---adding-sub-menu-to-the-users-menu) ``` $label = 'My Submenu'; $slug = 'my_submenu'; $menu = 'users'; $my_submenu = new Submenu( $label, $slug, $menu ); $my_submenu ->add_tab( new MyTab1() ) ->add_tab( new MyTab2() ); ``` Usage II - Creating a custom menu with no sub-menus --------------------------------------------------- [](#usage-ii---creating-a-custom-menu-with-no-sub-menus) ``` $my_menu = new Menu( 'My Menu', 'my_menu' ); $my_menu ->add_tab( new MyTab1() ) ->add_tab( new MyTab2() ); ``` Usage III - Creating a custom menu with a sub-menu -------------------------------------------------- [](#usage-iii---creating-a-custom-menu-with-a-sub-menu) ``` $my_menu = new Menu( 'My Menu', 'my_menu' ); $my_submenu = new Submenu( 'My Submenu', 'my_submenu', 'my_menu' ); $my_submenu ->add_tab( new MyTab1() ) ->add_tab( new MyTab2() ); ``` Usage - The Tab definition -------------------------- [](#usage---the-tab-definition) - Create a class extending `Tab`; - Define a constructor and set `id` and `label` properties; - At the end of the constructor, call the parent constructor; - Define methods: `get_fields` and `save`; - \[OPTIONAL\] Define methods `get_sections`, `get_assets`, `get_inline_css`, `get_inline_js`, `get_inline_css`, `get_inline_js`; **Simple Example:** ``` class MyTab1 extends Tab { public function __construct() { $this->id = 'my_tab1'; $this->label = 'My First Tab!'; parent::__construct(); } public function get_settings() { $settings = array( array( 'type' => 'title', 'name' => 'My Field Group' ), array( 'type' => 'checkbox', 'name' => 'My checkbox 1', 'id' => 'my-checkbox-1' ), array( 'type' => 'checkbox', 'name' => 'My checkbox 2', 'id' => 'my-checkbox-2' ), array( 'type' => 'sectionend', 'id' => 'my-field-group-1-end' ), ); return $settings; } public function save() { $this->update_options( $this->get_settings() ); } } ``` **Detailed Example:** ``` class MyTab2 extends Tab { public function __construct() { $this->id = 'my_tab2'; $this->label = 'My Second Tab!'; parent::__construct(); } public function get_sections() { $sections = array( '' => 'Section 1', 'section2' => 'Section 2', 'section3' => 'Section 3', ); return $sections; } public function get_assets( $current_section = '' ) { if ( $current_section == 'section2' ) { return array( 'index.js', 'index.css' ); } return array(); } public function get_inline_css( $current_section = '' ) { if ( $current_section == 'section2' ) { return 'body { background-color: green }'; } return null; } public function get_inline_js( $current_section = '' ) { if ( $current_section == 'section2' ) { return 'alert(1)'; } return null; } public function get_settings( $current_section = '' ) { $settings = array(); if ( '' === $current_section ) { $settings = array( array( 'type' => 'title', 'name' => 'My Section 1A' ), array( 'type' => 'checkbox', 'name' => 'My checkbox 1A', 'id' => 'my-checkbox-1a' ), array( 'type' => 'checkbox', 'name' => 'My checkbox 2A', 'id' => 'my-checkbox-2a' ), array( 'type' => 'sectionend', 'id' => 'my-section-1-end' ), ); } else { $settings = array( array( 'type' => 'title', 'name' => 'My Section 1B' ), array( 'type' => 'checkbox', 'name' => 'My checkbox 1B', 'id' => 'my-checkbox-1b' ), array( 'type' => 'checkbox', 'name' => 'My checkbox 2B', 'id' => 'my-checkbox-2b' ), array( 'type' => 'sectionend', 'id' => 'my-section-1b-end' ), ); } return $settings; } public function save() { $this->update_options( $this->get_settings() ); } } ``` Using WooCommerce Actions and Filters ------------------------------------- [](#using-woocommerce-actions-and-filters) You can use any standard WC filter/action. Just replace the `woocommerce` prefix with your **submenu slug**. **Example:** ``` /** `woocommerce_settings_tabs_array` becomes `mymenu_settings_tabs_array`. */ add_action( 'mymenu_settings_tabs_array', 'add_settings_tab_callback' ); ``` Optional Library Actions ------------------------ [](#optional-library-actions) - `{menu}_load_page`: Triggered when the menu/submenu page is opened. Example: `my_submenu_load_page`; - `{menu}_load_tab_{tab}`: Triggered when the tab page is opened. Example: `my_submenu_load_tab_my_tab`; Optional Menu/Submenu Settings ------------------------------ [](#optional-menusubmenu-settings) - `->set_page_title( 'Title on browser tab' )` - `->set_capability( 'list_users' )` - `->set_position( 90 )` - `->set_icon_url( '/assets/icon.png' )` - `->force_show_tabs()` - `->add_asset( 'index.js' )->add_asset( 'index.css' )` - `->set_inline_css( 'body { background-color: red }' )` - `->set_inline_js( 'alert(1)' )` Optional Tab helpers -------------------- [](#optional-tab-helpers) - `->get_current_section()` - `->update_options( $options )` Usage - Long version: You can use the WC code directly, without the Menu/Submenu/Tab classes. --------------------------------------------------------------------------------------------- [](#usage---long-version-you-can-use-the-wc-code-directly-without-the-menusubmenutab-classes) ``` $wc = new Woocommerce\WC( 'mymenu' ); add_action( 'admin_menu', 'admin_menu_callback' ) ... add_action( 'mymenu_settings_tabs_array', 'add_settings_tab_callback' ); ``` Where to put all this code? =========================== [](#where-to-put-all-this-code) The **menu** definition can be put in your plugin constructor, on the same place where you would place a `add_action( 'admin_menu', 'admin_menu_callback' )`. Each **tab** definition is a separated class definition. It is recommended to put each one on a separated file. To-do ===== [](#to-do) - Create a script to auto-update the WooCommerce code: - Unit Tests for classes `Tab`, `Menu`, `Submenu`, `Helpers`; - Unit Tests for the auto-update code; - Automate tests with GitHub Actions; - Improve README file: - Add screenshots to "Usage" to show the expected result; - Add screenshots to "Settings page structure" and "Sections vs Field Sections"; - Show badges - tests, phpmd, phpcs, version; - Show 2 versions on it: (1) The main version: WC version (used on packagist); (2) Our wrapper code; - Full functional example on "Usage - Long Version": `new WC()` + default WP code to create menus + default WC code to create a settings page; - GitHub Actions - Auto-Update code whenever WooCommerce repo changes: - On each new WC version, we trigger the auto-update + run tests + deploy new version (if tests pass) + push to Packagist with new version; - On each new version of this repo code, we should run tests before accept the PR (Pull Request); - Integration Tests: - Download WP (just like the unit tests for WP); - Auto-update WC code; - Auto-install a plugin that shows a settings page; - Matrix: - Try all PHP versions supported by WP (5.3 .. 7.\*); - Try the most updated WP version, as well as old ones; - To test the auto-update resilience, we should try all WC code versions, since its 1.0; - Functional Tests: - Make sure menu/submenu/tab/section/fields are visible the way they should be; - Use Pupeteer to check if settings pages are rendering properly? Selenium?; Bugs and Improvements ===================== [](#bugs-and-improvements) The goal of this project is to be a simple and **dumb wrapper** to the WooCommerce libraries. While we have some helpers like `set_inline_css()`, I am trying to make this code as little invasive as possible to the WooCommerce code in order to automate the code updates. This means that if you find any issue that can be reproduced on WooCommerce, you should ask them to fix it. If the issue is a WooCommerce issue, it won't be fixed here. For example, let's say you found that some field is being printed without proper sanitization: ask WooCommerce team to fix it. Also, to avoid this code becoming more than a simple wrapper, I will reject most improvements and PR's to it. Rule of thumb is that **improvements and bugs should be asked to the WooCommerce team**. If you are not sure if your bug/improvement fits this project, if you are not sure you should report here or to the WooCommerce team, feel free to open an issue asking me about it. I can't guarantee it will be fixed and/or implemented (mostly not), but I will always be happy to take a look at it :) ### Health Score 24 — LowBetter than 32% of packages Maintenance10 Infrequent updates — may be unmaintained Popularity17 Limited adoption so far Community9 Small or concentrated contributor base Maturity50 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~24 days Total 4 Last Release 2175d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/371973?v=4)[Daniel Loureiro](/maintainers/loureirorg)[@loureirorg](https://github.com/loureirorg) --- Top Contributors [![loureirorg](https://avatars.githubusercontent.com/u/371973?v=4)](https://github.com/loureirorg "loureirorg (5 commits)") ### Embed Badge ![Health badge](/badges/loureirorg-settings-as-woocommerce/health.svg) ``` [![Health](https://phpackages.com/badges/loureirorg-settings-as-woocommerce/health.svg)](https://phpackages.com/packages/loureirorg-settings-as-woocommerce) ``` ### Alternatives [woocommerce/woocommerce An eCommerce toolkit that helps you sell anything. Beautifully. 10.2k173.7k6](/packages/woocommerce-woocommerce)[automattic/jetpack Jetpack supercharges your self‑hosted WordPress site with the awesome cloud power of WordPress.com 3621.9k](/packages/automattic-jetpack)[x-wp/di The dependency injection container for WordPress 301.1k10](/packages/x-wp-di) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)