{"id":13516366,"url":"https://github.com/ashhitch/wp-graphql-yoast-seo","last_synced_at":"2025-04-14T02:59:07.386Z","repository":{"id":35695611,"uuid":"166688908","full_name":"ashhitch/wp-graphql-yoast-seo","owner":"ashhitch","description":" This is an extension to the WPGraphQL plugin for Yoast SEO","archived":false,"fork":false,"pushed_at":"2025-02-09T20:51:38.000Z","size":847,"stargazers_count":227,"open_issues_count":21,"forks_count":48,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-14T02:59:00.589Z","etag":null,"topics":["graphql","hacktoberfest","wordpress","wordpress-plugin","wpgraphql-plugin","yoast-seo"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ashhitch.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["ashhitch"],"custom":["https://www.buymeacoffee.com/hafowuvo"]}},"created_at":"2019-01-20T17:27:17.000Z","updated_at":"2025-02-04T10:22:34.000Z","dependencies_parsed_at":"2024-06-07T09:59:38.668Z","dependency_job_id":"606c009c-ad5c-4ce2-be09-b00027208e71","html_url":"https://github.com/ashhitch/wp-graphql-yoast-seo","commit_stats":{"total_commits":163,"total_committers":25,"mean_commits":6.52,"dds":"0.22699386503067487","last_synced_commit":"8c0d9eb57578b77fbd56aebe2002695807edcea8"},"previous_names":[],"tags_count":61,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashhitch%2Fwp-graphql-yoast-seo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashhitch%2Fwp-graphql-yoast-seo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashhitch%2Fwp-graphql-yoast-seo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashhitch%2Fwp-graphql-yoast-seo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ashhitch","download_url":"https://codeload.github.com/ashhitch/wp-graphql-yoast-seo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248813789,"owners_count":21165633,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["graphql","hacktoberfest","wordpress","wordpress-plugin","wpgraphql-plugin","yoast-seo"],"created_at":"2024-08-01T05:01:21.729Z","updated_at":"2025-04-14T02:59:07.360Z","avatar_url":"https://github.com/ashhitch.png","language":"PHP","funding_links":["https://github.com/sponsors/ashhitch","https://www.buymeacoffee.com/hafowuvo","https://www.buymeacoffee.com/ashhitch"],"categories":["Plugins"],"sub_categories":["WordPress"],"readme":"# WPGraphQl Yoast SEO Plugin\n\n[![Latest Stable Version](https://poser.pugx.org/ashhitch/wp-graphql-yoast-seo/v/stable)](https://packagist.org/packages/ashhitch/wp-graphql-yoast-seo)\n[![Total Downloads](https://poser.pugx.org/ashhitch/wp-graphql-yoast-seo/downloads)](https://packagist.org/packages/ashhitch/wp-graphql-yoast-seo)\n[![Monthly Downloads](https://poser.pugx.org/ashhitch/wp-graphql-yoast-seo/d/monthly)](https://packagist.org/packages/ashhitch/wp-graphql-yoast-seo)\n\n![WPGraphQl Yoast SEO Plugin](./banner.png)\n\n## Please note version 4 of the Yoast Plugin is a major update.\n\nIf you are stuck on version of Yoast before V4 then use v3 of this plugin.\n\nThis is an extension to the WPGraphQL plugin (https://github.com/wp-graphql/wp-graphql) that returns Yoast SEO data.\n\n\u003e Using this plugin? I would love to see what you make with it. 😃 [@ash_hitchcock](https://twitter.com/ash_hitchcock)\n\n**Currently returning SEO data for:**\n\n-   Pages\n-   Posts\n-   Custom post types\n-   Products (WooCommerce)\n-   Categories\n-   Custom taxonomies\n-   WooCommerce Products\n-   Yoast Configuration\n    -   Webmaster verification\n    -   Social profiles\n    -   Schemas\n    -   Breadcrumbs\n\n\u003e If there is any Yoast data that is not currently returned, please raise an issue so we can add it to the roadmap.\n\n## Quick Install\n\n-   Install from the [WordPress Plugin Directory](https://wordpress.org/plugins/add-wpgraphql-seo/)\n-   Clone or download the zip of this repository into your WordPress plugin directory \u0026 activate the **WP GraphQL Yoast SEO** plugin\n-   Install \u0026 activate [WPGraphQL](https://www.wpgraphql.com/)\n\n## Composer\n\n```\ncomposer require ashhitch/wp-graphql-yoast-seo\n```\n\n## Find this useful?\n\n\u003ca href=\"https://www.buymeacoffee.com/ashhitch\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: 40px !important;width: auto !important;\" \u003e\u003c/a\u003e\n\n## Canonicals\n\n\u003e Please note canonicals will not be returned if you have the discourage search engines option turned on in your WordPress settings.\n\n## V4 breaking change\n\nPlugin now requires at least Yoast 14.0.0\n\n## V3 breaking change\n\nImage urls are now returned as `mediaItem` type.\n\nThis applies to `twitterImage` and `opengraphImage`\n\n## Usage with Gatsby\n\nCheckout the companion [Gatsby plugin](https://github.com/ashhitch/gatsby-plugin-wpgraphql-seo) to add in Metadata and JSON LD schema with ease.\n\n## Usage\n\nTo query for the Yoast Data simply add the seo object to your query:\n\n### Post Type Data\n\n```graphql\nquery GetPages {\n    pages(first: 10) {\n        edges {\n            node {\n                id\n                title\n                seo {\n                    canonical\n                    title\n                    metaDesc\n                    focuskw\n                    metaRobotsNoindex\n                    metaRobotsNofollow\n                    opengraphAuthor\n                    opengraphDescription\n                    opengraphTitle\n                    opengraphDescription\n                    opengraphImage {\n                        altText\n                        sourceUrl\n                        srcSet\n                    }\n                    opengraphUrl\n                    opengraphSiteName\n                    opengraphPublishedTime\n                    opengraphModifiedTime\n                    twitterTitle\n                    twitterDescription\n                    twitterImage {\n                        altText\n                        sourceUrl\n                        srcSet\n                    }\n                    breadcrumbs {\n                        url\n                        text\n                    }\n                    cornerstone\n                    schema {\n                        pageType\n                        articleType\n                        raw\n                    }\n                    readingTime\n                    fullHead\n                }\n                author {\n                    node {\n                        seo {\n                            metaDesc\n                            metaRobotsNofollow\n                            metaRobotsNoindex\n                            title\n                            social {\n                                youTube\n                                wikipedia\n                                twitter\n                                soundCloud\n                                pinterest\n                                mySpace\n                                linkedIn\n                                instagram\n                                facebook\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n}\n```\n\n### Post Taxonomy Data\n\n```graphql\nquery GetCategories {\n    categories(first: 10) {\n        edges {\n            node {\n                id\n                seo {\n                    fullHead\n                    canonical\n                    title\n                    metaDesc\n                    focuskw\n                    metaRobotsNoindex\n                    metaRobotsNofollow\n                    opengraphAuthor\n                    opengraphDescription\n                    opengraphTitle\n                    opengraphDescription\n                    opengraphImage {\n                        altText\n                        sourceUrl\n                        srcSet\n                    }\n                    twitterTitle\n                    twitterDescription\n                    twitterImage {\n                        altText\n                        sourceUrl\n                        srcSet\n                    }\n                    breadcrumbs {\n                        url\n                        text\n                    }\n                }\n                name\n            }\n        }\n    }\n}\n```\n\n### User Data\n\n```graphql\nquery GetUsers {\n    users {\n        nodes {\n            seo {\n                metaDesc\n                metaRobotsNofollow\n                metaRobotsNoindex\n                title\n                fullHead\n                social {\n                    youTube\n                    wikipedia\n                    twitter\n                    soundCloud\n                    pinterest\n                    mySpace\n                    linkedIn\n                    instagram\n                    facebook\n                }\n            }\n        }\n    }\n}\n```\n\n### Edge and Page Info Data\n\n```graphql\nquery GetPostsWithIsPrimary {\n    posts {\n        pageInfo {\n            startCursor\n            seo {\n                schema {\n                    raw\n                }\n            }\n        }\n        nodes {\n            title\n            slug\n            categories {\n                edges {\n                    isPrimary\n                    node {\n                        name\n                        count\n                    }\n                }\n            }\n        }\n    }\n}\n```\n\n### Yoast Config Data\n\n```graphql\nquery GetSeoConfig {\n    seo {\n        meta {\n            author {\n                description\n                title\n            }\n            date {\n                description\n                title\n            }\n            config {\n                separator\n            }\n            homepage {\n                description\n                title\n            }\n            notFound {\n                breadcrumb\n                title\n            }\n        }\n        webmaster {\n            googleVerify\n            yandexVerify\n            msVerify\n            baiduVerify\n        }\n        schema {\n            siteName\n            wordpressSiteName\n            siteUrl\n            inLanguage\n            companyName\n            companyOrPerson\n            companyLogo {\n                mediaItemUrl\n            }\n            logo {\n                mediaItemUrl\n            }\n            personLogo {\n                mediaItemUrl\n            }\n        }\n        breadcrumbs {\n            showBlogPage\n            separator\n            searchPrefix\n            prefix\n            homeText\n            enabled\n            boldLast\n            archivePrefix\n            notFoundText\n        }\n        social {\n            facebook {\n                url\n                defaultImage {\n                    mediaItemUrl\n                }\n            }\n            instagram {\n                url\n            }\n            linkedIn {\n                url\n            }\n            mySpace {\n                url\n            }\n            pinterest {\n                url\n                metaTag\n            }\n            twitter {\n                cardType\n                username\n            }\n            wikipedia {\n                url\n            }\n            youTube {\n                url\n            }\n            otherSocials\n        }\n        openGraph {\n            frontPage {\n                title\n                description\n                image {\n                    altText\n                    sourceUrl\n                    mediaItemUrl\n                }\n            }\n            defaultImage {\n                altText\n                sourceUrl\n                mediaItemUrl\n            }\n        }\n        contentTypes {\n            post {\n                title\n                schemaType\n                metaRobotsNoindex\n                metaDesc\n                schema {\n                    raw\n                }\n\n                archive {\n                    fullHead\n                    archiveLink\n                    breadcrumbTitle\n                    hasArchive\n                    metaDesc\n                    metaRobotsNoindex\n                    title\n                }\n            }\n            page {\n                metaDesc\n                metaRobotsNoindex\n                schemaType\n                title\n                schema {\n                    raw\n                }\n            }\n        }\n        redirects {\n            origin\n            target\n            format\n            type\n        }\n    }\n}\n```\n\n### contentNode and nodeByUri\n\n```graphql\ncontentNode(id: \"1\", idType: DATABASE_ID) {\n    id\n    contentTypeName\n    seo {\n      title\n      metaDesc\n    }\n  }\n  node(id: \"cG9zdDox\",) {\n    ... on NodeWithTitle {\n      seo {\n        title\n        metaDesc\n      }\n    }\n\n  }\n  nodeByUri(uri: \"/\") {\n    ... on NodeWithTitle {\n      seo {\n        title\n        metaDesc\n      }\n    }\n  }\n```\n\n## Support\n\n[Open an issue](https://github.com/ashhitch/wp-graphql-yoast-seo/issues)\n\n[Twitter: @ash_hitchcock](https://twitter.com/ash_hitchcock)\n\n\u003e Please Note: Yoast and WPGraphQL and their logos are copyright to their respective owners.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashhitch%2Fwp-graphql-yoast-seo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashhitch%2Fwp-graphql-yoast-seo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashhitch%2Fwp-graphql-yoast-seo/lists"}