Save to Collections (Pro Picker)

PRO - Requires MediaVerse Pro. This feature is not in the free plugin.

MediaVerse Pro makes the Save control open a picker, so members can add a media item to any number of their named collections. Since 2.6.0, Save is the one way to keep an item. Reactions say how you feel; Save keeps the item.

Save vs. Favorite

• Without Pro, Save puts the item straight into the member’s private Favorites collection. Everything a member favorited before 2.6.0 is in that collection too.
• With Pro, Save opens the collection picker. Its first row is that Favorites collection, followed by the member’s other named collections. The button shows Saved while the item is in Favorites.
• Save appears wherever media actions render (single media page, lightbox, feed cards) and only for logged-in users.

How It Works (for Users)

1. Click Save (bookmark icon) on a media item.
2. The picker lists your Favorites collection first, then your other named collections, with a checkbox per row - check to add the item, uncheck to remove it.
3. Each toggle saves automatically the moment you click it; there is no separate confirm button.
4. Every row shows its own state inline: Saving…, then Saved or Removed. If a save fails, the row shows an inline error with a retry option.
5. Don’t have the right collection yet? Type a name in the + New collection box and click Create - blank names are rejected.
6. Click View your collections at the bottom of the picker to jump straight to the My Media dashboard Collections tab.

Named Collections Only

The picker only lists your manual collections - the ones where you hand-pick items. Smart collections are rule-based and resolve their contents dynamically, so they are not toggle targets in the picker; they still work exactly as documented in the free Collections page.

Accessibility

The picker is fully keyboard and screen-reader accessible:

• The popover carries aria-labelledby pointing at its title.
• Escape closes the picker and returns focus to the Save button that opened it - keyboard users are never stranded.
• Per-row status text (Saving/Saved/Removed) is announced via aria-live="polite".
• Loading, empty (“No collections yet. Create one below.”), and error states are all handled explicitly; errors carry role="alert".

Where “View Your Collections” Goes

By default, View your collections links to the My Media dashboard’s Collections tab. If your site’s dashboard lives at a different URL, filter mvs_pro_collections_manage_url - documented in the Free plugin’s Hooks & Filters reference - to point it wherever your site keeps that page.

REST API

Base URL: /wp-json/mvs-pro/v1/

GET /media/{media_id}/collections

Return the current user’s favorite flag plus their manual collections, each with a member boolean showing whether this media item is already in it.

Auth: User (logged in)

Response:

{
  "favorites": true,
  "collections": [
    { "id": 12, "title": "Travel Inspiration", "member": true },
    { "id": 18, "title": "Black and White", "member": false }
  ]
}

POST /media/{media_id}/collections

Add or remove the media item from one of the user’s own manual collections.

Auth: User (logged in; the collection must belong to the requesting user)

Body:

Field	Type	Required	Default	Description
collection_id	int	Yes	-	The collection to toggle membership in
member	bool	No	true	true to add the item, false to remove it

Returns 404 (mvs_pro_invalid_collection) if the collection does not exist or is not owned by the requesting user.

Requirements

• MediaVerse Pro 1.8.0 or higher.