stellarwp/schema
A library for simplifying the creation and updates of custom tables within WordPress.
3.2.0
638K downloads/mo
#3598 most downloaded on Packagist
stellarwp/schema
What this package is like to depend on
Last release 7 months ago
05 Jan 2026
Release timing varies
gaps range from 8 days to 7 months
Most releases are documented
notes for 17 of 20 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
20 releases · first in 2022
7 releases in the last 12 months
see the full history below
Release timeline
20 releases · Aug 2022 to Jan 2026Releases
latest 20-
3.2.005 Jan 2026Release notes
Open source →- Feature - Add support for nested sub-WHERE clauses in
paginate()andget_total_items()methods. This allows building complex queries likeWHERE (col1 = 'a' OR col2 = 'b') AND col3 = 'c'. - Feature - Add new
stellarwp_schema_custom_table_paginate_queryfilter to allow modification of the paginate query before execution. - Feature - Add new
stellarwp_schema_custom_table_total_items_queryfilter to allow modification of the total items count query before execution. - Tweak - Rename hooks from
tec_common_*prefix tostellarwp_schema_*prefix for consistency with the StellarWP namespace.
Breaking Changes
The following hooks have been renamed:
tec_common_custom_table_query_pre_results→stellarwp_schema_custom_table_query_pre_resultstec_common_custom_table_query_post_results→stellarwp_schema_custom_table_query_post_resultstec_common_custom_table_query_results→stellarwp_schema_custom_table_query_resultstec_common_custom_table_query_where→stellarwp_schema_custom_table_query_where
- Feature - Add support for nested sub-WHERE clauses in
-
3.1.417 Oct 2025 -
3.1.308 Oct 2025Release notes
Open source →- Fix -
get_current_schemamethod will npw cache the schema of each implementation correctly.
- Fix -
-
3.1.202 Oct 2025Release notes
Open source →- Fix -
update_manymethod will now properly check if the transaction was successful.
- Fix -
-
3.1.101 Oct 2025 -
3.1.030 Sep 2025Release notes
Open source →Release notes
Open source →- Feature - Introduce new column types:
Blob_Column,Binary_Column, andBoolean_Column. - Feature - Introduce new PHP type: Blob. Blob will be stored as a base64 encoded string.
- Tweak - Update string based columns to have the ability to become primary keys. Those columns include: char, varchar, binary and varbinary.
- Feature - Introduce new column types:
-
3.0.024 Sep 2025Release notes
Open source →What's Changed
Migration docs:
https://github.com/stellarwp/schema/blob/main/docs/migrating-from-v2-to-v3.md
Full Changelog: 2.0.1...3.0.0
Release notes
Open source →- Feature - Introduces stricter column and indexes definitions. This is NOT a backwards compatible change. Read the migration guide in docs/migrating-from-v2-to-v3.md.
-
2.0.118 Jul 2025Release notes
Open source → -
2.0.020 May 2025Release notes
Open source →What's Changed
Upgrading to 2.0
- To upgrade to 2.x ensure any other libraries using lucatume/di52 are requiring version
^4.0.
Full Changelog: 1.1.9...2.0.0
- To upgrade to 2.x ensure any other libraries using lucatume/di52 are requiring version
-
1.1.926 Feb 2025Release notes
Open source →What's Changed
- Add throws tags and better generics by @defunctl in #36
- Update CHANGELOG.md for release 1.1.9 by @defunctl in #37
Full Changelog: 1.1.8...1.1.9
Release notes
Open source →- Tweak - Add @throws tags from the stellarwp/db library and better generics.
-
1.1.810 Jan 2025Release notes
Open source →- Feature - Introduce truncate method which does what the empty_table method was doing. Update empty_table to actually empty the table instead of truncating it.
- Tweak - Decide if we can create/update during this requests based on blog's status, preventing multiple "check" queries.
-
1.1.706 Jun 2024Release notes
Open source →- Fix -
Collection::get_by_group()now properly works with a single string group name. - Fix -
Group_FilterIterator::count()now properly returns the filtered count and not the base iterator count. - Fix -
Needs_Update_FilterIterator::count()now properly returns the filtered count and not the base iterator count. - Fix - Use proper PSR namespacing for tests.
- Tests - code clean up and file name standardization.
- Fix -
-
1.1.609 Jan 2024Nothing published for this version
-
1.1.530 Nov 2023Nothing published for this version
-
1.1.415 Nov 2023Nothing published for this version
-
1.1.304 Apr 2023 -
1.1.222 Nov 2022 -
1.1.108 Oct 2022Release notes
Open source →- Fix - Resolves some issues with docblocks that didn't pass PHPStan during actual usage of this library elsewhere.
-
1.1.007 Oct 2022Release notes
Open source →Changed
- Feature - Added stellarwp/db as a dependency.
- Tweak - Swapped out direct
$wpdbcalls with theDBclass. - Tweak - Reorganized abstract classes and interfaces into
Contracts/directories. - Tweak - Removed container and require the setting of a container via the
Configclass. - Tests - Added some tests for index checking on tables.
-
1.0.017 Aug 2022Release notes
Open source →Added
- Feature - Initial version
- Docs - Documentation
- Tests - Automated tests