Listdom Advanced Icon Addon Documentation

The Listdom Advanced Icon Addon allows you to assign custom image icons to your listing taxonomies (Categories, Features, and Attributes) for a more visually engaging directory. Instead of generic icons or text, you can upload unique icons for each category, feature, or attribute, which will appear in various parts of your site (such as listing cards, maps, and filters) to help users quickly identify listing types.

Note

This addon adds icon fields for Categories, Features, and Custom Fields.

Icon Upload Fields in Taxonomies

Once activated, the Advanced Icon Addon introduces a new Icon field on the add/edit screens for the supported taxonomies:

• Categories: Go to Listings → Categories. When adding a new category or editing an existing one, you will see an Icon upload field. Here you can upload or select an image (PNG, JPG, SVG, etc.) to represent this category.
• Features: Similarly, under Listings → Features, the add/edit term screen will include an Icon field to assign an image icon to that feature term.
• Attributes (Custom Fields): If you are using custom attributes (available with Listdom Pro), the add/edit screens for those terms also include the Icon picker.

These icon fields allow you to either upload a new image or choose from the media library. After setting an icon and saving the term, Listdom will store the image ID as the term’s icon.

Astuce

For best results, use simple, clear icons (around 64x64 pixels or similar) with transparent backgrounds (PNG/SVG). This ensures they look good in the interface next to text. Listdom will automatically resize icons as needed in the front-end, but starting with a consistent size will give a uniform look.

Display of Custom Icons

With custom icons defined, Listdom will display them in place of default icons or placeholders in various parts of your directory:

• Listing Cards & Lists: If your directory listing design includes icons next to categories or features, the addon ensures your uploaded icon is shown. For example, a hotel listing might show a bed icon (for “Hotel” category) next to the listing title in list view. With Advanced Icon Addon, if you set a custom icon for “Hotel” category, that icon will appear instead of the default symbol.
• Map Markers: When using map views, Listdom typically uses category icons for map markers. Custom icons will be used here as well. If “Restaurant” category has a custom icon (say a fork and knife), map pins for restaurant listings can display that icon within the marker, making the map more informative.
• Filters and Widgets: In any search forms or filter widgets that display taxonomy options (like a list of features with icons), your custom icons will appear alongside the terms. This makes filter sections more user-friendly—for instance, a feature “Pet Friendly” could show a paw icon if set.

By default, if a term has no custom icon, Listdom will continue to show the standard icon or text for that term. The addon only overrides the icon where one is provided.

Steps to Assign Icons

1. Open Taxonomy Term for Editing: Navigate to the taxonomy you want to customize (e.g., Listings → Categories). Click Edit under the specific term (for a new term, click Add New).
2. Upload or Select Icon: In the term edit screen, find the Icon field (usually at the bottom of the form). Click the “Choose Image” or “Upload” button. Use the WordPress media dialog to upload a new icon image or select one from your media library.
3. Save Changes: After selecting an image, click the “Update” (or “Add”) button to save the term. You should now see a thumbnail of the chosen icon when viewing the list of terms.
4. Verify on Front-end: Visit a listing that uses that category/feature. You’ll notice the new custom icon appearing where relevant (for example, on the listing card or map marker). If it’s not immediately visible, ensure your theme or listing skin is set to display icons for that taxonomy.

Note

To remove or change an icon, simply edit the term again and either delete the current image (there may be a remove button) or upload a new one. If an icon is removed and not replaced, the term will revert to showing the default icon or no icon.

Examples

Industry-Specific Category Icons

A business directory assigns unique icons to each category: a briefcase for Consulting, a stethoscope for Healthcare, a fork-and-knife for Restaurants, etc. With these set via the Advanced Icon Addon, the directory’s listing cards and maps show these icons, allowing users to identify listing types at a glance.

Feature Icons for Amenities

A real estate site uses the Features taxonomy for home amenities (Pool, Garage, Garden). The admin uploads a pool icon, car icon, and flower icon for each feature. Now, on each property listing, the amenities section displays these icons next to the text (a pool 🏊 image next to “Swimming Pool”), making the information more visually appealing.