@vicacha-devs/strapi-plugin-seo 0.0.0-stage → 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Notum Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,85 @@
-# Temporary Holding Version
+# Strapi plugin SEO
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The official plugin to make your Strapi content SEO friendly
+
+## Features
+
+- Easily see which Content-Types does have the SEO component or not.
+- Manage the important tags for your SEO (metatitle, metadescription) and preview your content in the SERP
+- Manage your meta social tags (Facebook & Twitter) and preview your post.
+- Strong SEO analysis for your content.
+
+## Installation
+
+To install this plugin, you need to add an NPM dependency to your Strapi application.
+
+```sh
+# Using Yarn
+yarn add @vicacha-devs/strapi-plugin-seo
+
+# Or using PNPM
+pnpm add @vicacha-devs/strapi-plugin-seo
+
+# Or using NPM
+npm install @vicacha-devs/strapi-plugin-seo
+```
+
+## How it works
+
+When clicking on the plugin homepage for the first time, the plugin will automatically look if a `shared.seo` component exists in your project. If not, the plugin will automatically create it with a sub `shared.meta-social` component.
+
+If a `shared.seo` component already exists in your project. You might want to rename it or delete it otherwise, the plugin will not create the necessary component in order to work.
+
+#### Homepage
+
+From there you can get an overview of which content-types contains the SEO component or not. You can quickly add the SEO component to a selected content-type.
+
+**Note**: By doing this, you will be redirected to the Content-Types builder on the specific content-type. You'll need to create a new component at the **root** of this content-type called `seo` using the existing component the plugin created for you: `shared.seo`.
+
+#### Content Manager
+
+From any content manager view for a content-type that contains the SEO component, you'll be able to see a right-side card dedicated for the SEO plugin. From there you can see a quick SEO analysis and action for you to perform (opening preview, opening complete analysis details modal).
+
+**Note**: You'll need to fill your SEO component with data to be able to see the SERP preview, Social post preview and complete analysis.
+
+## Configuration
+
+`./config/plugins.ts`
+
+```ts
+export default () => ({
+  // ...
+  seo: {
+    enabled: true,
+  },
+  // ...
+});
+```
+
+Then, you'll need to build your admin panel:
+
+```sh
+# Using Yarn
+yarn build
+
+# Or using PNPM
+pnpm build
+
+# Or using NPM
+npm run build
+```
+
+## SEO settings page
+
+You'll be able from the SEO settings page to import a `shared.seo` & `shared.meta-social` components from any GitHub repository By default, our [components GitHub repository](https://github.com/strapi/components) is being used.
+
+**Notice**: If you decide to import your own components, make sure that they belong to a `shared` category that their names is the same (`seo`, `meta-social`).
+**Notice2**: When adding your SEO component, make sure to name it 'seo' and to include it in the root of your Content-Type.
+
+## EditView SEO button
+
+Once you create your SEO component in the edit view inside the Content Manager, the SEO button will appear on the the [right-links injection zone](https://docs.strapi.io/developer-docs/latest/developer-resources/plugin-api-reference/admin-panel.html#injection-zones-api). You'll be able to:
+
+- Manage the meta title & description of your content and preview it in SERP.
+- Manage your meta social tags (Facebook & Twitter) and preview your post.
+- Analyze your content a little deeper via an SEO analysis of your content.

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/AlternativeTextCheck/index.d.ts

@@ -0,0 +1,9 @@
+import { EmptyAltOccurrence, SeoChecksState } from '../../../../../../../shared';
+interface AlternativeTextCheckProps {
+    intersections: number | null;
+    richTextAlts: EmptyAltOccurrence[];
+    altTexts: string[];
+    checks: SeoChecksState;
+}
+export declare const AlternativeTextCheck: ({ intersections, richTextAlts, altTexts, checks, }: AlternativeTextCheckProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/CanonicalUrlCheck/index.d.ts

@@ -0,0 +1,7 @@
+import { SeoChecksState } from '../../../../../../../shared';
+interface CanonicalUrlCheckProps {
+    canonicalUrl: string | null;
+    checks: SeoChecksState;
+}
+export declare const CanonicalUrlCheck: ({ canonicalUrl, checks, }: CanonicalUrlCheckProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/KeywordDensityCheck/index.d.ts

@@ -0,0 +1,7 @@
+import { KeywordDensityMap, SeoChecksState } from '../../../../../../../shared';
+interface KeywordDensityCheckProps {
+    keywordsDensity: KeywordDensityMap;
+    checks: SeoChecksState;
+}
+export declare const KeywordDensityCheck: ({ keywordsDensity, checks, }: KeywordDensityCheckProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/LastUpdatedAtCheck/index.d.ts

@@ -0,0 +1,7 @@
+import { SeoChecksState } from '../../../../../../../shared';
+interface LastUpdatedAtCheckProps {
+    updatedAt: string | null;
+    checks: SeoChecksState;
+}
+export declare const LastUpdatedAtCheck: ({ updatedAt, checks, }: LastUpdatedAtCheckProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/MetaDescriptionCheck/index.d.ts

@@ -0,0 +1,7 @@
+import { SeoChecksState } from '../../../../../../../shared';
+interface MetaDescriptionCheckProps {
+    metaDescription: string | null;
+    checks: SeoChecksState;
+}
+export declare const MetaDescriptionCheck: ({ metaDescription, checks, }: MetaDescriptionCheckProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/MetaRobotCheck/index.d.ts

@@ -0,0 +1,7 @@
+import { SeoChecksState } from '../../../../../../../shared';
+interface MetaRobotCheckProps {
+    metaRobots: string | null;
+    checks: SeoChecksState;
+}
+export declare const MetaRobotCheck: ({ metaRobots, checks }: MetaRobotCheckProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/MetaTitleCheck/index.d.ts

@@ -0,0 +1,7 @@
+import { SeoChecksState } from '../../../../../../../shared';
+interface MetaTitleCheckProps {
+    metaTitle: string | null;
+    checks: SeoChecksState;
+}
+export declare const MetaTitleCheck: ({ metaTitle, checks }: MetaTitleCheckProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/OpenGraphCheck/index.d.ts

@@ -0,0 +1,7 @@
+import { OpenGraphData, SeoChecksState } from '../../../../../../../shared';
+interface OpenGraphCheckProps {
+    openGraph: OpenGraphData | null;
+    checks: SeoChecksState;
+}
+export declare const OpenGraphCheck: ({ openGraph, checks }: OpenGraphCheckProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/SEOAccordion/index.d.ts

@@ -0,0 +1,10 @@
+import { SeoCheckStatus } from '../../../../../../../shared';
+import * as React from "react";
+interface SEOAccordionProps {
+    title: string;
+    status?: SeoCheckStatus;
+    component?: React.ReactNode;
+    label: string;
+}
+export declare const SEOAccordion: ({ title, status, component, label, }: SEOAccordionProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/StructuredDataCheck/index.d.ts

@@ -0,0 +1,7 @@
+import { SeoChecksState } from '../../../../../../../shared';
+interface StructuredDataCheckProps {
+    structuredData: unknown;
+    checks: SeoChecksState;
+}
+export declare const StructuredDataCheck: ({ structuredData, checks, }: StructuredDataCheckProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/WordCountCheck/index.d.ts

@@ -0,0 +1,7 @@
+import { SeoChecksState } from '../../../../../../../shared';
+interface WordCountCheckProps {
+    wordCount: number | null;
+    checks: SeoChecksState;
+}
+export declare const WordCountCheck: ({ wordCount, checks }: WordCountCheckProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/SeoChecks/index.d.ts

@@ -0,0 +1,10 @@
+import { ComponentSchemasMap, ContentManagerFormValues, ContentTypeSchemaInfo, SeoChecksState } from '../../../../../../shared';
+interface SeoChecksProps {
+    updatedAt: string | null;
+    modifiedData: ContentManagerFormValues;
+    components: ComponentSchemasMap;
+    contentType: ContentTypeSchemaInfo;
+    checks: SeoChecksState;
+}
+export declare const SeoChecks: ({ updatedAt, modifiedData, components, contentType, checks, }: SeoChecksProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/Summary/BrowserPreview/KeywordCheck/index.d.ts

@@ -0,0 +1,7 @@
+interface KeywordCheckProps {
+    item: string;
+    keywords: string;
+    label: string;
+}
+export declare const KeywordCheck: ({ item, keywords, label }: KeywordCheckProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/Summary/BrowserPreview/MetaChecks/index.d.ts

@@ -0,0 +1,8 @@
+interface MetaChecksProps {
+    item: string;
+    max: number;
+    label: string;
+    minLimit?: boolean;
+}
+export declare const MetaChecks: ({ item, max, label, minLimit, }: MetaChecksProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/Summary/BrowserPreview/Serp/index.d.ts

@@ -0,0 +1,6 @@
+interface SerpProps {
+    metaTitle: string;
+    metaDescription: string;
+}
+export declare const Serp: ({ metaTitle, metaDescription }: SerpProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/Summary/BrowserPreview/index.d.ts

@@ -0,0 +1,6 @@
+import { ContentManagerFormValues } from '../../../../../../../shared';
+interface BrowserPreviewProps {
+    modifiedData: ContentManagerFormValues;
+}
+export declare const BrowserPreview: ({ modifiedData }: BrowserPreviewProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/Summary/OpenGraphPreview/Facebook/index.d.ts

@@ -0,0 +1,8 @@
+import { OpenGraphImage } from '../../../../../../../../shared';
+interface FacebookOGPreviewProps {
+    image: OpenGraphImage;
+    title: string;
+    description: string;
+}
+export declare const FacebookOGPreview: ({ image, title, description, }: FacebookOGPreviewProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/Summary/OpenGraphPreview/LinkedIn/index.d.ts

@@ -0,0 +1,8 @@
+import { OpenGraphImage } from '../../../../../../../../shared';
+interface LinkedInOGPreviewProps {
+    image: OpenGraphImage;
+    title: string;
+    description?: string;
+}
+export declare const LinkedInOGPreview: ({ image, title }: LinkedInOGPreviewProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/Summary/OpenGraphPreview/X/index.d.ts

@@ -0,0 +1,8 @@
+import { OpenGraphImage } from '../../../../../../../../shared';
+interface TwitterOGPreviewProps {
+    image: OpenGraphImage;
+    title: string;
+    description: string;
+}
+export declare const TwitterOGPreview: ({ image, title, description, }: TwitterOGPreviewProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/Summary/OpenGraphPreview/index.d.ts

@@ -0,0 +1,6 @@
+import { ContentManagerFormValues } from '../../../../../../../shared';
+interface OpenGraphPreviewProps {
+    modifiedData: ContentManagerFormValues;
+}
+export declare const OpenGraphPreview: ({ modifiedData }: OpenGraphPreviewProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/Summary/PreviewChecks/index.d.ts

@@ -0,0 +1,6 @@
+import { SeoChecksState } from '../../../../../../../shared';
+interface PreviewChecksProps {
+    checks: SeoChecksState;
+}
+export declare const PreviewChecks: ({ checks }: PreviewChecksProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/CMEditView/RightLinksCompo/Summary/index.d.ts

@@ -0,0 +1,4 @@
+import { SeoCheckerAction } from '../../../../../../shared';
+import * as React from "react";
+export declare const SeoCheckerContext: React.Context<React.Dispatch<SeoCheckerAction> | null>;
+export declare const Summary: () => import("react/jsx-runtime").JSX.Element;

package/dist/admin/components/CMEditView/RightLinksCompo/Summary/reducer.d.ts

@@ -0,0 +1,2 @@
+import { SeoCheckerAction, SeoChecksState } from '../../../../../../shared';
+export declare function reducer(state: SeoChecksState, action: SeoCheckerAction): SeoChecksState;

package/dist/admin/components/CMEditView/RightLinksCompo/index.d.ts

@@ -0,0 +1 @@
+export declare const SeoChecker: () => import("react/jsx-runtime").JSX.Element;

package/dist/admin/components/CMEditView/utils/checks.d.ts

@@ -0,0 +1,14 @@
+import { ContentManagerFormValues, EmptyAltCount, KeywordDensityMap, SeoCheckStatus, SeoQualityVerdict } from '../../../../../shared';
+export declare const qualityVerdict: Record<SeoQualityVerdict, SeoQualityVerdict>;
+export declare const isEmptyValue: (value: unknown) => boolean;
+export declare const isSameCheckStatus: (a?: SeoCheckStatus | null, b?: SeoCheckStatus | null) => boolean;
+export declare const getMetaTitleCheckPreview: (modifiedData: ContentManagerFormValues) => SeoCheckStatus;
+export declare const getMetaDescriptionPreview: (modifiedData: ContentManagerFormValues) => SeoCheckStatus;
+export declare const getAlternativeTextPreview: (emptyAltCount: EmptyAltCount) => SeoCheckStatus;
+export declare const getWordCountPreview: (wordCount: number | null) => SeoCheckStatus;
+export declare const getKeywordDensityPreview: (keywordsDensity: KeywordDensityMap) => SeoCheckStatus;
+export declare const canonicalUrlPreview: (modifiedData: ContentManagerFormValues) => SeoCheckStatus;
+export declare const lastUpdatedAtPreview: (modifiedData: ContentManagerFormValues, fallbackUpdatedAt?: string | null) => SeoCheckStatus;
+export declare const metaRobotPreview: (modifiedData: ContentManagerFormValues) => SeoCheckStatus;
+export declare const openGraphPreview: (modifiedData: ContentManagerFormValues) => SeoCheckStatus;
+export declare const structuredDataPreview: (modifiedData: ContentManagerFormValues) => SeoCheckStatus;

package/dist/admin/components/CMEditView/utils/getRegularImageAltTexts.d.ts

@@ -0,0 +1,5 @@
+import { ContentManagerFormValues, ContentTypeSchemaInfo } from '../../../../../shared';
+export declare const getRegularImageAltTexts: (contentType: ContentTypeSchemaInfo, modifiedData: ContentManagerFormValues) => {
+    intersections: number;
+    altTexts: string[];
+};

package/dist/admin/components/CMEditView/utils/getRichTextAndBlocksFields.d.ts

@@ -0,0 +1,10 @@
+import { ComponentSchemasMap, ContentManagerFormValues, ContentTypeSchemaInfo } from '../../../../../shared';
+export interface FieldDescriptor {
+    name: string;
+    field: string | null;
+    inDz?: string;
+}
+export declare const getRichTextAndBlocksFields: (contentType: ContentTypeSchemaInfo, components: ComponentSchemasMap, modifiedData: ContentManagerFormValues) => {
+    richTextFields: FieldDescriptor[];
+    blockFields: FieldDescriptor[];
+};

package/dist/admin/components/CMEditView/utils/getRichTextData.d.ts

@@ -0,0 +1,2 @@
+import { ComponentSchemasMap, ContentManagerFormValues, ContentTypeSchemaInfo, RichTextAnalysisResult } from '../../../../../shared';
+export declare const getRichTextData: (modifiedData: ContentManagerFormValues, components: ComponentSchemasMap, contentType: ContentTypeSchemaInfo) => RichTextAnalysisResult;

package/dist/admin/components/HomePage/Header/index.d.ts

@@ -0,0 +1,5 @@
+interface HeaderProps {
+    seoComponent?: Record<string, unknown> | null;
+}
+export declare const Header: ({ seoComponent }: HeaderProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/HomePage/Main/EmptyComponentLayout/illo.d.ts

@@ -0,0 +1 @@
+export declare const Illo: () => import("react/jsx-runtime").JSX.Element;

package/dist/admin/components/HomePage/Main/SettingsModal/index.d.ts

@@ -0,0 +1,8 @@
+import { ContentTypeSeoItem, SeoSettingsMap } from '../../../../../../shared';
+interface SettingsModalProps {
+    item: ContentTypeSeoItem;
+    defaultSettings?: SeoSettingsMap | null;
+    onSettingsUpdated?: (next: SeoSettingsMap) => void;
+}
+export declare const SettingsModal: ({ item, defaultSettings: sharedSettings, onSettingsUpdated, }: SettingsModalProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/HomePage/Main/index.d.ts

@@ -0,0 +1,6 @@
+import { ContentTypesResponse } from '../../../../../shared';
+interface MainProps {
+    contentTypes?: ContentTypesResponse | null;
+}
+export declare const Main: ({ contentTypes }: MainProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/components/Initializer.d.ts

@@ -0,0 +1,5 @@
+interface InitializerProps {
+    setPlugin: (id: string) => void;
+}
+export declare const Initializer: ({ setPlugin }: InitializerProps) => null;
+export {};

package/dist/admin/hooks/useSettingsApi.d.ts

@@ -0,0 +1,5 @@
+import { SeoSettingsMap } from '../../../shared';
+export declare const useSettingsApi: () => {
+    getSettings: () => Promise<import('@strapi/strapi/admin').FetchResponse<SeoSettingsMap>>;
+    setSettings: (settings: SeoSettingsMap) => Promise<import('@strapi/strapi/admin').FetchResponse<SeoSettingsMap>>;
+};