List Views - Plugixa Testimonial for WordPress

List Views - Plugixa Testimonial

GET /plugixatestimonial/v1/views

List saved views, the reusable display designs, one page at a time. See Views.

Any signed-in user with the plugixa_testimonial_edit capability or WordPress’s edit_posts (Contributors and up, by default).

Request

GET https://your-site.example/wp-json/plugixatestimonial/v1/views?filter[layout_style]=grid

Query parameters

Name	Type	Description
`search`	`string`	Text found in the name, slug or description. Same as `filter[search]`.
`filter[is_default]`	`string`	`yes` for the default view only; any other value for the rest.
`filter[layout_style]`	`string`	A layout such as `grid`, `slider`, `masonry` or `list`. Send `filter[layout_style][]` several times for more than one.

Plus the list parameters every paged list accepts. orderby accepts id, name, slug, is_default, created_at and modified_at; anything else falls back to created_at.

Responses

`200` OK. `data.items` is one page of views.

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "id": "2",
        "name": "Homepage grid",
        "slug": "homepage-grid",
        "description": "Three columns for the home page.",
        "config": {
          "layout": {
            "style": "grid",
            "columns": {
              "desktop": 3,
              "tablet": 2,
              "mobile": 1
            }
          },
          "display": {
            "showPhoto": true,
            "showRating": true,
            "showDate": true,
            "showCompany": true,
            "showRole": true,
            "showWebsite": false,
            "excerptLength": 150
          },
          "colors": {
            "cardBg": "#ffffff",
            "textColor": "#1d2327",
            "nameColor": "#1d2327",
            "roleColor": "#646970",
            "starColor": "#f59e0b",
            "starEmptyColor": "#d1d5db",
            "borderColor": "#e5e7eb",
            "quoteBg": "#f9fafb"
          },
          "typography": {
            "nameFontSize": 16,
            "nameFontWeight": 600,
            "textFontSize": 14,
            "textFontWeight": 400,
            "roleFontSize": 13
          },
          "spacing": {
            "cardPadding": 24,
            "gap": 24,
            "photoPadding": 0
          },
          "borders": {
            "radius": 8,
            "width": 1
          },
          "shadows": {
            "enabled": true,
            "value": "0 1px 3px rgba(0,0,0,0.1)"
          },
          "categories": {
            "displayStyle": "none",
            "showCategoryDescription": true,
            "colors": {
              "backgroundColor": "#ffffff",
              "textColor": "#1d2327",
              "activeBackgroundColor": "#2271b1",
              "activeTextColor": "#ffffff",
              "borderColor": "#c3c4c7",
              "descriptionColor": "#6b7280",
              "descriptionBackgroundColor": "#f8fafc",
              "descriptionBorderColor": "#2271b1"
            },
            "typography": {
              "fontSize": 14,
              "fontWeight": 500,
              "fontFamily": "inherit"
            },
            "spacing": {
              "padding": 12,
              "gap": 8
            },
            "border": {
              "width": 1,
              "radius": 4
            }
          },
          "photo": {
            "size": 60,
            "sizeUnit": "px",
            "borderRadius": 50,
            "fallbackMode": "initials",
            "fallbackColorMode": "single",
            "fallbackBgColor": "#e5e7eb",
            "fallbackTextColor": "#6b7280",
            "borderWidth": 0,
            "borderColor": "#e5e7eb",
            "borderStyle": "none",
            "position": "inline",
            "grayscale": false,
            "hoverScale": 1.0,
            "opacity": 1.0,
            "shadowEnabled": false,
            "shadowValue": "0 2px 8px rgba(0,0,0,0.15)"
          }
        },
        "is_default": 0,
        "created_at": "2026-11-12 09:30:00",
        "created_by": "1",
        "modified_at": null,
        "modified_by": null
      }
    ],
    "total": 1,
    "state": {
      "filter": {
        "layout_style": "grid"
      },
      "limit": 20,
      "offset": 0,
      "orderby": "created_at",
      "order": "DESC"
    }
  }
}

Field	Type	Meaning
`data.items[].id`	`string`	The view’s id
`data.items[].name`	`string`	The name
`data.items[].slug`	`string`	Unique across views. Usable as `view="..."` in the shortcode
`data.items[].description`	`string\|null`	Plain text
`data.items[].config`	`object`	The design settings: layout, display, colors, typography, spacing, borders, shadows, categories, photo and more
`data.items[].is_default`	`integer`	`1` for the view used when a display names none, else `0`
`data.items[].created_at`	`string\|null`	Site-time datetime
`data.total`	`integer`	Views matching the filters, before paging

Errors

Plus the errors every endpoint can return.

Examples

curl -sg "https://your-site.example/wp-json/plugixatestimonial/v1/views?filter[layout_style]=grid" \
  -u "admin:$WP_APP_PASSWORD"

<?php
$query = http_build_query([
    'filter[layout_style]' => 'grid',
]);
$ch = curl_init('https://your-site.example/wp-json/plugixatestimonial/v1/views?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD        => 'admin:' . getenv('WP_APP_PASSWORD'),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const query = new URLSearchParams({ 'filter[layout_style]': 'grid' });
const response = await fetch(`https://your-site.example/wp-json/plugixatestimonial/v1/views?${query}`, {
  headers: {
    'Authorization': 'Basic ' + btoa(`admin:${process.env.WP_APP_PASSWORD}`),
  },
});
const { data } = await response.json();