PluginProbe ʕ •ᴥ•ʔ
Pods – Custom Content Types and Fields / 3.1.4.3
Pods – Custom Content Types and Fields v3.1.4.3
2.7.31.4 2.8.23.5 2.9.19.5 3.0.10.5 3.1.4.3 3.2.8.4 3.3.9.2 2.8.23.4 2.9.19.4 3.0.10.4 3.1.4.2 3.2.8.3 3.3.9.1 trunk 1.14.8 2.7.31.3 2.8.23.3 2.9.19.3 3.0.10.3 3.1.4.1 3.2.0 3.2.1 3.2.1.1 3.2.2 3.2.4 3.2.5 3.2.6 3.2.7 3.2.7.1 3.2.8 3.2.8.1 3.2.8.2 3.3.0 3.3.1 3.3.2 3.3.3 3.3.4 3.3.5 3.3.6 3.3.7 3.3.8 3.3.9
pods / readme.txt
pods Last commit date
classes 1 day ago components 1 day ago deprecated 1 day ago includes 1 day ago sql 1 day ago src 1 day ago ui 1 day ago vendor 1 day ago changelog.txt 1 day ago init.php 1 day ago license.txt 1 day ago readme.txt 1 day ago
readme.txt
289 lines
1 === Pods - Custom Content Types and Fields ===
2 Contributors: sc0ttkclark, zrothauser, keraweb, jimtrue, quasel, nicdford, jamesgol, ramoonus, pglewis, dan.stefan, Desertsnowman, mgibbs189, Shelob9, clubduece, curtismchale, mikedamage, jchristopher, pcfreak30
3 Donate link: https://friends.pods.io/
4 Tags: pods, custom post types, custom taxonomies, content types, custom fields
5 Requires at least: 6.0
6 Tested up to: 6.5
7 Requires PHP: 7.2
8 Stable tag: 3.1.4.3
9 License: GPLv2 or later
10 License URI: http://www.gnu.org/licenses/gpl-2.0.html
11
12 Pods is a framework for creating, managing, and deploying customized content types and fields for any project.
13
14 == Description ==
15
16 Manage all your custom content needs in one location with the Pods Framework.
17
18 * **Create content types** including Custom Post Types, Custom Taxonomies, and our special Advanced Content Types (ACTs get their own custom tables)
19 * **Extend and customize content types** including Posts, Pages, Categories, Tags, Users, and Media with one easy click
20 * **Create custom settings pages** easily within seconds
21 * **Add custom fields** to *any* content type
22 * **Conditionally show fields** based on the value of other fields with Conditional Logic
23 * **Group your fields** however you'd like into their own sections and add additional headings to help organize
24 * **Show your fields** anywhere using our [blocks](https://docs.pods.io/displaying-pods/pods-blocks/), [shortcodes](https://docs.pods.io/displaying-pods/pods-shortcode/), [widgets](https://docs.pods.io/displaying-pods/pods-widgets/), or the non-coder [Pods Template](https://docs.pods.io/displaying-pods/pods-templates/) approach along with our [automatic theme integration](https://docs.pods.io/displaying-pods/pods-templates/auto-templates/)
25 * **Create connections** between any of your content with [relationship fields](https://docs.pods.io/fields/relationship/) to keep your content organized
26
27 Let Pods help you grow your development and site building skills so that you can manage content beyond the standard WordPress Posts & Pages.
28
29 Want to check it out? Give Pods a test drive with our new [One-click Demo](https://pods.io/demo/).
30
31 Check out our [Documentation](https://docs.pods.io/), [Support Forums](https://wordpress.org/support/plugin/pods/), and our [Live Community Slack Chat](https://support.pods.io/chat/) for assistance building your dream project with Pods.
32
33 = Introduction =
34
35 [youtube https://www.youtube.com/watch?v=0WqKZr2gPZY]
36
37 = Content types that evolve with your needs =
38
39 Create any type of content that you want -- small or large -- we've got you covered. Every content type created with Pods gets all the love it needs to grow up big and strong. You'll get an easy-to-use interface that lets you manage field groups, custom fields, and how your content type will look or function.
40
41 = Create new content types =
42
43 With Pods, you can create entirely new content types and settings pages.
44
45 = Every Field Type, FREE =
46
47 If you choose to use Pods for your custom fields, you'll get every field type you need, free of charge. Pods works great alongside [other custom field plugins](https://comparewp.org/cck) like [Advanced Custom Fields](https://wordpress.org/plugins/advanced-custom-fields/) too.
48
49 We have an extensive collection of over [25 different input types to choose from on 20+ different field types for any content structure](https://docs.pods.io/fields/). Each field type comes with their own additional options to help you customize content entry and display.
50
51 You can also control visibility by role/capability and [other advanced options](https://docs.pods.io/fields/settings-advanced/).
52
53 * **Repeatable Fields:** Turn almost any field into a repeatable field with multiple values
54 * **Text:** Plain Text, Website, Phone, Email, Password
55 * **Paragraph:** Plain Paragraph Text, WYSIWYG (Visual Editor), Code (Syntax Highlighting)
56 * **Date / Time:** Date and Time, Date, Time
57 * **Number:** Plain Number, Currency (30+ international currencies)
58 * **Relationships / Media:** File / Image / Video (Media library and basic upload options available), Avatar (for extended Users), oEmbed, Relationship (Dropdown, Multi Select, Autocomplete, Checkboxes, Radio Buttons, and List View available)
59 * **Checkbox** (Yes / No)
60 * **Color Picker**
61 * **Layout Fields:** Heading text, HTML content
62
63 = Relationships to rule the world with =
64
65 The power is in your hands with our comprehensive support to **relate your content to anything**.
66
67 * **Custom defined lists** of text options
68 * Relate to any **Post Type or Taxonomy** posts / terms
69 * Relate to any **User** profile
70 * Relate to **User Roles or Capabilities**
71 * Relate to any **Comment**
72
73 And many other relationships are also available including:
74
75 * **Image Sizes**
76 * **Navigation Menus**
77 * Relate to content within **any Database Table**
78 * **Countries** (predefined)
79 * **US States** (predefined)
80 * **Canadian Provinces** (predefined)
81 * **Calendar - Days of Week** (predefined)
82 * **Calendar - Months of Year** (predefined)
83 * And many more!
84
85 = Optional Components to do even more =
86 You can enable some of our included components to extend your WordPress site even further:
87
88 * **Types-only Mode** - On our Pods Settings page, you can choose to disable creating custom fields for a performance boost if you only want to use Pods for content types or you plan on using it alongside of other custom field plugins
89 * **Pods Templates** - Use our [template engine](https://docs.pods.io/displaying-pods/pods-templates/) to create templates that can be handed off to clients for care-free management
90 * **Markdown Syntax** - Parses [Markdown Syntax](https://www.markdownguide.org/basic-syntax) for Paragraph Text / WYSIWYG fields
91 * **Advanced Relationships** - Add even more relationship objects including Database Tables, Multisite Networks, Multisite Sites, Themes, Page Templates (in the theme), Sidebars, Post Type Objects, and Taxonomy Objects
92 * **Table Storage** - Enable table-based database storage for custom fields on Post Types, Media, Users, and Comments
93 * **Roles and Capabilities** - Create or edit Roles for your site and customize what they have access to
94 * **Advanced Content Types** - Create entirely custom content types that have their own database table, and they will exist outside the normal WordPress context avoiding meta database tables
95 * **Pods Pages** - Create custom pages that function off of your site's URL path with wildcard support and choose the Page Template in the theme to use -- most useful paired with Advanced Content Types
96
97 = Plugins that integrate with Pods =
98
99 * [Bricks Builder](https://bricksbuilder.io/)
100 * [Codepress Admin Columns](https://wordpress.org/plugins/codepress-admin-columns/) using premium [Admin Columns Pro](https://www.admincolumns.com/pods/) Pods integration
101 * [Conductor](https://conductorplugin.com/)
102 * [Elementor Pro](https://elementor.com/pro/)
103 * [Polylang](https://wordpress.org/plugins/polylang/) has direct integration in Pods itself
104 * [Timber](https://wordpress.org/plugins/timber-library/)
105 * [WPGraphQL](https://wordpress.org/plugins/wp-graphql/) has direct integration in Pods itself
106 * [WPML](http://wpml.org/) has direct integration in Pods itself
107 * [YARPP](http://wordpress.org/plugins/yet-another-related-posts-plugin/) has direct integration in Pods itself
108
109 = Themes that integrate with Pods =
110
111 * [Genesis](https://www.studiopress.com/themes/genesis/) (StudioPress) has direct integration in Pods itself
112
113 = Extend Pods with Free Add-Ons =
114
115 * [Pods Beaver Themer Add-On](https://wordpress.org/plugins/pods-beaver-builder-themer-add-on/) - Integrates Pods with [Beaver Themer](https://www.wpbeaverbuilder.com/beaver-themer/)
116 * [Pods Gravity Forms Add-On](https://wordpress.org/plugins/pods-gravity-forms/) - Integrates Pods with [Gravity Forms](https://www.gravityforms.com/)
117 * [Pods Alternative Cache Add-On](https://wordpress.org/plugins/pods-alternative-cache/) - Speed up Pods on servers with limited object caching capabilities
118 * [Pods SEO Add-On](https://wordpress.org/plugins/pods-seo/) - Integrates Pods Advanced Content Types with Yoast SEO
119 * [Pods AJAX Views Add-On](https://wordpress.org/plugins/pods-ajax-views/) - Adds new functions you can use to output template parts that load via AJAX after other page elements
120
121 = Extend Pods with Free Third-party Add-Ons =
122
123 * [Paid Memberships Pro - Pods Add On](https://wordpress.org/plugins/pmpro-pods/) - Integrates Pods with [Paid Memberships Pro](https://wordpress.org/plugins/paid-memberships-pro/) to extend PMPro objects with custom fields added by Pods
124 * [Panda Pods Repeater Field Add-On](https://wordpress.org/plugins/panda-pods-repeater-field/) - Lets you add groups of fields that repeat and are stored in their own custom database table (Advanced setup required)
125
126 = Pods Pro by SKCDEV Premium Add-Ons =
127
128 * [List Tables Add-On](https://pods-pro.skc.dev/downloads/list-tables/) - A new block and shortcode to list/filter content from Pods in a table format
129 * [Page Builder Toolkit Add-On](https://pods-pro.skc.dev/downloads/page-builder-toolkit/) - Integrates Pods with [Beaver Builder](https://wordpress.org/plugins/beaver-builder-lite-version/), [Beaver Themer](https://www.wpbeaverbuilder.com/beaver-themer/), [Conditional Blocks Pro](https://conditionalblocks.com/), [Divi Theme](https://www.elegantthemes.com/gallery/divi/), [Elementor](https://wordpress.org/plugins/elementor/), [GenerateBlocks](https://wordpress.org/plugins/generateblocks/), [Oxygen Builder](https://oxygenbuilder.com/), and [Stackable Blocks (premium)](https://wpstackable.com/premium/)
130 * [Advanced Relationships Storage Add-On](https://pods-pro.skc.dev/downloads/advanced-relationship-storage/) - Advanced options for relationship storage
131 * [TablePress Integration Add-On](https://pods-pro.skc.dev/downloads/tablepress-integration/) - Integrates Pods with [TablePress](https://wordpress.org/plugins/tablepress/)
132 * [Advanced Permalinks Add-On](https://pods-pro.skc.dev/downloads/advanced-permalinks/) - Advanced permalink structures and taxonomy landing pages
133
134 == Installation ==
135
136 1. Unpack the entire contents of this plugin zip file into your `wp-content/plugins/` folder locally
137 1. Upload to your site
138 1. Navigate to `wp-admin/plugins.php` on your site (your WP Admin plugin page)
139 1. Activate this plugin
140
141 OR you can just install it with WordPress by going to Plugins >> Add New >> and type this plugin's name
142
143 == Frequently Asked Questions ==
144
145 = Where do I go for Support on your plugin? =
146
147 Our primary Support is handled through our [Support Forums](https://wordpress.org/support/plugin/pods/). For the fastest support, you can contact us on our [Live Community Slack Chat](https://support.pods.io/chat/) in the #support channel. We do not staff our Slack channel 24/7, but we do check any questions that come through daily and reply to any unanswered questions.
148
149 We do have a community of Pods users and developers that hang out on Slack, so you're sure to get an answer quickly. We answer our Forum questions once a week with follow-up during the week as we're prioritizing resources towards restructuring and improving our documentation.
150
151 = Where do I report bugs or request features? =
152
153 If you’ve encountered a bug or have an idea for a new feature, we kindly request you to create an Issue on our GitHub Repository at [https://github.com/pods-framework/pods/issues/new](https://github.com/pods-framework/pods/issues/new). Please be very specific about what steps you did to create the issue you’re having and include any screenshots or other configuration parameters to help us recreate or isolate the issue.
154
155 = Will Pods work with my Theme? =
156
157 Most likely the answer is yes. We don't require any special CSS or display attributes to use Pods with your theme, so you should have little to no difficulty showing your content in your theme. If you encounter any issues, contact your theme developer and ask them about their support for the standard WordPress theming functions and how to use [WordPress Template Hierarchy](https://wphierarchy.com) with their theme.
158
159 == How can I translate Pods into my own language? ==
160
161 Many thanks go out to the fine folks who have helped us translate the Pods plugin into many other languages.
162
163 Join us in further translating the Pods interface on the official [Translating WordPress dashboard](https://translate.wordpress.org/projects/wp-plugins/pods)
164
165 We are also available through our [Live Community Slack Chat](https://support.pods.io/chat/) to help our translators get started and to support them on the process.
166
167 Are you looking to translate your Pods and Fields themselves? You'll want to enable the "Translate Pods" component from Pods Admin > Components.
168
169 == Screenshots ==
170
171 1. Create new content types or extend existing ones
172 2. Add groups of fields and manage your content type
173 3. Add fields of many types with individual options for each
174 4. Creating or extending a Post Type will add groups of fields to the Post Editor
175 5. Creating or extending a Taxonomy will add groups of fields to the Term Editor
176 6. Extending Users will add groups of fields to the User Profile and Edit forms
177
178 == Contributors ==
179
180 Pods really wouldn't be where it is without all the contributions from our [donors](https://friends.pods.io) and [code/support contributors](https://github.com/pods-framework/pods/graphs/contributors).
181
182 == Changelog ==
183
184 = 3.1.4.3 - August 31st, 2026 =
185
186 This is a major security hardening release covering multiple areas of the plugin. We recommend updating as soon as possible.
187
188 Additional releases with these security fixes have been backported to each major version of Pods from Pods 2.7 and above to make it easy to update.
189
190 * Security: Restricted display callbacks to an explicit allow list of safe functions, with optional customized additions requiring a dedicated prefix. Added detection and admin notices when disallowed display callbacks are used on a site. (Jakub Herman, @sc0ttkclark)
191 * Security: Refactored form nonce handling to harden against submission misuse. (Jakub Herman, @sc0ttkclark)
192 * Security: Hardened shortcode and block logic against output and query misuse. (Wordfence PRISM - Wordfence, @sc0ttkclark)
193 * Security: Fixed post_status handling in the last security release so it only applies to user-provided inputs (not Pods internal logic). (@sc0ttkclark)
194 * Security: Added anonymous form post handling back that had unintentionally been disabled in the last security release. (@sc0ttkclark)
195
196 = 3.1.4.2 - August 14th, 2026 =
197
198 This is a major security hardening release covering multiple areas of the plugin. We recommend updating as soon as possible.
199
200 Additional releases with these security fixes have been backported to each major version of Pods from Pods 2.8 and above.
201
202 * Security: Further restrictions on error handling and fallbacks. (Nhien Pham @nhienit - GalaxyOne, @thevietronin - GalaxyOne, @sc0ttkclark)
203 * Security: General hardening improvements to how data queries are built and validated. (HaoNH @haoit, @onebitious, @sc0ttkclark)
204 * Security: Additional restrictions on how certain values are processed when displayed. (@sc0ttkclark)
205 * Security: Improved safety when handling previously stored data. (@sc0ttkclark)
206 * Security: Removed a legacy request-handling path that is no longer needed. (HaoNH @haoit, @sc0ttkclark)
207 * Security: Tightened access requirements for certain background requests. (HaoNH @haoit, @sc0ttkclark)
208 * Security: Improved consistency and enforcement of access and validation checks. (Youness HFA from AGBS Pentest Team @YounesHfa, HaoNH @haoit, @onebitious, @sc0ttkclark)
209 * Security: Hardening improvements to file and media handling. (@sc0ttkclark)
210 * Security: Additional safeguards for file and template handling. (@sc0ttkclark)
211 * Security: Improved handling of displayed content. (@sc0ttkclark)
212 * Security: Added extra verification for admin forms and actions. (@sc0ttkclark)
213 * Security: Additional validation for imported content. (@sc0ttkclark)
214 * Security: Improved handling of content based on user permissions. (@sc0ttkclark)
215
216 = 3.1.4.1 - May 8th, 2024 =
217
218 *Security Release*
219
220 * Security hardening: Enforce safe URLs for Pods form submission confirmation page URLs. Props to the wesley (wcraft) / Wordfence for responsibly reporting this. (@sc0ttkclark)
221
222 = 3.1.4 - February 28th, 2024 =
223
224 * Fixed: Defaults now show correctly for checkbox groups in the Edit Field modals. (@sc0ttkclark)
225 * Fixed: Resolve potential PHP errors with cached configs in Collections classes that has been there since Pods 2.x. (@sc0ttkclark)
226 * Fixed: Revisited due to our automated NPM build issue - Resolved an issue with CodeMirror 6.x fields in forms (this is separate from the version 5.x that the Pods Template editor uses). (@sc0ttkclark)
227
228 = 3.1.3 - February 27th, 2024 =
229
230 * Fixed: Resolved an issue with CodeMirror 6.x fields in forms (this is separate from the version 5.x that the Pods Template editor uses). (@sc0ttkclark)
231
232 = 3.1.2 - February 27th, 2024 =
233
234 * Added: Now you can set Content Visibility when creating a new pod. (@sc0ttkclark)
235 * Added: More help text to better explain things on the Access Rights Review screen for extended content types. (@sc0ttkclark)
236 * Added: New option to specify whether to Sanitize Output for a field in the Additional Field Options of Heading, Paragraph, WYSIWYG, Code, and Text fields. (@sc0ttkclark)
237 * Added: Pod Reference metabox on the Pods Templates editor screen now has more help text and will now allow clicking to copy any magic tag to clipboard. (@sc0ttkclark)
238 * Added: Better explain Public vs Publicly Queryable for Post Types and Taxonomies along with showing the current Content Visibility below. (@sc0ttkclark)
239 * Changed: Updated CodeMirror to 5.65.16 so we can start moving towards CodeMirror 6 for the Pods Template editor. (@sc0ttkclark)
240 * Fixed: Resolved issues with Access Rights Review screen when making content type public or private causing it not to be fully set (only public was set on, it left out publicly_queryable). (@sc0ttkclark)
241
242 = 3.1.1 - February 22nd, 2024 =
243
244 This is just a release to retrigger the zip generation on WordPress.org that missed a fix put into the initial 3.1 release tag in SVN.
245
246 Pods 3.1 is a security focused release, see below for the changelog information.
247
248 = 3.1 - February 21st, 2024 =
249
250 *Security Release*
251
252 While this release is meant to be as backwards compatible as possible, some aspects of security hardening may require manual intervention by site owners and their developers. There were no known reports and no known attempts to take advantage of the issues resolved by this release except where noted.
253
254 Read more about [How access rights work with Pods](https://docs.pods.io/displaying-pods/access-rights-in-pods/) for more details including new filters/snippets that can provide limited access.
255
256 * Security hardening: Introduced new access checks and additional fine-grained control over dynamic features across any place in Pods that allows embedding content or forms. This only applies to usage through Pods Blocks or Shortcodes. Using PHP will continue to expect you are handling this on your own unless you pass the appropriate arguments to the corresponding Pods methods. (@sc0ttkclark)
257 * Security hardening: Prevent using the Pods Views Block / Shortcode to embed any files outside of the current theme. Props to the Nex Team / Wordfence for responsibly reporting this. (@sc0ttkclark)
258 * Security hardening: Prevent output of `user_pass`, `user_activation_key`, and `post_password` through Pods dynamic features / PHP. These values will be set in Pods references to `****************` if they were not-empty so you can still do conditional checks as normal. While Scott was already aware of this in pre-planned security release work, additional props go to the Nex Team / Wordfence for responsibly reporting this too. (@sc0ttkclark)
259 * Security hardening: Prevent more unsavory PHP display callbacks from being used with magic tags in addition to those already prevented. Props to the Nex Team / Wordfence for responsibly reporting this. (@sc0ttkclark)
260 * Feature: Access rights > Access-related Admin notices and Errors can be hidden by admins in a new setting in Pods Admin > Settings > Security. (@sc0ttkclark)
261 * Feature: Dynamic Features > Dynamic features (Pods Blocks and Shortcodes) can be disabled by admins in a new setting in Pods Admin > Settings > Security. (@sc0ttkclark)
262 * Changed: Dynamic Features > New installs will now default to not allowing all SQL arguments to be used by dynamic features. Existing installs will default to only allowing simple SQL arguments. All SQL fragments are checked for disallowed usage like subqueries. This can be set in a new setting in Pods Admin > Settings > Security. (@sc0ttkclark)
263 * Feature: Pods Display > The Display-related Pods Blocks and Shortcodes have additional checks that limit access to content based on the user viewing it. For Post Types that are non-public, they must have access to the `read` capability from that post type as a normal user. For displaying content from Users, they must have access to `list_users` capability to view that. [Read more about how access rights work with Pods](https://docs.pods.io/displaying-pods/access-rights-in-pods/) (@sc0ttkclark)
264 * Feature: Pods Forms > The Pods Form Block and Form Shortcode have additional checks that limit access to creating/editing content based on the user submitting the form. For Post Types that are non-public, they must have access to the 'create' capability from that post type as a normal user. Forms that submit to the Users pod, now require that the submitter must have access to the `create_users` or `edit_users` capability to create or edit that user. [Read more about how access rights work with Pods](https://docs.pods.io/displaying-pods/access-rights-in-pods/) (@sc0ttkclark)
265 * Feature: Pods Forms > The Pods Form Block and Form Shortcode now have a new option to identify the form with a custom key you choose that will get passed to various access-related filters so that developers can override access rights more easily. (@sc0ttkclark)
266 * Feature: Pods Forms > When a user has access to create or edit content through a Pods form for a post type, the `post_content` field is cleaned based on the level of access they have to prevent inserting unintentional shortcodes or blocks. (@sc0ttkclark)
267 * Feature: Markdown functionality has now been replaced by the [Parsedown library](https://github.com/erusev/parsedown) for better security and performance and it's uniquely prefixed so it prevents future conflicts with plugins using the same library. (@sc0ttkclark)
268 * Changed: Pods Views > One of the breaking changes in this work is that the Pods Views Block / Shortcode dynamic feature is now disabled by default and must be enabled for new and existing installs. This can be done in a new setting in Pods Admin > Settings > Security. (@sc0ttkclark)
269 * Changed: Display PHP callbacks > New installs will now default to only allowing specific callbacks to be used. This defaults the specific callbacks allowed to `esc_attr,esc_html` which can be further customized in Pods Admin > Settings > Security. (@sc0ttkclark)
270
271 = 3.0.10 - December 11th, 2023 =
272
273 * Fixed: The safe rendering handler for Pods Blocks now properly passes along context to all Pods Blocks so that they work within Query Loops again and other places they could take on context. (@sc0ttkclark)
274 * Fixed: Resolved PHP 8.3 deprecation notice with `get_class()` usage. #7225 (@netlas, @sc0ttkclark)
275 * Fixed: File fields using the direct plupload option will properly avoid uploading files above the limit and handle uploading multiple files without losing all but the first file in the file list. #7138 (@sc0ttkclark, @PD-CM)
276
277 Our GitHub has the full list of all prior releases of Pods: [https://github.com/pods-framework/pods/releases](https://github.com/pods-framework/pods/releases)
278
279 == Upgrade Notice ==
280
281 = 3.1 =
282 This upgrade is security focused.
283
284 = 3.0 =
285 This upgrade requires a minimum versions of PHP 7.2+ and WordPress 6.0+.
286
287 = 2.8 =
288 This upgrade requires a minimum versions of PHP 5.6+ and WordPress 5.5+.
289