pods-framework/pods
Stars: 1024
Forks: 268
Pull Requests: 1784
Issues: 5099
Watchers: 76
Last Updated: 2023-09-14 11:40:10
The Pods Framework is a Content Development Framework for WordPress - It lets you create and extend content types that can be used for any project. Add fields of various types we've built in, or add your own with custom inputs, you have total control.
License: GNU General Public License v2.0
Languages: JavaScript, Shell, PHP, HTML, SCSS
Pods Framework
Pods is a development framework for creating, extending, managing, and deploying customized content types in WordPress.
Description
Check out https://pods.io/ for our User Guide and many other resources to help you develop with Pods.
For detailed setup instructions, visit the official Documentation page.
- You can clone the GitHub repository:
https://github.com/pods-framework/pods.git - Or download it directly as a ZIP file:
https://github.com/pods-framework/pods/archive/main.zip
This will download the latest stable copy of Pods Framework.
Get Support / Help
This is where we develop Pods Framework itself and should not be used for support questions. Please visit the WordPress.org support forums or join our Slack. We have a support page that outlines everything for our plugins.
Reporting Bugs
If you find an issue that you believe to be a bug, let us know.
Requirements
Recommended
- WordPress 5.2+
- PHP 7.3+
- MySQL 5.6+ or MariaDB 10.1+
Minimum
If you have restrictions on your server or site, these are the minimum versions that Pods will be supported to run on. Running the following minimum versions does bring with it their own risks including security and exposure to additional bugs that may have been resolved by the recommended versions above.
- WordPress 4.9+
- PHP 5.6+
- MySQL 5.5+
Contributions Welcome
Anyone is welcome to contribute to Pods Framework. Please read the guidelines for contributing to this repository.
There are various ways you can contribute:
- Raise an Issue on GitHub
- Send us a Pull Request with your bug fixes and/or enhancements
- Translate Pods Framework into different languages via WP Translate, just sign in with your wordpress.org account and add translations where you can
- Provide feedback and suggestions on enhancements
Donations
We're able to focus more on Pods when we have some cash to help keep the lights on, want to help? Become a Friend of Pods!
Developer Notes
- Stable Branch: main is the latest release
- Release Branches:
release/x.x.xholds the code we are working on for each release that is not yet complete
Please submit all pull requests against the main branch.
OPEN ISSUES
See all- Improve List Filters in Pods::filters() by @sc0ttkclark
- Loop Field Type by @viruthagiri
- WP_Query integration by @sc0ttkclark
- Expand Conditional Logic from Pods core into fields by @sc0ttkclark
- slug should use get_page_by_path in some way for heirarchical post types in pods() by @pglewis
- New Field Type: Address / Map by @sc0ttkclark
- input helper documentation by @fizzgig314
- Package Import - loses 'Related to' setting on relationship fields by @sc0ttkclark
- Add user meta fields to add user/registration form. Set user meta upon user creation. by @gunn4r
- Add a dev FAQ to the WP.org plugin page by @pglewis
- cannot remove header icon for ACT by @DovydasS
- USAGE : Advanced Relationships - Database Table by @gigi-budrio
- Internal Pod optimizations for large Pods with many fields (PodsObject, now named Pods\Whatsit) by @sc0ttkclark
- ui filter persistence by @mpatek
- ACT enabling export admin ui option causes all admin UI checkboxes to be checked after save by @rclai
- Slug based relationships by @benfavre
- Relationships created with pods_register_related_object and 'simple' => false don't save. by @lukebrown
- Help text for hierarchical option on taxonomies by @pglewis
- Checkbox fields (Yes/No) are too tall and text does not vertically align with label by @w3st
- get_post_meta() returns array even if $single is set to true for a related post by @pglewis
- Custom Tables and Relationships by @jcampbell05
- Pods class accepting arrays of arrays, or arrays of objects by @pglewis
- Explain Custom Menu Locations better by @sc0ttkclark
- Readonly date field not searchable in advanced filters if read only by @bakaburg1
- Old values on screen display after update an ACT record. by @andrece
- Add Pod: Improve Extend Taxonomy experience w/ Disabled option and direction to enable component by @salidoraul
- First activation welcome message / about screen - see Easy Digital Downloads for example by @sc0ttkclark
- Bug displaying second instance of relationship field value by @pggibson
- Look into PodsUI 'remembering' in meta/session for last known view, try to simplify by @sc0ttkclark
- Make it easier to add custom taxonomies on-the-fly from within Pod Edit for a Post Type (built-in taxonomies, just click "Add New Taxonomy" for inline form) by @sc0ttkclark
- Make it easier to add Custom Post Types, Custom Taxonomies, or Advanced Content Types from within Relationship field editor by @sc0ttkclark
- Fields being overwritten with Polylang Plugin by @Shelob9
- Add alternate form field input style for label on top and input below, instead of label on left and input on right by @sc0ttkclark
- Supposedly empty fields shows values in pods manage page. by @bakaburg1
- Refactor Pods::field() by @sc0ttkclark
- Allow for references to existing item's field values for Relationship Field "Customized" options (where, having, etc) by @sc0ttkclark
- Add modified_author column to built-in Pods columns, for supporting user ID who last edited item, also add logic to force to current user ID in edit forms by @sc0ttkclark
- Moving from Custom Post Types for Pods, Fields, and Groups to a Options Query API, avoiding pitfalls of common issues with large sites with huge post/meta tables by @sc0ttkclark
- Autoload classses avoid conflicts with other autoloaders http://php.net/manual/en/function.spl-autoload-register.php by @unknownnf
- Pods object for users doesn't include last_name or first_name pods::import can not import data to these fields. by @Shelob9
- Issue with limiting user field by Role, deleting that role, and not being able to unselect the role from being limited by @ckpicker
- Add support to widgets for live update in theme customizer @JS_Zao I've fleshed out a full example how to add live-preview support for themes and widgets in Widget Customizer: https://t.co/VxDl9aRdZP by @sc0ttkclark
- Notice: The current user is being initialized without using $wp->init() for using pods with buddypress plugin by @sybarite
- Relationship traversal not working after switching from wp-meta to table-based meta by @tysonlt
- Changing one-directional relationship field to bi-directional relationship does not sync relationship data for the 'new' connection side, only changes related_pod_id / related_field_id in DB which may not be selected on by @sc0ttkclark
- User field not updated by a bi-directional relationship field in CPT by @Shelob9
- Unable to create or import new pod in Multisite by @Pezzab
- Inline Docs For Pods Class by @Shelob9
- Fail to import CPT with required field (WP export/import) by @ccjeagle
- Entering 12:00 AM in time field saves blank by @portstevo
- Tabbed Field Groups by @guilhermevrs
- Using pods_group_add to create custom meta boxes with Tabify fails with 7 boxes by @Shelob9
- Image fields not returned properly when translated by WPML by @Shelob9
- If a CPT is hierarchical you can't set hierarchy in post editor unless supports->page_attributes is checked by @Shelob9
- Can't deselect search filters by @steve-acet
- Inline Docs For PodsForm Class by @Shelob9
- If an extended user pod has got many fields, is needed to run delete process several times by @developez
- Field related to databse table returns error in post editor by @Shelob9
- Bi-directional field error by @KoenRijpstra
- user language by @liuronghuan
- For "overarching performance improvements" by @szepeviktor
- Add support for WordPress Front-end Editor for Pods fields by @sc0ttkclark
- Add support for Visual Composer plugin by @sc0ttkclark
- Interfaces between Custom Fields plugins and Pods by @sc0ttkclark
- autoload size by @szepeviktor
- Migrate-Packages can't upgrade a table pod by @macedd
- export() / export_data() by @mastef
- pods_image_url() no longer forces the image to be generated by @sonicparke
- pods_api_post_save_pod_* actions need $pieces returned by @mastef
- ACT with Required Field Throws No Error When Required Field Isn't Set by @Shelob9
- PHP Notice: Undefined index: HTTP_HOST in pods/includes/general.php on line 475 by @pglewis
- ACT Backend Caching Issue on WPEngine by @pglewis
- how to leverage pods cache by @mastef
- When uploading images via plupload IE9 interprets JSON as text by @Shelob9
- Capabilities: delete_users by @adleviton
- {@id} not working properly in where clause of List Items widget. by @Shelob9
- Impossible to save required boolean fields with value of false by @mfalkvidd
- Find with select issue by @jamesgol
- Old reference to pods_ui_var_update() lingering in PodsMigrate by @pglewis
- Field validation on Import by @szepeviktor
- id is NaN by @basepack
- Ability to duplicate Pods template would be great by @pmsteil
- pods_deprecated obscures typos by @jamesgol
- JS Validation on extended WP object forms by @ghost
- Notice, when querying by relation to taxonomy's custom field by @Shelob9
- foreach behaviour when pod item is related to only 1 pod item by @OWMC
- Pods Markdown() conflicts with Jetpack Markdown() class definition by @TomAuger
- export / export_pod_item_level by @quasel
- 2.5 Server Side Validation - issues by @quasel
- query_var in taxonomy definition - support string not just boolean by @cheekyboots
- ACT - Editor - Capability: pods_add_<pod> ignores Parent Menu ID by @quasel
- 2.4.3 prevents browser caching by @simplistik
- Validation timing by @rmckeel
- Pods CSV Export Bug with Pick Fields by @acenik
- Consolidate all content type storage in 3.0 between Pods_Init::$content_types_registered and Pods_Meta, only need one, must support code-based registration by @PodsBot
- Circle back and clean up any pods_var / pods_var_raw code in 3.0 by @PodsBot
- Add todo markers for any filters/actions that do not have docs by @PodsBot
- Replace any remaining do_hook usage with proper WP filter/action by @PodsBot
- document in a md file how sass/js works with grunt in 3.0 by @PodsBot
- Untranslatable String In jQuery.pods.js by @andre2
- Readability issue with the tooltips when managing fields in a Pod by @NikV
- save_pod_item() don't stop validation after the first "error" lets collect em by @quasel
- Autocomplete error when trying to search other field (not @post_title) by @carherbl
- 3.0 UI.php callbacks looking for apply_filters in the wrong place by @jamesgol
- Number field, with default of zero, no data entered returns an empty string by @PodsBot
- 2.x - current Version - pre Save the Link Icon isnt displayed by @quasel
- Update tip (help) button. by @NikV
- Labels for New Pod do not automatically populate when diacriticals are in the Pod Display Name by @PodsBot
- Time field Type - default 00:00:00 results into current time by @quasel
- Simple Relationship Custom Defined List set as Autocomplete Taggable doesn't save New Entries by @PodsBot
- Private visibility settings are not recognized under Advanced Options, Default Status 'Private' by @PodsBot
- Look into things we may need to do within plugin to upgrade our custom tables for utf8mb4 by @PodsBot
- Edit Pods menu item missing after error creating new pod by @robwent
- Spinner fixes for 4.2 by @PodsBot
- Delete / rename old values when changing field names for Settings fields by @PodsBot
- Pod settings empty by @carlopucci
- Unset field notice PodsAPI triggered by Pods_Unit_Tests\Pods_UnitTestCase::_initialize_data() by @PodsBot
- Search Filters for Advanced Content Types are “over escaping” in Search Form, kicking SQL errors by @PodsBot
- 2.5.2 "breaks" integration with the custom-post-type-permalinks plugin until permalinks resave by @autarch
- For extended comments built-in field "comment_post_ID" is treated as pick, but formed wrong. by @Shelob9
- PodsAPI::reorder_pod_item does not clear cache like save_pod_item, and needs an action hook added after saving by @PodsBot
- If Template component is deactivated - Widget Select Template Field turns to a simple form field by @quasel
- Fatal Error in Pages component when using Precode by @joernschellhaas
- Small bug in PodsForm.php by @basepack
- Look into fixing PodsMeta::get_meta so it always returns proper values (false / null are not expected in normal use from get_post_meta) by @PodsBot
- prev_id() always returns 1 by @telwing
- Pods Admin/- Template edit screen does not display all fields the Songs pod by @ghost
- pods_api_get_table_info_default_post_status doesn't work as expected when previewing a post by @sc0ttkclark
- PECL http_build_url appending ?# on website field. by @pcfreak30
- Admins don't have access to settings pages created by Super Admins in Multisite by @pcfreak30
- PodsData::total_found() breaks when using caching in find() by @PodsBot
- Upgrading from 1.x to 2.x, finishing migration, then clicking delete 1.x data will lock you out of Pods 2.x by @PodsBot
- Can't symlink pods into my plugins directory by @piersb
- Pods cache clearing / not clearing bug by @LinzardMac
- Multiple image field not returning all images when using pods field method with ._src by @smoothblur
- Regression Bug: switch_to_blog & restore_current_blog are not working with Pods since version 2.5 by @jaime8111
- Advanced Content Pods - Manage Permission issue by @gigi-budrio
RELEASES
See all- Pods 1.8.5 by @sc0ttkclark
- Pods 1.8.6 by @sc0ttkclark
- Pods 1.8.7 by @sc0ttkclark
- Pods 1.8.8 by @sc0ttkclark
- Pods 1.8.9 by @sc0ttkclark
- Pods 1.9 by @sc0ttkclark
- Pods 1.9.1 by @sc0ttkclark
- Pods 1.9.2 by @sc0ttkclark
- Pods 1.9.2.1 by @sc0ttkclark
- Pods 1.9.2.2 by @sc0ttkclark
- Pods 1.9.3 by @sc0ttkclark
- Pods 1.9.3.1 by @sc0ttkclark
- Pods 1.9.4 by @sc0ttkclark
- Pods 1.9.5 by @sc0ttkclark
- Pods 1.9.5.1 by @sc0ttkclark
- Pods 1.9.6 by @sc0ttkclark
- Pods 1.9.6.1 by @sc0ttkclark
- Pods 1.9.6.2 by @sc0ttkclark
- Pods 1.9.6.3 by @sc0ttkclark
- Pods 1.9.7 by @sc0ttkclark
- Pods 1.9.7.1 by @sc0ttkclark
- Pods 1.9.7.2 by @sc0ttkclark
- Pods 1.9.7.3 by @sc0ttkclark
- Pods 1.9.7.4 by @sc0ttkclark
- Pods 1.9.8 by @sc0ttkclark
- Pods 1.10 by @sc0ttkclark
- Pods 1.10.1 by @sc0ttkclark
- Pods 1.10.2 by @sc0ttkclark
- Pods 1.10.3 by @sc0ttkclark
- Pods 1.10.4 by @sc0ttkclark
- Pods 1.10.5 by @sc0ttkclark
- Pods 1.10.6 by @sc0ttkclark
- Pods 1.10.7 by @sc0ttkclark
- Pods 1.11 by @sc0ttkclark
- Pods 1.12 by @sc0ttkclark
- Pods 1.12.2 by @sc0ttkclark
- Pods 1.12.3 by @sc0ttkclark
- Pods 1.14 by @sc0ttkclark
- Pods 1.14.1 by @sc0ttkclark
- Pods 1.14.3 by @sc0ttkclark
- Pods 1.14.4 by @sc0ttkclark
- Pods 1.14.6 by @sc0ttkclark
- Pods 1.14.7 by @sc0ttkclark
- Pods 1.14.8 by @sc0ttkclark
- Pods 2.6.10 - July 14th 2017 by @jimtrue
- Pods 2.6.9 - May 30th 2017 by @jimtrue
- Pods 2.6.8 - January 17th 2017 by @jimtrue
- Pods 2.6.7 - August 15th 2016 by @jimtrue
- Pods 2.6.6 - June 23rd 2016 by @jimtrue
- Pods 2.6.5.2 - May 14th 2016 by @jimtrue
- Pods 2.6.5.1 - May 14th 2016 by @jimtrue
- Pods 2.6.5 - May 3rd 2016 by @jimtrue
- Pods 2.6.4 - April 25th 2016 by @jimtrue
- Pods 2.6.3.1 - April 21st 2016 by @jimtrue
- Pods 2.6.3 - April 21st 2016 by @jimtrue
- Pods 2.6.2 - March 24th 2016 by @jimtrue
- Pods 2.6.1 - February 15th 2016 by @jimtrue
- Pods 2.6 December 9th 2015 by @jimtrue
- Pods 2.5.5 - September 16th 2015 by @jimtrue
- Pods 2.5.4 - August 10th 2015 by @jimtrue
- Pods 2.5.3 - June 11th 2015 by @jimtrue
- Pods 2.5.2 - May 14th, 2015 by @jimtrue
- Pods 2.5.1.2 - March 16th, 2015 by @jimtrue
- Pods 2.5.1.1 - January 22nd, 2015 by @jimtrue
- Pods 2.5.1 - January 22nd, 2015 by @jimtrue
- Pods 2.5 - December 30th, 2014 by @jimtrue
- Pods 2.4.3 - June 23rd, 2014 by @jimtrue
- Pods 2.4.2 - June 22nd, 2014 by @jimtrue
- Pods 2.4.1 - June 19th, 2014 by @jimtrue
- Pods 2.4 - April 16th, 2014 by @jimtrue
- Pods 2.3.18 - November 4th, 2013 by @jimtrue
- Pods 2.3.17 - November 4th, 2013 by @jimtrue
- Pods 2.3.16 - November 4th, 2013 by @jimtrue
- Pods 2.3.15 - October 31st, 2013 by @jimtrue
- Pods 2.3.14 - October 29th, 2013 by @jimtrue
- 2.3.12 - October 15th, 2013 by @jimtrue
- Pods 2.3.11 - October 12th, 2013 by @jimtrue
- Pods 2.3.10 - October 11th, 2013 by @jimtrue
- Pods 2.3.9 - August 5th, 2013 by @jimtrue
- Pods 2.3.8 - June 8th, 2013 by @jimtrue
- Pods 2.3.7 - June 7th, 2013 by @jimtrue
- Pods 2.3.6 - May 24th, 2013 by @jimtrue
- Pods 2.3.5.1 - May 20th, 2013 by @jimtrue
- Pods 2.7 - December 4th 2017 by @sc0ttkclark
- Pods 2.6.11 - September 20th 2017 by @sc0ttkclark
- Pods 2.7.1 - December 8th 2017 by @sc0ttkclark
- Pods 2.7.2 - May 3rd 2018 by @sc0ttkclark
- Pods 2.7.2.1 - May 5th 2018 by @sc0ttkclark
- Pods 2.7.3 - May 6th 2018 by @sc0ttkclark
- Pods 2.7.4 - June 6th 2018 by @sc0ttkclark
- Pods 2.7.5 - June 7th 2018 by @sc0ttkclark
- Pods 2.7.6 - June 8th 2018 by @sc0ttkclark
- Pods 2.7.7 - July 26th 2018 by @sc0ttkclark
- Pods 2.7.8 - July 26th 2018 by @sc0ttkclark
- Pods 2.7.9 - August 9th 2018 by @sc0ttkclark
- Pods 2.7.10 - December 5th 2018 by @sc0ttkclark
- 2.7.11 - December 7th 2018 by @sc0ttkclark
- 2.7.12 - December 20th 2018 by @sc0ttkclark
- 2.7.13 - June 28th 2019 by @sc0ttkclark
- 2.7.14 - July 9th 2019 by @sc0ttkclark
- 2.9.8 - September 29th, 2022 by @sc0ttkclark
- 2.9.7 - September 23rd, 2022 by @sc0ttkclark
- 2.9.6 - September 22nd, 2022 by @sc0ttkclark
- 2.9.5 - September 22nd, 2022 by @sc0ttkclark
- 2.9.4 - September 21st, 2022 by @sc0ttkclark
- 2.9.3 - August 18th, 2022 by @sc0ttkclark
- 2.9.2 - August 16th, 2022 by @sc0ttkclark
- 2.9.1 - August 10th, 2022 by @sc0ttkclark
- 2.9 - August 9th, 2022 by @sc0ttkclark
- 2.8.23 - July 4th, 2022 by @sc0ttkclark
- 2.8.22.1 - July 3rd, 2022 by @sc0ttkclark
- 2.8.22 - July 3rd, 2022 by @sc0ttkclark
- 2.8.21 - June 27th, 2022 by @sc0ttkclark
- 2.8.20 - June 17th, 2022 by @sc0ttkclark
- 2.8.19 - June 13th, 2022 by @sc0ttkclark
- 2.8.18 - June 10th, 2022 by @sc0ttkclark
- 2.8.17 - May 11th, 2022 by @sc0ttkclark
- 2.8.16 - May 6th, 2022 by @sc0ttkclark
- 2.8.15 - April 16th, 2022 by @sc0ttkclark
- 2.8.14 - April 15th, 2022 by @sc0ttkclark
- 2.8.13 - April 10th, 2022 by @sc0ttkclark
- 2.8.12 - April 8th, 2022 by @sc0ttkclark
- 2.8.11 - April 8th, 2022 by @sc0ttkclark
- 2.8.10 - February 1st, 2022 by @sc0ttkclark
- 2.8.9 - January 31st, 2022 by @sc0ttkclark
- 2.8.8.1 - December 8th, 2021 by @sc0ttkclark
- 2.8.8 - December 7th, 2021 by @sc0ttkclark
- 2.8.7 - December 1st, 2021 by @sc0ttkclark
- 2.8.6 - November 30th, 2021 by @sc0ttkclark
- 2.8.5 - November 17th, 2021 by @sc0ttkclark
- 2.8.4.1 - November 17th, 2021 by @sc0ttkclark
- 2.8.4 - November 16th, 2021 by @sc0ttkclark
- 2.8.3 - October 28th, 2021 by @sc0ttkclark
- 2.8.2 - October 26th, 2021 by @sc0ttkclark
- 2.8.1 - October 20th, 2021 by @sc0ttkclark
- 2.8 - October 18th, 2021 by @sc0ttkclark
- 2.7.31 - September 23rd, 2021 by @sc0ttkclark
- 2.7.30 - August 12th, 2021 by @sc0ttkclark
- 2.7.29 - August 4th, 2021 by @sc0ttkclark
- 2.6.11.2 - August 4th, 2021 by @sc0ttkclark
- 2.7.28 - May 20th, 2021 by @sc0ttkclark
- 2.7.27 - April 20th, 2021 by @sc0ttkclark
- 2.7.26 - January 8th, 2021 by @sc0ttkclark
- 2.7.25 - December 28th 2020 by @JoryHogeveen
- 2.7.24 - November 5th 2020 by @sc0ttkclark
- 2.7.23 - October 30th 2020 by @sc0ttkclark
- 2.7.22 - August 13th 2020 by @sc0ttkclark
- 2.7.21 - June 30th 2020 by @sc0ttkclark
- 2.7.20.1 - June 4th 2020 by @sc0ttkclark
- 2.6.11.1 - June 4th, 2020 by @sc0ttkclark
- 2.5.5.1 - June 4th, 2020 by @sc0ttkclark
- 2.4.4.1 - June 4th, 2020 by @sc0ttkclark
- 2.4.4 - March 16th 2015 by @sc0ttkclark
- 2.7.20 - April 5th 2020 by @sc0ttkclark
- 2.7.18 - April 3rd 2020 by @sc0ttkclark
- 2.7.17.1 - March 27th 2020 by @JoryHogeveen
- 2.7.17 - March 26th 2020 by @sc0ttkclark
- 2.7.16.2 - November 14th 2019 by @sc0ttkclark
- 2.7.16.1 - November 13th 2019 by @sc0ttkclark
- 2.7.16 - November 13th 2019 by @sc0ttkclark
- 2.7.15 - September 5th 2019 by @sc0ttkclark
- 2.9.10.2 - December 14th, 2022 by @sc0ttkclark
- 2.9.10.1 - December 13th, 2022 by @sc0ttkclark
- 2.9.10 - December 13th, 2022 by @sc0ttkclark
- 2.9.9 - October 31st, 2022 by @sc0ttkclark
- 3.0.1 - September 13th, 2023 by @sc0ttkclark
- 3.0 - September 13th, 2023 by @sc0ttkclark
- 2.9.19 - June 28th, 2023 by @sc0ttkclark
- 2.9.18 - June 23rd, 2023 by @sc0ttkclark
- 2.9.17 - June 22nd, 2023 by @sc0ttkclark
- 2.9.16 - June 10th, 2023 by @sc0ttkclark
- 2.9.15 - May 30th, 2023 by @sc0ttkclark
- 2.9.14 - May 29th, 2023 by @sc0ttkclark
- 3.0 Beta 1 - April 28th, 2023 by @sc0ttkclark
- 2.9.13 - March 15th, 2023 by @sc0ttkclark
- 2.9.12.2 - March 12th, 2023 by @sc0ttkclark
- 2.9.12.1 - March 10th, 2023 by @sc0ttkclark
- 2.9.12 - March 9th, 2023 by @sc0ttkclark
- 2.9.11.1 - January 23rd, 2023 by @sc0ttkclark
- 2.9.11 - January 19th, 2023 by @sc0ttkclark