В предыдущей части мы настроили структуру приложения, в данной статье мы настроим Strapi API и выведем список ресторанов.

Примечание: исходный код для всей серии статей доступен здесь.

Создаем рестораны

Первым делом нам нужно отобразить список ресторанов в нашем приложении. Разумеется, данным списком мы будем управлять через Strapi API, поэтому давайте его настроим.

Устанавливаем Content Type

Content Type, также называется моделью (model). Strapi API по умолчанию включает в себя модель user. Сейчас нам нужны рестораны, поэтому новая модель как вы уже догадываетесь будет называться restaurant(модели именуются в единственном числе).

Вот что нам нужно сделать:

• Перейти в конструктор моделей http://localhost:1337/admin/plugins/content-type-builder
• Нажать на Create new content-type
• Установить restaurant в качестве имени и нажать кнопку "Continue"
• Далее создать следующие поля:
  
  • name с типом Text
  • description с типом Rich Text
  • image с типом Media
• Нажать кнопки "Finish" и после "Save"

После этого сервер должен автоматически перезагрузится и новая ссылка Restaurant появится в левом меню.

Добавляем записи

Отлично! Мы создали первую модель, следующим шагом будет добавление ресторанов в базу данных. Для этого кликните по ссылке Restaurant в левом меню.

Теперь мы находимся в плагине Content Manager, интерфейс которого позволяет просматривать, изменять и добавлять записи.

• Нажмите на Add New Restaurant
• Укажите name,  description и перетащите картинку в поле image
• Сохраните

Создайте еще столько ресторанов сколько хотите увидеть в приложении.

Разрешаем доступ

У нас есть записи в базе данных — это хорошо. Однако возможность делать запросы к базе из API еще лучше. Когда мы создали модель restaurant, под капотом Strapi создал ряд файлов расположенные в api/restaurant. Эти файлы включают в себя основную логику, предоставляя полностью кастомизируемое CRUD API. Метод для получения ресторанов find доступен здесь: http://localhost:1337/restaurants.

Попытавшись посетить данный URL, вы будете удивлены увидев 403 ошибку. На самом деле это нормально: новые Strapi API спроектированы такими по умолчанию.

Не волнуйтесь, сделать роут публичным просто и интуитивно понятно:

• Перейдите  на вкладку Roles & Permissions http://localhost:1337/admin/plugins/users-permissions.
• Выберите Public
• Поставьте галочку в чекбоксах find и findone  секции Restaurant
• Сохраните

Важно: сделайте тоже самое для роли authenticated

• Перейдите  на вкладкуRoles & Permissions  http://localhost:1337/admin/plugins/users-permissions.
• Выберите Authenticated
• Поставьте галочку в чекбоксах find и findone  секции Restaurant
• Сохраните.

Вернемся назад на http://localhost:1337/restaurants, теперь мы должны увидеть список ресторанов.

Включаем GraphQL

По умолчанию API генерируется в REST формате. Что если я скажу вам, что мы можем его превратить в GraphQL в течении 10 секунд?

Давайте проверим что это так.

Плагин для GraphQL доступен в Strapi, установим его следующей командой в директории /backend:

yarn strapi install graphql # или npm run strapi install graphql

На этом все, с бекендом мы закончили.

• Перезагрузите сервер (yarn develop или npm run develop)
• Перейдем на http://localhost:1337/graphql и попробуем следующий запрос:

{       restaurants {         id # Или _id если вы используете MongoDB         name       } }

Если мы увидим список ресторанов, то можно переходить к следующем шагу:

• Установим GraphQL и @nuxt-apollo в нашу /frontend директорию

yarn add @nuxtjs/apollo graphql # или npm install @nuxtjs/apollo graphql

Модули и настройки для apollo должны быть установлены в nuxt.config.js:

    ...     modules: [ '@nuxtjs/apollo',     ],     apollo: { clientConfigs: { default: { httpEndpoint: 'http://localhost:1337/graphql' } }     },     ...

Показываем рестораны

Пока что мы движемся в правильном направлении. Что делать если мы хотим отобразить рестораны в Nuxt приложении? Давайте поместим необходимые для этого файлы в соответствующие директории.

• Создадим ./pages/restaurants/index.vue файл и скопируем в него следующий код:

<template>         <div>           // Поиск ресторанов           <form class="uk-search uk-search-large uk-align-center uk-margin">               <span uk-search-icon></span>               <input class="uk-search-input" v-model="query" type="search" placeholder="Search...">           </form>            // Карточки с ресторанами           <div class="uk-card uk-card-default uk-grid-collapse uk-child-width-1-2@m uk-margin" v-for="restaurant in filteredList" v-bind:key="restaurant" uk-grid>               <div class="uk-card-media-left uk-cover-container">                   <img :src="'http://localhost:1337/' + restaurant.image.url" alt="" uk-cover>                   <canvas width="600" height="400"></canvas>               </div>               <div>                   <div class="uk-card-body">                       <h3 class="uk-card-title">{{ restaurant.name }}</h3>                       <p>{{ restaurant.description }}</p>                       // Ссылка на рестораны                       <router-link :to="{ name: 'restaurants-id', params: { id: restaurant.id }}" tag="a" class="uk-button uk-button-primary">See dishes                       </router-link>                   </div>               </div>           </div>            // Если ресторанов не найдено           <div class="uk-container uk-container-center uk-text-center" v-if="filteredList.length == 0">            <img src="https://assets-ouch.icons8.com/preview/19/52de2377-696e-4194-8c63-0a81aef60b4f.png" height="800" width="800">            <p>No restaurants found</p>          </div>        </div>  </template>  <script>       // Импортируем запрос ресторанов     import restaurantsQuery from '~/apollo/queries/restaurant/restaurants'      export default {         data() {         return {           // Инициализируем пустую переменную с ресторанами           restaurants: [],           query: ''         }       },       apollo: {         restaurants: {           prefetch: true,           query: restaurantsQuery         }       },       computed: {         // Ищем рестораны         filteredList() {           return this.restaurants.filter(restaurant => {             return restaurant.name.toLowerCase().includes(this.query.toLowerCase())           })         },       }     } </script>

Что мы написали?

Две главные части — шаблон и скрипт. Эти составляющие типичны для Vue.js приложений.

Раздел с шаблоном устанавливает структуру страницы, как вы видите некоторые атрибуты специфичны для Vue.js:

1. v-for: повторяет тег количество раз равное длине массива (restaurants в нашем случае).
2. v-if: отображает тег только если переданное условие валидно.
3. v-model: связывает переменную со значением инпута. Применяется в данном случае для фильтрации ресторанов по их названию.
4. vue-router: создает ссылку на страницу.

В скриптовой части мы импортируем необходимые компоненты и модули.

GraphQL запрос

Как вы могли заметить, мы вызываем restaurantsQuery GraphQL запрос с помощью apollo здесь:

... apollo: { restaurants: { prefetch: true, query: restaurantsQuery } }, ...

Для этого мы создадим директорию которая содержит запрос к Strapi API.

• Создаем /frontend/apollo/queries/restaurant/restaurants.gql и вставляем следующий код:

    query Restaurants {         restaurants {         id         name         description         image {           url         }       }     }

Отлично! Теперь мы можем увидеть список ресторанов!

---

В следующей части вы узнаете как отобразить список блюд.