# strapi-plugin-seo

> Add SEO fields to your Collection and Single types.

Latest version **0.1.3** (published 2022-03-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install strapi-plugin-seo
pnpm add strapi-plugin-seo
yarn add strapi-plugin-seo
bun add strapi-plugin-seo
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.3 |
| Published | 2022-03-14 |
| First published | 2022-03-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=10.0.0 |
| Dependencies | 6 |
| Unpacked size | 117.8 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| Maintainers | ideveloedwin, wiktor.ozga, develocraft, marcin.pokojski |
| Keywords | strapi, plugin, seo |

## Links

- npm: https://www.npmjs.com/package/strapi-plugin-seo
- Repository: https://github.com/Develocraft-Labs/strapi-plugin-seo
- Homepage: https://github.com/Develocraft-Labs/strapi-plugin-seo#readme
- Issues: https://github.com/Develocraft-Labs/strapi-plugin-seo/issues
- npm.io page: https://npm.io/package/strapi-plugin-seo

## Dependencies (6)

- [uuid](https://npm.io/package/uuid.md) ^8.3.2
- [react](https://npm.io/package/react.md) ^17.0.2
- [react-dom](https://npm.io/package/react-dom.md) ^17.0.2
- [react-router-dom](https://npm.io/package/react-router-dom.md) ^5.3.0
- [styled-components](https://npm.io/package/styled-components.md) ^5
- [strapi-helper-plugin](https://npm.io/package/strapi-helper-plugin.md) ^3.6.8

## Recent versions

- 0.1.3 (latest) — 2022-03-14
- 0.1.2 — 2022-03-10
- 0.1.1 — 2022-03-10
- 0.1.0 — 2022-03-10

## README

![Develocraft](https://github.com/Develocraft-Labs/strapi-plugin-seo/blob/main/images/logo.jpg?raw=true)

# Strapi-SEO-plugin

A plugin for Strapi Headless CMS that provides SEO fields to Single and Collection types.

![Seo plugin home view](https://github.com/Develocraft-Labs/strapi-plugin-seo/blob/main/images/homeview.png?raw=true)

### Versions

- v0.1.3

### 🖐 Requirements

- Compatible with Strapi v3.6.x but not Strapi v4.

- Title fields on Collection type and Single type resources.

- No components named SEO on Collection type or Single type resources.

- OgUrl field on seo form require this format:
  - `https://www.yourdomain.com`

### ⏳ Installation

(Use **yarn** to install this plugin within your Strapi project [Install yarn with these docs](https://yarnpkg.com/lang/en/docs/install/).)

```bash
npm i strapi-plugin-seo
```

To use yarn instead of npm use.

```bash
yarn add strapi-plugin-seo
```

After successful installation you've to build a fresh package that includes the plugin UI.

```
npm build
npm develop
```

The Seo plugin should appear in the Plugins section of Strapi sidebar after you run the app again.

## How it works

The plugin adds an seo object to the api response of single and collection types.

**Example response**

```
...
seo: {
    id?: Number,
    title: String,
    metaDescription: String,
    jsonLd: JSON,
    ogTitle: String,
    ogType: String,
    ogUrl: String,
    ogImage: String,
    locale?: String,
    collectionTypeName?: String,
    seoUid?: String,
    created_at?: String,
    updated_at?: String
}
...
```

## How to use

### Seo Creation

1. Choose the Collection type or Single type resource you would like to add an seo to.

   In this case we will create an seo for Careers page.

![Seo creation step one](https://github.com/Develocraft-Labs/strapi-plugin-seo/blob/main/images/stepOne.png?raw=true)

2. Click on the edit button of the resource.

3. Click on Create Relation button ( only visible if relation hasn't been created ) to create a one-way relationship between the seo and the resource.

![Seo creation step two](https://github.com/Develocraft-Labs/strapi-plugin-seo/blob/main/images/stepTwo.png?raw=true)

4. Enter the seo data in the respective fields:
   - Title;
   - MetaDescription;
   - JsonLd;
   - OgTitle;
   - OgType;
   - OgUrl;
   - OgImage;

![Seo creation step three](https://github.com/Develocraft-Labs/strapi-plugin-seo/blob/main/images/stepThree.png?raw=true)

5. Click save.

6. If successfully saved, you should see a green checkmark in place of a red cross.

![Seo creation step four](https://github.com/Develocraft-Labs/strapi-plugin-seo/blob/main/images/stepFour.png?raw=true)

### Seo Edition

1. Click on the edit icon of the collection or single type resource.

   In this case Careers page.

   On this view you can edit the seo data you previously saved.

![Seo edition view](https://github.com/Develocraft-Labs/strapi-plugin-seo/blob/main/images/editView.png?raw=true)

**Supported Strapi versions**:

- Strapi v3.6.6

- Strapi v3.6.7

- Strapi v3.7.7

## Features

- **i18n:** Built-in i18n support, seo fields can be created for any language enabled in the Strapi project.

- **Zero Configuration:** Simply install the the plugin.

- **Google Preview:** Preview how your page will look like in Google’s search results.

## Local Development

- Download plugin repo https://github.com/Develocraft-Labs/strapi-plugin-seo
- Create new strapi project (if you don't have one already.)
- Create plugins folder at strapi project root level.
- Copy plugin repo to plugins folder.
- Rename plugin repo in plugins folder to seo.

### How To Test

`yarn test`

### Issues

Please open GitHub issue.

### License

MIT License Copyright (c) [Develocraft Sp.z.o.o](https://develocraft.com/)

---
_Source: https://npm.io/package/strapi-plugin-seo · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._