# Settings screens

Settings is a framed page (see Plugin admin pages). Its tabs are the header's sections, each group of settings is a card on the white page, and the tab on screen puts its own Save Changes button where the header's action goes; below 783px it stays at the bottom of the screen. General, Images and Popup & Lightbox use WordPress Gutenberg controls with one label style; the tabs the Settings API draws itself, Pro's among them, keep their renderer inside a card.

Primary settings stay visible. Advanced or infrequently changed settings use collapsed groups. General groups custom taxonomies, performance and responsive breakpoints. Images groups independent layout and lightbox image sizes. Popup shows Behavior, Controls and Appearance before thumbnails, Albums, Quick View and Advanced.

Use the labels, descriptions, defaults and limits registered by the settings API. Keep Pro controls disabled in Free and show their existing upgrade links. Use the corrected group name Controls.

Hidden and collapsed controls preserve pending values and submit them through the existing form. Numeric controls allow intermediate typing and use native final validity. Dependency changes never reset values. Group disclosure uses native keyboard behavior.

Each setting is one row in its group's card, with a 1px divider between rows. The name and description sit on the left and the control on the right: a toggle at the right edge, any other control filling a 280px column. The control centers on the name and description together; a textarea or an image aligns to the top instead. Size fields (image sizes, breakpoints) stay a responsive grid with name, field and description stacked. Below 783px every row stacks in that same order.

Watermarks and the Social Feeds preview are outside this design change.

# Plugin admin pages

Screens the plugin draws itself are React pages in one frame (`assets/admin/pages/components/page.js`), modeled on the Site Editor's screens: white edge to edge, no gray canvas and no plugin navigation bar, since the WordPress sidebar already lists every page. A page header holds the title, one line on what the page is for, the page's actions on the right, and its sections as underline tabs with counts where a count helps choose. Sections change the URL, so they can be bookmarked and the back button works. Content starts under the header at the same 32px gutter.

Core list screens (Projects, Categories, Tags, and Pro's Proofing list) keep WordPress's rendering, since other plugins extend them. They get the frame's header above it, with Projects, Categories and Tags as its sections and the Add New link as its action, and WordPress's own title is hidden.

A list screen gets this header through the `vpf_admin_list_screens` filter, whose docblock in `classes/class-admin.php` holds its shape; that is how Pro's list screens join the frame. Lists that belong together, such as a post type and its taxonomy, carry the same sections, so they read as one page with tabs. A tab shows only when the user can open its screen, and a single tab left gets no tab bar.

# Saved Layouts library

The Saved Layouts screen is a plugin admin page (see Plugin admin pages) with DataViews. It takes its type, spacing and colors from WordPress's components and adds no values of its own beyond the layout preview and the Legacy badge. Search, filters and, in the grid and list, Select all share one toolbar row; the grid has no select-all row of its own.

Grid is the default view and table the dense one. A card shows a preview, the title, one summary line (source · layout) and usage. A card's preview is the layout as a page renders it, scaled from a 1200px page and centred when it is shorter than the card. While it loads, in table and list rows, and for a layout with no items, the preview draws the arrangement from the settings in neutral placeholder tones. Legacy layouts carry a yellow Legacy badge; drafts carry their status. Rare actions live in the item menu; destructive ones open a dialog that names the pages a layout is used on.

New layouts are added from one split button whose menu holds the legacy editor. Below the medium breakpoint the button reads Add New and Import becomes an icon button.

In the editor, a setting a synced gallery changed shows a dot, "Changed on this gallery" and a reset icon above its control, in the theme color. A gallery that is not synced shows nothing of Saved Layouts in its inspector: Sync with Saved Layout… and Save as Saved Layout… live in the block's menu, as core's Create pattern does, since few galleries are synced. A synced gallery shows one status line at the top of the inspector, with no card around it: the synced-pattern icon, the layout's name, how many settings the gallery changed with an inline Reset, and a menu with Edit, Sync with another and Detach.
