MyListing Bookmarks Page Addon
The {CODICTS} MyListing Bookmarks Page Addon plugin enhances the default bookmarks page in the user dashboard by adding listing type filters, an optional visual preview card layout, and a full interactive calendar view that displays bookmarked events with recurring date support.
Installation & Activation
Start by downloading the plugin from the Downloads page on your dashboard on the CoDicts website.
After downloading, install and activate the plugin in WordPress by navigating to “Plugins” > “Add New” > “Upload Plugin” and selecting the downloaded zip file. Click “Install Now” and then “Activate”.
On activation, the plugin automatically copies its custom bookmarks template into your child theme directory. Navigate to “Bookmarks Page” in the WordPress admin sidebar to configure options.
Important: Both the MyListing theme and a MyListing child theme must be active. Without a child theme, the plugin displays an error notice and does not load.
Key Features
| Feature | Description |
|---|---|
| Listing Type Filters | Users can filter their bookmarked listings by listing type using a dropdown on both the grid and calendar views. |
| Preview Card Display | Optionally replace the default table layout with MyListing’s visual preview cards in a responsive 3-column grid. |
| Calendar View | A full interactive calendar that displays bookmarked events with support for recurring dates (daily and monthly repetitions). |
| Tab Navigation | Users switch between Grid View and Calendar View using tab navigation on the bookmarks page. |
| Remove Bookmarks | Users can remove bookmarks directly from both the grid view and the calendar view. |
| Calendar Language Support | The calendar supports multiple languages: English, Spanish, German, Portuguese, French, Dutch, Italian, plus auto-detection. |
| Time Format Options | Choose between AM/PM or 24-hour time display in the calendar. |
How It Works
The plugin replaces MyListing’s default bookmarks dashboard page with an enhanced version that offers two viewing modes:
Grid View
The Grid View is the default bookmarks display. It shows all of the user’s bookmarked listings with a listing type filter dropdown at the top.
There are two display modes for the grid:
Table layout (default) — Shows listings in a table with Photo, Name, and Actions columns (View Listing and Remove Bookmark buttons).
Preview card layout (optional) — When enabled in settings, replaces the table with MyListing’s visual preview cards arranged in a responsive 3-column grid, matching how listings appear on explore pages.
The grid view paginates at 12 listings per page.
Calendar View
The Calendar View displays bookmarked listings that have event dates on an interactive calendar. Events load dynamically as you navigate between months.
The calendar supports recurring events — daily and monthly repetitions are automatically expanded and shown on each occurrence date. Each event displays its time information: start/end times for single-day events, “Starts” and “Ends” labels for multi-day events, and “All day” for middle days of multi-day events.
Events are color-coded using a rotating palette of 9 colors to help distinguish between different bookmarked listings. Users can click on an event to view the listing or remove the bookmark directly from the calendar.
Note: Only listing types that have a recurring-date field defined appear in the calendar view. Listings without event date fields will not appear on the calendar.
Settings
Navigate to “Bookmarks Page” in the WordPress admin sidebar.
| Setting | Description | Default |
|---|---|---|
| Use listing preview cards template on bookmarks page | Replaces the default table layout with MyListing’s visual preview card grid (3 columns) in the Grid View. | Off |
| Hide calendar view | Completely hides the Calendar View tab. The Grid View becomes the only option. | Off |
| Set calendar tab as default view | When enabled, the Calendar View tab is shown by default when visiting the bookmarks page instead of Grid View. | Off |
| Grid view listing type filters | Choose which listing types appear in the filter dropdown on the Grid View. Leave empty to show all listing types. | All types |
| Calendar view listing type filters | Choose which listing types appear in the filter dropdown on the Calendar View. Leave empty to show all listing types that have event date fields. | All types with events |
| Calendar language | Sets the language for the calendar widget. Options: Auto Detect, English, Spanish, German, Portuguese, French, Dutch, Italian. | English |
| Calendar time format | Sets the time display format in the calendar. Options: AM/PM or 24-Hour. | AM/PM |
Setting Up the Bookmarks Page
1. Activate the plugin. The custom bookmarks template is automatically installed into your child theme.
2. Navigate to “Bookmarks Page” in the admin sidebar.
3. Choose your preferred display mode — check “Use listing preview cards template” if you want the visual card grid instead of the default table.
4. Decide on the calendar view — leave it visible for sites with event listings, or check “Hide calendar view” if your site doesn’t use event dates.
5. Optionally restrict which listing types appear in the filter dropdowns for each view.
6. Set the calendar language and time format if your site serves a non-English audience or uses 24-hour time.
7. Click “Save Changes”.
8. Visit the bookmarks page on the frontend (Dashboard → Bookmarks) to verify everything looks correct.
Template File Management
The plugin works by copying a custom bookmarks.php template into your child theme’s templates/dashboard/ directory. This overrides MyListing’s default bookmarks template.
| Event | What Happens |
|---|---|
| Plugin activation | Template is copied to the child theme. |
| Plugin update | Template is force-reinstalled (overwrites existing file). |
| Plugin deactivation | Template is removed from the child theme. MyListing’s default bookmarks page returns. |
| Theme switch | Template is removed from the old child theme. |
Note: If you manually customize the
bookmarks.phpfile in your child theme, your changes will be overwritten when the plugin is updated or reactivated. Use CSS customizations or WordPress hooks instead of directly editing the template.
Frequently Asked Questions
Why is a child theme required?
The plugin copies a custom template file into the child theme directory. MyListing’s template override system prioritizes child theme templates over the parent theme’s defaults. Without a child theme, there’s nowhere to safely place the custom template.
What happens when I deactivate the plugin?
The custom bookmarks template is automatically removed from your child theme. MyListing’s default bookmarks page is used instead. Your actual bookmarks data is not affected — it stays in the database.
Which listing types appear in the calendar?
Only listing types that have at least one recurring-date field defined in their field configuration appear in the calendar view’s filter dropdown. Listing types without event date fields are excluded because they have no dates to display on the calendar. You can further restrict which types appear in the plugin settings.
How does the calendar handle recurring events?
The plugin expands recurring events (daily and monthly repetitions) so each occurrence appears as a separate event on the calendar. For example, a weekly meetup that repeats every 7 days will show on each occurrence date within the visible month.
Can I change the calendar’s visual theme?
The plugin uses the Evo Calendar “Midnight Blue” theme by default. Other color themes (Orange Coral, Royal Navy) are bundled with the plugin but are not selectable from the settings. To switch themes, custom code modifications would be needed.
Can I customize the bookmarks template?
You can edit the bookmarks.php file in your child theme, but your changes will be overwritten on plugin updates. It’s recommended to use CSS customizations or WordPress hooks for modifications that need to persist.
What’s the difference between the table and preview card layouts?
The table layout shows a simple list with photo, name, and action buttons. The preview card layout uses MyListing’s native preview cards in a 3-column grid, matching how listings appear on explore and search results pages — with images, categories, ratings, and all the visual elements from your preview card configuration.
Can I hide the calendar and just use the grid view?
Yes. Check “Hide calendar view” in the settings. The Calendar View tab will be completely hidden and the Grid View becomes the only option.
Can I set the calendar as the default tab?
Yes. Check “Set calendar tab as default view” in the settings. When users visit the bookmarks page, they’ll see the Calendar View first instead of the Grid View.
Can users remove bookmarks from the calendar?
Yes. Each event in the calendar has a “remove bookmark” option. Clicking it removes the bookmark and the event disappears from the calendar immediately.
Troubleshooting
Bookmarks Page Looks Unchanged (Default Layout)
| Cause | Solution |
|---|---|
| Template not installed | Deactivate and reactivate the plugin to force-reinstall the template into the child theme. |
| Child theme not active | The plugin requires an active child theme. Go to Appearance → Themes and activate a MyListing child theme. |
| Another template override | If you have a different custom bookmarks.php already in your child theme, it may be conflicting. Back up and remove the existing file, then reactivate the plugin. |
Calendar Not Showing Events
| Cause | Solution |
|---|---|
| No recurring-date fields | The calendar only shows listings with recurring-date fields. Ensure the listing types you’re filtering by have at least one recurring-date field defined. |
| No bookmarked events | The user must have bookmarked listings that have event dates set. Bookmark a listing with event dates and check the calendar for the correct month. |
| Calendar type filter too restrictive | Check the “Calendar view listing type filters” in settings. If specific types are selected, only those appear. Clear the selection to show all types with events. |
| Session expired | If the page has been open for a long time, the security token may have expired. Refresh the page to get a new token. |
Calendar View Tab Not Visible
| Cause | Solution |
|---|---|
| “Hide calendar view” is enabled | Go to the plugin settings and uncheck “Hide calendar view.” |
Listing Type Filter Not Showing
| Cause | Solution |
|---|---|
| Only one listing type available | The filter dropdown only appears when 2 or more listing types are available. If your site has only one listing type, the filter is hidden. |
| Filter settings too restrictive | Check the grid or calendar listing type filter settings. If only one type is selected, the dropdown won’t appear. |
Preview Cards Not Displaying Properly
| Cause | Solution |
|---|---|
| Setting not enabled | Check “Use listing preview cards template on bookmarks page” in the settings. |
| CSS conflict | Custom CSS in your child theme may be interfering with the 3-column grid layout. Inspect the page with browser dev tools (F12) to check for conflicting styles. |
“MyListing Theme Not Detected” or “Child Theme Not Detected” Error
Both the MyListing theme and a MyListing child theme must be installed and active. Go to Appearance → Themes to verify.
For further support, visit codicts.com or contact us at support@codicts.com.