PremiumPress
Members
← Back to documentation

Managing Listings & Custom Fields

PremiumPress themes (DirectoryPress, ClassifiedPress, AuctionPress and the other responsive themes) are built around listings and custom fields. This guide covers adding listings, creating and displaying custom fields, working with custom taxonomies, and the most common gotchas.

Adding listings

Listings can be added two ways:

  • Front-end submission ? visitors/members use the "Add Listing" form on your site (controlled by your membership packages).
  • Admin ? you add them directly from the WordPress admin under the listing post type.

If the Add Listing button isn't showing, it's usually controlled by membership/package settings or the page template ? check your package configuration and that the user is logged in with an eligible package.

Custom fields

Custom fields let you capture and display extra data on each listing (price, phone, make/model, features, etc.). You create and manage them in the theme's Custom Fields manager, where each field has a key and a type (text, dropdown/select, checkbox, and so on).

Hiding specific fields from public display

To show all custom fields except certain ones, pass their field keys to the hide parameter of the fields shortcode. Separate multiple keys with commas:

[FIELDS hide="map,Key_Em,Key_Tel,Hd_email"]

Use the exact field keys (not labels), which you'll find in the Custom Fields manager.

Category-specific custom fields

Showing a different set of custom fields depending on the selected category is not built in to the theme as standard ? it requires custom development. Our development team can build this if you need it.

Custom taxonomies

Custom taxonomies let you group listings (by location, brand, type, etc.) and power search/filtering.

  • Display: by default the taxonomy template shows parent items only. To change how taxonomies are displayed, edit the tpl_taxonomies template file in your child theme.
  • Submission form: once you add taxonomy values for users to choose from, they appear in the Add Listing form. If a new taxonomy doesn't appear, clear your cache and re-check.
  • Not showing / 404 errors: the most common cause is permalinks. Go to Settings ? Permalinks and re-save (reset) them ? this resolves the majority of taxonomy display and 404 issues.

Search & location fields

The advanced search form filters by your custom fields and taxonomies. For location-based sites, you can drive search from a location/postcode field and dependent lists (for example, City options populated by the selected Country). If your site targets a single country, you can pre-select and hide the country field via the search template.

Importing listings

The built-in import handles standard listing data, but does not import custom taxonomies. To bulk-import custom taxonomy data (or to import categories in bulk), use a third-party importer such as WP All Import, or have the import customised. Images are stored as an array on each listing for performance, so if you export listings elsewhere you may need to reformat the image data.

Common issues ? quick checklist

  • Taxonomy/category not showing or 404 ? re-save Permalinks.
  • New custom field or taxonomy value not appearing ? clear cache.
  • Field showing when it shouldn't ? add its key to [FIELDS hide="?"].
  • Need per-category fields or checkbox-at-registration behaviour ? custom development.

Need something custom for your listings setup? Our design & development service can help.