Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ben-rogerson/nuxt-seomatic-meta
A module for connecting Nuxt.js to the Craft CMS SEOmatic plugin via GraphQL. Nuxt-o-matic!
https://github.com/ben-rogerson/nuxt-seomatic-meta
craft craftcms nuxt nuxtjs seo seomatic vue
Last synced: about 2 months ago
JSON representation
A module for connecting Nuxt.js to the Craft CMS SEOmatic plugin via GraphQL. Nuxt-o-matic!
- Host: GitHub
- URL: https://github.com/ben-rogerson/nuxt-seomatic-meta
- Owner: ben-rogerson
- Created: 2019-10-23T03:13:21.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-16T04:09:10.000Z (6 months ago)
- Last Synced: 2024-06-02T21:57:48.352Z (4 months ago)
- Topics: craft, craftcms, nuxt, nuxtjs, seo, seomatic, vue
- Language: JavaScript
- Homepage:
- Size: 36.1 KB
- Stars: 29
- Watchers: 3
- Forks: 8
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
nuxt-seomatic-meta 
If you're using Nuxt.js with Craft CMS headless then there's a good chance you'll be aiming for some decent SEO. A custom solution would take too much time, so a great alternative is to request the SEO data from [SEOmatic](https://plugins.craftcms.com/seomatic) via GraphQL.
This module grabs the SEOmatic data and converts it to a format that Nuxt.js expects in it's [head property](https://nuxtjs.org/api/configuration-head/).
## Getting started
Before starting, I'll assume you've installed [Craft (>=3.3)](https://github.com/craftcms/cms/blob/develop/CHANGELOG-v3.md#330---2019-08-27), [SEOmatic (>=3.2.28)](https://github.com/nystudio107/craft-seomatic/releases/tag/3.2.28) and enabled [Crafts GraphQL API](https://docs.craftcms.com/v3/graphql.html#getting-started).
⚠️ Note: Craft can't be in `headlessMode` - [Headless mode](https://docs.craftcms.com/v3/config/config-settings.html#headlessmode) won't work with SEOmatic as we need to match the URI which gets turned off when headlessMode is enabled.
⚠️ Note: Within `Craft > GraphQL > Schemas`, be sure to adjust the scope to the right entries in the GraphQL schema - I find it easy to forget that.
1. Install `nuxt-seomatic-meta` via yarn or npm:
```sh
yarn add nuxt-seomatic-meta
# or: npm install nuxt-seomatic-meta
```
2. Add the seomatic-meta and axios plugins to your modules section in `nuxt.config.js`:
```js
/*
** Nuxt.js modules
*/
modules: [
'nuxt-seomatic-meta',
'@nuxtjs/axios',
// '@nuxtjs/dotenv',
],
```
_'@nuxtjs/axios'_: Axios is used to connect to the Craft CMS API - it's automatically installed as a dependency of `nuxt-seomatic-meta` so you'll just need to add it to the array.
_'@nuxtjs/dotenv'_ (optional): To specify your GraphQL connection variables in a `.env` file then [install the nuxt dotenv module](https://github.com/nuxt-community/dotenv-module#setup).
3. Now specify the GraphQL connection settings - you have two options:
a) Add the connection settings to an `.env` file in your project root (if you're using the [@nuxtjs/dotenv](https://github.com/nuxt-community/dotenv-module#setup) module):
```bash
# Craft installation url
BACKEND_URL=https://YOUR_DOMAIN
# GraphQL api path
GRAPHQL_PATH=/api
# GraphQL bearer token (Not required if API is public)
GRAPHQL_TOKEN=ACCESS_TOKEN_SECRET
```
b) Or add the connection settings to a new `seomaticMeta` object in `nuxt.config.js`:
```js
/*
** Seomatic meta config
*/
seomaticMeta: {
backendUrl: 'http://YOUR_DOMAIN',
graphqlPath: '/api',
graphqlToken: 'ACCESS_TOKEN_SECRET',
},
```
4. Lastly, add some code to start the API request and supply the result to Nuxt's head property. This is added to your pages in `pages/*.vue`:
```js
export default {
//...
// Get Seomatic data from Craft by route
async asyncData({ app, route }) {
const siteId = 1 // For multi-site installs
return {
headData: await app.seomaticMeta(route, siteId)
};
},
// Supply the data to the Nuxt head property
head() {
return this.headData;
}
};
```
## Configuration
Options can be supplied in a `seomaticMeta` object in `nuxt.config.js`:
```js
seomaticMeta: {
debug: true,
routeRemap: [
{
path: '/',
getFrom: 'homepage',
},
{
path: 'another-route',
getFrom: 'gets-meta-from-this-route-instead',
},
],
backendUrl: 'http://YOUR_DOMAIN',
graphqlPath: '/api',
graphqlToken: 'ACCESS_TOKEN_SECRET',
},
```
| Name | Type | Default | Description |
| ------------ | --------- | --------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| debug | `boolean` | `false` | Display the GraphQL data and other useful feedback in your console when using `npm run generate`. |
| routeRemap | `array` | `[]` | Custom remapping of route data so you can grab the SEOmatic data from another page.
Eg: Your Nuxt homepage has a route of `/` but you want data from a page in Craft with a slug of `homepage`. |
| backendUrl | `string` | `` | The url for your Craft installation.
This can also be defined in your `.env` under the key `BACKEND_URL`. |
| graphqlPath | `string` | `` | The path to your GraphQL API.
This can also be defined in your `.env` under the key `GRAPHQL_PATH`. |
| graphqlToken | `string` | `` | The token for your secured GraphQL endpoint.
This can also be defined in your `.env` under the key `GRAPHQL_TOKEN`. |
Note: .env variables require the [dotenv module](https://github.com/nuxt-community/dotenv-module#setup).
## 🤝 Contributing
Contributions, issues and feature requests are welcome!
Feel free to check the [issues page](http://github.com/ben-rogerson/nuxt-seomatic-meta/issues).
## Show your support
Give a ⭐️ if this project helped you!