A listing screen is the scrollable list your app shows for a content class — the row-by-row view someone scrolls through before tapping into a single record. MAM gives you a handful of controls over how that view looks: which review and engagement elements show up, what colors the Likes element uses, whether divider lines separate rows, and what image fills in when a record has none of its own.

This guide walks through each control — where to find it and what it changes in your app. They all live together in one spot, so you can knock them out in a single pass.

Goal

Style the listing (list) screens in your app — show or hide stars, favorites, and row dividers; set the Likes element’s colors; and choose a fallback image for records with no image — then preview the result.

Prerequisites

• You’re a WordPress admin who can manage options on the site.
• MAM Main is installed and active.
• At least one content class is set up so you have a listing screen to look at (for example, a WordPress category or a GeoDirectory directory).
• You can load your app in the WP Mobile App Manager Previewer to check your changes. (See Preview your app on a device.)

Keep in mind: everything below is app-wide. Change it once and it applies to every listing screen in the app, not just one content class.

Where these settings live

These controls are part of App Settings, in the Listings section of the General Settings tab.

1. In the WordPress admin, open the MAM App Settings page (the App Settings Manager).
2. Stay on the General Settings tab (it’s the default tab).
3. Scroll to the Listings section, or use the anchor links at the top of the page to jump straight to Listings.

Everything in this guide lives in that one section. Once you’ve made your changes, save with the page’s save control — they’ll take effect on the app’s next content refresh.

Steps

1. Show or hide review stars

Find Hide Review stars? (a Yes/No toggle).

Turn it on and the star rating disappears from reviews shown in your listings — handy if you don’t collect star ratings, or just don’t want them cluttering the list view. Leave it off (the default) and stars keep showing.

This only controls whether the star rating shows. Reviews themselves are a separate setting in this same section — Enable Reviews?, for example — so hiding stars won’t turn reviews off too.

2. Show or hide the favorites (heart) control

Find Hide Favorites (a Yes/No toggle).

Turn this on and the favorites (heart) control disappears from listings, so people can’t favorite a record straight from the list view. Leave it off (the default) and they can tap the heart on any row to save it to their favorites.

It’s worth turning on if your app doesn’t use favorites at all, or if a favorites list would just confuse your audience.

3. Show or hide the divider lines between rows

Find Hide line between table rows? (a Yes/No toggle).

Turn this on and the thin divider lines between rows disappear, giving your list a cleaner, more card-like look. Leave it off to keep the classic separated-row appearance.

It’s purely cosmetic — a visual change to how rows are separated, nothing about the content itself.

4. Set the Likes element colors

Two color pickers control the Likes element shown with listings:

• Likes text color? — the color of the Likes label. Default #000000 (black).
• Likes background color? — the background color behind the Likes element. Default #ffffff (white).

Click each swatch and pick colors that fit your brand. Since these two settings only affect the Likes element, choose values that stay readable against the surrounding list background.

The Likes element shows up wherever likes are surfaced in your app. Not using likes? Leave these at their defaults. A related setting in this same section, Show Likes on Detail Screen?, controls whether likes also appear on the detail screen.

5. Choose a placeholder image

Find Placeholder Image (an image picker).

Upload or select an image to stand in for any listing that has none of its own. This keeps rows looking consistent — records without a photo get your chosen fallback instead of a blank space.

Pick something neutral and on-brand — your logo on a plain background works well — that still reads clearly at the small size a list row uses. MAM publishes this image to the app along with its dimensions, so the app knows how to size it correctly.

6. Save and preview

Save your changes on the App Settings page, then open the WP Mobile App Manager Previewer and load your app to check:

• Stars, favorites, and row dividers appear (or don’t) as you set them.
• The Likes element colors read clearly.
• A record with no image shows your placeholder.

Changes reach the app on its next content refresh, so give the previewer a moment — or trigger a refresh yourself — after you save.

Notes and gotchas

• App-wide, not per-class. Every setting here applies to all listing screens — there’s no per-content-class override for these particular controls.
• “Likes” vs. “Favorites” vs. “Stars” are three different things. Stars are review ratings, Favorites is the heart control that saves a record for later, and the Likes element is a separate engagement piece with its own colors. They’re easy to mix up — the labels above are exactly what you’ll see in the admin.
• Defaults are sensible. Leave everything alone and stars, favorites, and row lines all show, with the Likes element in black text on white. Touch only what you actually want to change.

Related

• Pick your app’s brand colors in the wizard — set the two main brand colors that drive most of the app’s look.
• Preview your app on a device — load the app in the WP Mobile App Manager Previewer to see these changes in context.
• App Setting Reference: listing_hide_stars, listing_hide_favorites, listing_hide_table_row_lines, listing_text_color, listing_background_color, listing_placeholder_image.

What’s next

Once your list view looks right, head to the detail screen next — what shows when someone taps a row — along with the category tab bar and search controls, which also live in the Listings section of General Settings.