PackageTrack
Sign in Get early access

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 2026
2023 2024 2025 2026
Release Pre-release

Releases

latest 20
  1. 3.2.0 05 Jan 2026
    Release notes

    What's Changed

    • Add support for nested sub-WHERE clauses and update hook naming by @dpanta94 in #49

    Full Changelog: 3.1.4...3.2.0

    Open source →
    Release notes
    • Feature - Add support for nested sub-WHERE clauses in paginate() and get_total_items() methods. This allows building complex queries like WHERE (col1 = 'a' OR col2 = 'b') AND col3 = 'c'.
    • Feature - Add new stellarwp_schema_custom_table_paginate_query filter to allow modification of the paginate query before execution.
    • Feature - Add new stellarwp_schema_custom_table_total_items_query filter to allow modification of the total items count query before execution.
    • Tweak - Rename hooks from tec_common_* prefix to stellarwp_schema_* prefix for consistency with the StellarWP namespace.

    Breaking Changes

    The following hooks have been renamed:

    • tec_common_custom_table_query_pre_resultsstellarwp_schema_custom_table_query_pre_results
    • tec_common_custom_table_query_post_resultsstellarwp_schema_custom_table_query_post_results
    • tec_common_custom_table_query_resultsstellarwp_schema_custom_table_query_results
    • tec_common_custom_table_query_wherestellarwp_schema_custom_table_query_where
    Open source →
  2. 3.1.4 17 Oct 2025
    Release notes

    What's Changed

    Full Changelog: 3.1.3...3.1.4

    Open source →
    Release notes
    • Fix - Handle array values correctly in the get_* query methods.
    Open source →
  3. 3.1.3 08 Oct 2025
    Release notes

    What's Changed

    • Properly cache each implementation's schema by @dpanta94 in #47

    Full Changelog: 3.1.2...3.1.3

    Open source →
    Release notes
    • Fix - get_current_schema method will npw cache the schema of each implementation correctly.
    Open source →
  4. 3.1.2 02 Oct 2025
    Release notes

    What's Changed

    Full Changelog: 3.1.1...3.1.2

    Open source →
    Release notes
    • Fix - update_many method will now properly check if the transaction was successful.
    Open source →
  5. 3.1.1 01 Oct 2025
    Release notes

    What's Changed

    • Adding the order by param in the get_all_by method by @dpanta94 in #45

    Full Changelog: 3.1.0...3.1.1

    Open source →
    Release notes
    • Tweak - Fix the get_all_by method to accept an order by clause.
    Open source →
  6. 3.1.0 30 Sep 2025
    Release notes

    What's Changed

    Full Changelog: 3.0.0...3.1.0

    Open source →
    Release notes
    • Feature - Introduce new column types: Blob_Column, Binary_Column, and Boolean_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.
    Open source →
  7. 3.0.0 24 Sep 2025
    Release notes

    What's Changed

    • feat: Introduce v3 strict column definitions and enhanced type safety by @dpanta94 in #43

    Migration docs:

    https://github.com/stellarwp/schema/blob/main/docs/migrating-from-v2-to-v3.md

    Full Changelog: 2.0.1...3.0.0

    Open source →
    Release notes
    • 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.
    Open source →
  8. 2.0.1 18 Jul 2025
    Release notes

    What's Changed

    Full Changelog: 2.0.0...2.0.1

    Open source →
    Release notes
    • Fix - Avoid dead db in multisite installations with too early checks.
    Open source →
  9. 2.0.0 20 May 2025
    Release notes

    What's Changed

    • Bump di52 to 4.0.1 and all other deps by @defunctl in #38. This fixes PHP 8.4 deprecation notices.

    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

    Open source →
    Release notes

    Feature - Bump di52 to 4.0.1 and all other deps.

    Open source →
  10. 1.1.9 26 Feb 2025
    Release notes

    What's Changed

    Full Changelog: 1.1.8...1.1.9

    Open source →
    Release notes
    • Tweak - Add @throws tags from the stellarwp/db library and better generics.
    Open source →
  11. 1.1.8 10 Jan 2025
    Release notes
    • 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.
    Open source →
  12. 1.1.7 06 Jun 2024
    Release notes
    • 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.
    Open source →
  13. 1.1.6 09 Jan 2024

    Nothing published for this version

  14. 1.1.5 30 Nov 2023

    Nothing published for this version

  15. 1.1.4 15 Nov 2023

    Nothing published for this version

  16. 1.1.3 04 Apr 2023
    Release notes
    • Feature - Added Table::has_foreign_key() method.
    Open source →
  17. 1.1.2 22 Nov 2022
    Release notes
    • Tweak - Set the composer's config.platform.php to 7.0.
    Open source →
  18. 1.1.1 08 Oct 2022
    Release notes
    • Fix - Resolves some issues with docblocks that didn't pass PHPStan during actual usage of this library elsewhere.
    Open source →
  19. 1.1.0 07 Oct 2022
    Release notes

    Changed

    • Feature - Added stellarwp/db as a dependency.
    • Tweak - Swapped out direct $wpdb calls with the DB class.
    • Tweak - Reorganized abstract classes and interfaces into Contracts/ directories.
    • Tweak - Removed container and require the setting of a container via the Config class.
    • Tests - Added some tests for index checking on tables.
    Open source →
  20. 1.0.0 17 Aug 2022
    Release notes

    Added

    • Feature - Initial version
    • Docs - Documentation
    • Tests - Automated tests
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive