imranhsayed / headless-cms
一款WordPress插件,它通过REST API将WordPress作为无头CMS与任何前端环境结合使用,增加了许多功能。
1.7.0
2021-04-25 19:08 UTC
Requires
- php: >=5.4.0
- dev-master
- 1.7.0
- 1.6.0
- 1.5.0
- 1.3.0
- 1.2.0
- 1.1.0
- 1.0.0
- dev-dependabot/npm_and_yarn/assets/webpack-5.94.0
- dev-dependabot/npm_and_yarn/assets/ws-5.2.4
- dev-dependabot/npm_and_yarn/assets/multi-bcba2c3780
- dev-dependabot/npm_and_yarn/assets/browserify-sign-4.2.2
- dev-feature/add-setting-to-open-comments-post-api
- dev-feature/get-post-by-slug-api
- dev-feature/update-posts-api
- dev-feature/add-woo-countries-endpoint
- dev-feature/add-currency-in-api-response
- dev-feature/add-allowed-origin
- dev-feature/add-cookiepath
- dev-feature/fix-api-url
- dev-feature/add-wc-cart-endpoint
- dev-feature/add-product-currency
- dev-feature/add-update-order-mutation
- dev-feature/add-wishlist-mutation
- dev-feature/test-wishlist
- dev-feature/update-wishlist-fields
- dev-feature/update-countries-query
- dev-fix/countries-list
- dev-feature/filter-countries
- dev-feaure/add-shipping-countries-fields
- dev-feature/post-preview
- dev-feature/add-schemadetails
- dev-feature/add-stickypost-type
- dev-feature/add-headless-cms
This package is auto-updated.
Last update: 2024-09-29 04:31:36 UTC
README
一款WordPress插件,它通过REST API将WordPress作为无头CMS与任何前端环境结合使用,增加了许多功能。你可以根据前端应用的需要使用相关的功能,不一定要使用所有功能。
通过Composer安装
composer require imranhsayed/headless-cms
维护者
资源文件
资源文件目录包含webpack配置,可用于创建块或添加其他自定义脚本,如管理员的javascript脚本。
- 从资源文件目录运行
npm i
以安装所需的npm包。 - 开发期间使用
npm run dev
为资源文件。 - 生产环境中使用
npm run prod
。 - 使用
npm run eslint:fix js/fileName.js
修复和检查eslint错误和警告。
REST API 端点
本插件通过WordPress REST API提供不同的端点。
入门 📋
以下说明将帮助您在本地机器上创建项目副本并运行,以进行开发。
先决条件 🚪
您需要在WordPress项目中激活任何已启用的REST API的WordPress主题。
安装 🔧
- 在
/wp-content/plugins/
目录中克隆插件目录,或直接通过 WordPress插件 屏幕安装此插件的压缩目录。 - 通过WordPress中的“插件”屏幕激活插件
前端应用示例
此插件可以使用的示例前端应用
功能
- 自定义REST API端点。
- 自定义设置器中的社交链接。
- 类别图片上传。
- 自定义页眉和页脚菜单。
- 自定义小工具。
- 使用 wp-graphql 插件时,注册自定义页眉和页脚GraphQL字段
- 在GraphQL Api中添加coAuthors数据。
- 在自定义设置器中添加添加社交链接的选项
- 注册两个自定义菜单,用于页眉(菜单位置 = hcms-menu-header)和页脚(菜单位置 = hcms-menu-footer)
- 注册以下侧边栏
- HCMS页脚 #1,侧边栏ID为 'hcms-sidebar-1'
- HCMS页脚 #2,侧边栏ID为 'hcms-sidebar-2'
- 在编辑器中添加前端预览链接选项。要使预览功能正常工作,您还需要wp-graphql-jwt-authentication 插件
更多功能
- 在自定义设置器中注册社交图标部分
- “facebook”、“twitter”、“instagram”、“youtube”的社交图标URL
- 类别图片上传功能
- 提供类别图片上传功能。
- 插件设置页面
-
获取自定义页面(如英雄部分、搜索部分、特色帖子部分、最新帖子标题)数据的设置。
-
注册自定义端点
- 使用 wp-graphql 插件时的以下字段。
{ wooCountries { billingCountries { countryCode countryName } shippingCountries { countryCode countryName } } wooStates(countryCode: "in") { states { stateCode stateName } } }
- WooCommerce 配送区域。
{ shippingInfo { shippingZones storePostCode } }
- 将产品添加到愿望清单突变(认证请求)
mutation ADD_ITEM { addToWishlist(input: {clientMutationId: "example", productId: 340}) { clientMutationId error added productId wishlistProductIds } }
- 从愿望清单中删除产品突变(认证请求)
mutation REMOVE_ITEM{ removeFromWishlist(input: {clientMutationId: "example", productId: 340}) { error productId removed wishlistProductIds } }
- 从愿望清单中获取产品突变(认证请求)
query GET_WISHLIST { getWishList { productIds error products { databaseId name slug buttonText image { alt src attachmentId } priceHtml productUrl stockQuantity stockStatus typename } } }
- Schema 详细信息
posts { nodes { seo { schemaDetails } } }
可用端点
获取单个帖子(GET 请求)
http://example.com/wp-json/rae/v1/post?post_id=1
按页码获取帖子:(GET 请求)
http://example.com/wp-json/rae/v1/posts?page_no=1
获取页眉和页脚日期:(GET 请求)
- 获取页眉数据(网站标题、网站描述、网站标志 URL、菜单项)和页脚数据(页脚菜单项、社交媒体图标)
http://example.com/wp-json/rae/v1/header-footer?header_location_id=hcms-menu-header&footer_location_id=hcms-menu-footer
获取 WooCommerce 国家和州(GET 请求)
/wp-json/rae/v1/wc/countries/
/wp-json/rae/v1/wc/states?countryCode=IN
贡献 👥
请阅读 CONTRIBUTING.md 了解我们的行为准则以及向我们提交拉取请求的流程。
版本控制
我使用 Git 进行版本控制。