Download the PHP package imranhsayed/headless-cms without Composer

Headless CMS

A WordPress plugin that adds features to use WordPress as a headless CMS with any front-end environment using REST API. This plugin provides multiple features and you can use the one's that are relevant to your front-end application. You don't necessarily need to use all.

Install via Composer

• https://packagist.org/packages/imranhsayed/headless-cms

Maintainer

Assets

Assets folder contains webpack setup and can be used for creating blocks or adding any other custom scripts like javascript for admin.

• Run npm i from assets folder to install required npm packages.
• Use npm run dev during development for assets.
• Use npm run prod for production.
• Use npm run eslint:fix js/fileName.js for fixing and linting eslint errors and warning.

REST API ENDPOINT

This plugin provides you different endpoints using WordPress REST API.

Getting Started :clipboard:

These instructions will get you a copy of the project up and running on your local machine for development purposes.

Prerequisites :door:

You need to have any WordPress theme activated on your WordPress project, which has REST API enabled.

Installation :wrench:

1. Clone the plugin directory in the /wp-content/plugins/ directory, or install a zipped directory of this plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress

Example Frontend applications

Example of front-end applications where this plugin can be used:

1. Gatsby WordPress Theme
2. React Wordpress Theme

Features

1. Custom REST API Endpoints.
2. Social links in customizer.
3. Image uploads for categories.
4. Custom header and footer menus.
5. Custom Widgets.
6. Custom Header and Footer GraphQL fields when using wp-graphql plugin
7. Adds coAuthors data in the GraphQL Api.

• Adds option to add social links in customizer
• Registers two custom menus for header ( menu location = hcms-menu-header ) and for footer ( menu location = hcms-menu-footer )
• Registers the following sidebars

1. HCMS Footer #1 with sidebar id 'hcms-sidebar-1'

2. HCMS Footer #2 with sidebar id 'hcms-sidebar-2'

• Adds frontend preview link option in the editor. For Preview to work , you also need the wp-graphql-jwt-authentication plugin as well

More Features

1. Registers the sections for socials icons in the customizer

• Social icons urls for 'facebook', 'twitter', 'instagram', 'youtube'

2. Image upload features for categories

• Provides Image upload features for categories.

3. Plugin Settings Page

• Settings for getting data for a custom page like Hero section, Search section, Featured post section, latest posts heading.

• Registers custom end points

4. Following fields when using wp-graphql plugin.

• Custom Header and Footer GraphQL

• WooCommerce Countries and States

• WooCommerce Shipping Zones.

• Add Product to Wishlist Mutation ( Authenticated request )

• Remove Product from Wishlist Mutation( Authenticated request )

• Get Products from Wishlist Mutation ( Authenticated request )

• Schema Details

Available Endpoints:

Get single post ( GET request )

• http://example.com/wp-json/rae/v1/post?post_id=1

Get posts by page no: ( GET Request )

• http://example.com/wp-json/rae/v1/posts?page_no=1

Get header and footer date: ( GET Request )

• Get the header data ( site title, site description , site logo URL, menu items ) and footer data ( footer menu items, social icons )
• http://example.com/wp-json/rae/v1/header-footer?header_location_id=hcms-menu-header&footer_location_id=hcms-menu-footer

Get WooCommerce Country and states ( GET Request )

• /wp-json/rae/v1/wc/countries/
• /wp-json/rae/v1/wc/states?countryCode=IN

Contributing :busts_in_silhouette:

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

I use Git for versioning.

Author :pencil:

• Imran Sayed

License :scroll:

• GPLv2