MyListing Listings To Clipboard
The {CODICTS} MyListing Listings To Clipboard plugin adds floating action buttons to the MyListing explore (search/listings) page that allow users to copy listing data directly to the clipboard in two formats. The Email button copies listings as styled HTML cards that appear as rich visual cards when pasted into email clients. The HTML button copies the raw HTML markup as plain text for pasting into HTML editors or CMS content areas. An optional checkbox selection mode lets users choose which listings to copy, and access to each button is controlled through a role-based permission system.
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”.
After activation, navigate to “Listings To Clipboard” in the WordPress admin sidebar to configure which buttons to enable and which user roles can access them.
Important: Both copy buttons are disabled by default. You must visit the settings page, enable the desired buttons, and assign user roles before the buttons appear on the frontend.
Key Features
| Feature | Description |
|---|---|
| Copy Listings for Email | One-click copy of explore page listings as rich styled HTML cards. Paste into email clients and the visual cards appear with background images, titles, dates, and locations. |
| Copy Listings as HTML | One-click copy of listing card markup as raw HTML text. Paste into HTML editors, CMS content areas, or code editors to get the HTML source code. |
| Checkbox Selection | Optional checkboxes on each listing card to selectively choose which listings to copy rather than copying all visible results. |
| Role-Based Access Control | Enable or disable each copy button independently per WordPress user role, including a special “Guest” option for non-logged-in visitors. |
| Floating Button UI | Vertically-oriented floating buttons fixed to the left edge of the screen with a slide-out hover effect. Uses the MyListing theme’s primary brand colour. |
| Dynamic Listing Support | Checkboxes are automatically added to listings loaded dynamically via AJAX, infinite scroll, or pagination. |
How It Works
Two Copy Modes
| Mode | Button Label | What Gets Copied | Best For |
|---|---|---|---|
| Grab Listings For Email | Rich, rendered HTML — pasting into an email client shows styled listing cards with background images, date badges, titles, and locations. | Sharing listings via email with visual formatting intact. | |
| HTML | Grab Listings as HTML | Raw HTML source code as plain text — pasting shows the HTML markup itself. | Embedding listing cards into websites, HTML editors, or CMS content areas. |
What Data Is Captured
When you click a copy button, the plugin reads the visible listing cards on the explore page and captures:
| Data | Source |
|---|---|
| Background image | The listing card’s featured image. |
| Date/tag | The date or tag badge displayed on the card. |
| Title | The listing’s title. |
| Location/contact | The location or contact information shown on the card. |
| URL | The link to the listing’s page. |
Each listing is rendered as a styled card (230px tall with a dark overlay, date badge in the site’s brand colour, white title and location text, and a pin icon) and wrapped in an email-compatible HTML table layout.
Settings Page
Navigate to “Listings To Clipboard” in the WordPress admin sidebar.
| Setting | Default | Description |
|---|---|---|
| Enabled “Grab Listings For Email” Button? | Off | Enables or disables the email copy button globally. |
| Email — Enable for user roles | (none) | Select which WordPress roles can see the email button. Hold Ctrl/Cmd to select multiple. Includes a “Guest (Not logged in)” option for non-authenticated visitors. |
| Enabled “Grab Listings as HTML” Button? | Off | Enables or disables the HTML copy button globally. |
| HTML — Enable for user roles | (none) | Select which WordPress roles can see the HTML button. Same role options as above. |
| Enabled Checkbox Selector on Listings? | Off | Adds selection checkboxes to each listing card on the explore page. Applies to all users who can see a copy button. |
Note: The role selector only appears when the corresponding button is enabled. Each button has its own independent role configuration — you can allow different roles for the Email button vs. the HTML button.
Configuring the Copy Buttons
Step 1: Enable a Button
1. Navigate to “Listings To Clipboard” in the admin sidebar.
2. Check the toggle for the button you want to enable (e.g., “Enabled Grab Listings For Email Button?”).
3. A role selector appears below the toggle.
Step 2: Assign User Roles
4. In the “Enable for user roles” multi-select, choose which roles should see this button. Hold Ctrl (or Cmd on macOS) to select multiple roles:
| Role Option | Description |
|---|---|
| Guest (Not logged in) | Non-authenticated visitors can see and use the button. |
| Administrator | WordPress administrators. |
| Editor, Author, Subscriber, etc. | Standard WordPress roles. All editable roles on your site are listed. |
5. Click “Save Changes.”
6. Repeat for the other button if desired. Each button is configured independently.
Step 3 (Optional): Enable Checkboxes
7. Check “Enabled Checkbox Selector on Listings?” and save. When enabled, every listing card on the explore page displays a checkbox in the top-right corner. All checkboxes are checked by default — users can uncheck listings they want to exclude from the copy.
Using the Copy Buttons
After configuring the settings, visit the MyListing explore page (the search/listings page) while logged in with an authorized role (or as a guest if “Guest” is enabled).
1. Floating buttons appear on the left edge of the screen. Hover over them to slide them out.
2. If checkboxes are enabled, uncheck any listings you want to exclude from the copy.
3. Click a copy button:
| Button | What Happens |
|---|---|
| Grab Listings For Email | Copies styled listing cards as rich HTML to your clipboard. Open your email client, paste into the email body, and the visual cards appear with images, titles, dates, and locations. |
| Grab Listings as HTML | Copies the raw HTML source code as plain text. Paste into an HTML editor, CMS, or code editor to get the markup. |
Note: The buttons only appear on pages with the MyListing explore widget. They do not appear on single listing pages, archive pages, or other page types.
Checkbox Selection Mode
When the checkbox option is enabled in settings, each listing card on the explore page gets a checkbox in its top-right corner.
| Behavior | Description |
|---|---|
| Default state | All checkboxes are checked — all listings are included in copy operations. |
| Uncheck to exclude | Uncheck the listings you don’t want to copy. Only checked listings are included when you click a copy button. |
| Dynamic listings | Listings loaded via AJAX, infinite scroll, or “Load more” pagination automatically receive checkboxes too. |
| No checkboxes enabled | When this setting is off, clicking a copy button copies all visible listings on the page. |
Example — Sharing Listings via Email
1. Activate the plugin with the MyListing theme active.
2. Navigate to “Listings To Clipboard” settings. Enable the “Grab Listings For Email” button and select “Administrator” and “Editor” as allowed roles. Enable checkboxes. Save.
3. Visit the explore page while logged in as an administrator. The floating “Grab Listings For Email” button appears on the left side. Listing cards show checkboxes.
4. Search for listings you want to share. Uncheck any you don’t want to include.
5. Click “Grab Listings For Email.” The styled listing cards are copied to your clipboard.
6. Open your email client (Gmail, Outlook, Apple Mail, etc.). Create a new email and paste. The listing cards appear as styled visual cards with background images, date badges, titles, and location pins.
Example — Embedding Listings in a Page
1. Enable the “Grab Listings as HTML” button in settings for administrators.
2. Visit the explore page. Click “Grab Listings as HTML.”
3. Open a page in WordPress or any HTML editor. Switch to HTML/Code view and paste. The raw HTML markup for the styled listing cards is inserted, which you can further customize.
Example — Allowing Guests to Copy Listings
1. In settings, enable the “Grab Listings For Email” button and select “Guest (Not logged in)” in the role selector. Save.
2. Non-logged-in visitors to your explore page will see the floating email copy button and can copy listings to share via email — no account required.
Frequently Asked Questions
Does this require the MyListing theme?
Yes. The plugin requires the MyListing theme to be active. It reads listing data from MyListing’s explore page HTML structure. If MyListing is not detected, an admin error notice is shown and all functionality is disabled.
Does this require a child theme?
No. The plugin does not override any template files. It works with or without a child theme.
Why don’t I see any buttons on the explore page?
Both buttons are disabled by default. Go to the “Listings To Clipboard” settings page, enable the desired buttons, and assign at least one user role. Also verify you are viewing the MyListing explore page (the search/listings page) — the buttons only appear on pages with the explore widget.
What is the difference between the Email and HTML buttons?
The Email button copies listings as rich, rendered HTML — pasting into an email client shows styled visual cards. The HTML button copies the raw HTML source code as plain text — pasting shows the HTML markup itself for use in editors.
Can non-logged-in visitors use the copy buttons?
Yes. Select “Guest (Not logged in)” in the role selector for the button you want to make available to guests.
How does checkbox selection work?
When enabled, each listing card gets a checkbox in its top-right corner. All checkboxes are checked by default. Uncheck listings you want to exclude, then click a copy button — only checked listings are copied. New listings loaded via AJAX or infinite scroll automatically receive checkboxes too.
Will the copied cards look the same in all email clients?
The cards use inline styles and table-based layout for broad compatibility and display correctly in most modern email clients (Gmail, Apple Mail, Outlook web). However, background images may not render in Outlook desktop — in that case the card may appear with a dark background instead of the listing’s featured image.
Does the plugin use my site’s brand colour?
Yes. The date badge on each generated card uses the MyListing theme’s primary brand colour from your theme settings.
Is there a settings page?
Yes. Navigate to “Listings To Clipboard” in the WordPress admin sidebar to configure button toggles, role permissions, and checkbox selection.
Does the plugin create any database tables?
No. All settings are stored in a single entry in the WordPress options table. No custom database tables are created.
What happens when the plugin is deactivated?
The floating buttons and checkboxes no longer appear on the explore page. Plugin settings in the options table are preserved. Reactivating the plugin restores full functionality with existing settings intact.
Troubleshooting
Buttons Not Appearing on the Explore Page
| Cause | Solution |
|---|---|
| Buttons not enabled | Both buttons are disabled by default. Navigate to Listings To Clipboard settings and enable the desired buttons. |
| No roles assigned | After enabling a button, you must also select at least one user role in the role selector. The button only appears for users with an authorized role. |
| Wrong page | The buttons only appear on pages with the MyListing explore widget (#c27-explore-listings). They do not appear on single listing pages, archives, or other pages. |
| Not logged in (and Guest not enabled) | If “Guest (Not logged in)” is not selected in the role list, non-authenticated visitors won’t see the buttons. Log in with an authorized role or enable the Guest option. |
Copied Content Appears Blank or Unstyled in Email
| Cause | Solution |
|---|---|
| Used HTML button instead of Email | The HTML button copies raw markup as plain text. Use the “Grab Listings For Email” button to copy styled, rendered cards suitable for email clients. |
| Email client limitations | Some email clients (particularly Outlook desktop) don’t support background images in CSS. The card content (title, date, location) will still appear, but the background image may show as a dark overlay instead. |
Checkboxes Not Appearing on Listing Cards
| Cause | Solution |
|---|---|
| Checkbox option not enabled | Navigate to Listings To Clipboard settings and enable “Enabled Checkbox Selector on Listings?”. |
| JavaScript error | Check the browser console (F12 → Console) for errors. The checkbox system uses a MutationObserver that depends on jQuery and the MyListing explore page structure. |
Copy Operation Doesn’t Work
| Cause | Solution |
|---|---|
| Browser clipboard permissions | Some browsers may block clipboard access. Ensure the page is served over HTTPS. Try a different browser if the issue persists. |
| No listings visible | If there are no listing cards on the page (e.g., an empty search result), there is nothing to copy. |
| All checkboxes unchecked | If checkbox mode is enabled and all listings are unchecked, nothing will be copied. Check at least one listing. |
Listing Cards Missing Data (No Image, Title, or Location)
| Cause | Solution |
|---|---|
| MyListing theme update | The plugin reads listing data from specific HTML elements in MyListing’s card structure. If a MyListing update changes the card HTML, some data may not be captured. Check for plugin updates from CoDicts that address compatibility. |
“MyListing Theme Not Detected” Error
The MyListing 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.