Documentation · Admin Reference
Design And Styles Reference
This document is a reference for the Design & Styles screen of the ADP Car Market Hub plugin (Car Market Hub → Design & Styles). It explains every card, the meaning of each color and typography token, and how the plugin interacts with your active theme.
When to use this document
Use this reference when you want to align the look and feel of vehicle pages with your brand, change typography for specific frontend contexts, configure social sharing or the PDF datasheet button, control image lazy loading, or add custom CSS.
Overview
The screen is organized into the following cards:
- Color scheme & branding — primary palette and button colors.
- Other design settings — additional color tokens, border radius and button size preset.
- Typography System — typography per page context (Vehicle Detail, Archive & Grid, Favorites, Compare).
- Social sharing buttons — networks shown on single vehicle pages and their placement.
- PDF Datasheet — toggle to expose a print-optimized vehicle summary.
- Performance — native lazy loading for images.
- Layout Manager — pointer to the dedicated Layout Manager tab and a global toggle to use the custom block order.
- Custom CSS — raw CSS appended after all plugin styles.
The screen follows a "Theme First" principle: any field that supports it can be left empty to inherit from the active theme.
Requirements or prerequisites
- Permission to manage the plugin.
- For the Layout Manager toggle to take effect, you must have configured the Layout Manager screen.
- For the PDF datasheet, the visual button is shown on single vehicle pages; the PDF layout itself is configured in the PDF Manager.
Step by step instructions
- Open Car Market Hub → Design & Styles.
- In Color scheme & branding, set your brand colors. Use the color picker or paste hex values.
- Open Other design settings to fine-tune optional tokens such as price/link colors, border radius and button size.
- Open Typography System and configure each tab (Vehicle Detail, Archive & Grid, Favorites, Compare). Leave fields empty to inherit from the theme.
- In Social sharing buttons, enable sharing, choose the visible networks, and pick the placement.
- Toggle Enable PDF datasheet if you want a print/save-as-PDF button on single vehicle pages.
- In Performance, enable Lazy loading to use the browser's native
loading="lazy"for vehicle images. - In Layout Manager, decide whether to apply the custom block order saved in the Layout Manager tab.
- Add any final overrides in Custom CSS if needed.
- Save. Each card has its own Save Design & Styles settings button; saving any of them persists the entire form.
Configuration reference
Color scheme & branding
| Token | Purpose |
|---|---|
| Primary color | Main accent color for highlights, active states and links. |
| Secondary color | Used for headings, dark backgrounds and secondary text elements. |
| Accent color | Secondary highlight color for badges, tags and call-out elements. |
| Card background | Background color for vehicle cards and content containers. |
| Button background | Background color for primary buttons such as "More details" and "Send inquiry". |
| Button text color | Default #FFFFFF. |
| Button hover background | Leave empty to derive a default hover shade. |
| Button text hover color | Leave empty to inherit. |
Other design settings
| Token | Purpose |
|---|---|
| Price color | Color for vehicle prices. Empty = inherit from theme. |
| Link color | Color for breadcrumb and inline links. Empty = inherit from theme. |
| Border radius | Applied to cards, image wrappers and buttons. Example values: 8px, 0px. Empty = stylesheet default. |
| Button size | Theme default, Small, Medium or Large preset for padding and font size. |
Typography System
The typography card has four tabs corresponding to frontend contexts:
| Tab | Applies to |
|---|---|
| Vehicle Detail | The single vehicle page. |
| Archive & Grid | The archive / listing pages. |
| Favorites | The favorites/wishlist page. |
| Compare | The compare-vehicles view. |
Within each tab, the matrix sets typography per text role. The rows are the text roles and the columns are the typography tokens you can set for each role:
| Row (text role) | Applies to |
|---|---|
| H1 / Car Title | The main vehicle title heading. |
| H2 / Sections & Dealership | Section headings and the dealership name. |
| H3 / Details & Agent | Detail sub-headings and the agent/contact heading. |
| Body / Paragraphs & Tables | Paragraph text and table content. |
| Labels / Key-data & spec labels | Key-data and specification labels. |
| Column (token) | Notes |
|---|---|
| Size (px) | Font size in pixels. Empty = inherit from theme. |
| Line Height (em) | Line height as an em multiplier. Empty = inherit. |
| Weight | Default, 300, 400, 500, 600, 700 or 800. |
| Transform | Default, UPPERCASE, lowercase or Capitalize. |
| Color | Text color for the role. Empty = inherit. |
Any field left empty inherits from the active theme. The full matrix (including the Labels row) appears on the Vehicle Detail, Archive & Grid and Compare tabs. The Favorites tab uses the same columns but does not include the Labels row.
Social sharing buttons
| Field | Notes |
|---|---|
| Show sharing buttons on single vehicle pages | Master toggle. |
| Visible networks | Multi-select: WhatsApp, Facebook, Instagram, X (Twitter), Email, Copy link. |
| Placement | Below gallery, Sticky right sidebar, or End of page. |
What each placement looks like, and how it behaves on mobile:
- Below gallery — a horizontal row of share buttons directly under the photo gallery. Visible on all screen sizes.
- Sticky right sidebar — a compact bar fixed to the right edge of the screen that stays in place as the visitor scrolls. In this placement the bar also carries the Favorites, Compare and PDF datasheet quick buttons (each shown only when that feature is enabled). To avoid covering content on small screens, this bar is hidden on phones (viewport ≤ 600 px). On phone-sized screens, therefore, choose Below gallery or End of page if you want sharing to remain visible.
- End of page — a horizontal row at the very bottom of the vehicle page, below the contact section. Visible on all screen sizes (so on a phone it appears under the contact area).
If you see the share bar at the bottom of the page on a phone "under the contact button", the placement is set to End of page (or the visitor is on a tablet between 601 px and 960 px, where the Sticky right sidebar is still shown). This is expected behavior, controlled by the Placement option above.
PDF Datasheet
| Field | Notes |
|---|---|
| Show PDF datasheet download button on single vehicle pages | Master toggle. The actual PDF layout, logo, visible fields and QR code are configured in the PDF Manager tab. |
Performance
| Field | Notes |
|---|---|
| Enable native lazy loading for vehicle images | Sets the browser's loading="lazy" attribute on vehicle images to defer off-screen image loading. |
Layout Manager card
| Field | Notes |
|---|---|
| Use the custom block order instead of the built-in defaults | Master toggle for the order saved in the Layout Manager tab. |
Custom CSS
| Field | Notes |
|---|---|
| Custom CSS | Raw CSS appended after all plugin styles. Use sparingly — it overrides every other style and can break templates if not tested. |
Operational notes
- The "Theme First" principle means leaving a field empty hands control back to the active theme. This is the safest default when integrating with a new theme.
- The hover background color falls back to a derived shade if left empty, so primary buttons always have a visible hover state.
- Some areas previously available on this screen have moved: badges and labels are now in the Layout Manager under Car Archive Cards, the financing calculator is now in Settings → Frontend Features.
- The PDF Datasheet toggle here only controls whether the button is visible. If the button is shown but the PDF looks wrong, configure the layout in the PDF Manager.
- Saving any card submits the full form. To revert a section, restore the empty default and save again.
Troubleshooting
- Color changes do not appear. Clear any frontend or CDN caches. Confirm the color picker actually committed a value (the field should show a hex code).
- Typography fields seem to have no effect. Empty fields intentionally inherit from the theme. Set an explicit value if you need to override theme styles.
- Lazy loading does not work. Some themes or third-party plugins replace image markup. Confirm the rendered
<img>tag includesloading="lazy". Verify in the current plugin version before publishing. - PDF datasheet button is missing. Confirm the toggle is enabled and that the single vehicle template still includes the plugin's button area. The button is rendered only on single vehicle pages.
- The "use custom block order" toggle is on but the layout looks unchanged. Open the Layout Manager tab and confirm a custom layout is saved for the affected zone.
- Custom CSS broke a page. Remove or shorten the snippet and save again. Custom CSS overrides everything else.