natata7 / demchco-acf-blocks

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

DEMCHCO ACF Blocks

With the advent of Gutenberg in WordPress, Advanced Custom Fields stepped up to help make the process of creating custom blocks easier and faster. This plugin creates a set of custom blocks with basic styles for you to customize.

Documentation

You'll find information around installation and getting started below. Start there to get everything installed and working. Once that's done, go here for more detailed documentation.

Included Blocks

This plugin includes the following blocks:

  • Accordion
  • Call to Action
  • Cards (Repeater, up to 3)
  • Carousel
  • Logo Grid
  • Quotes
  • Side-by-Side
  • Tabs

WDS ACF Blocks is bundled with Style Lint, ESLint, and PHPCS linting rulesets – plus, it passes both WCAG 2.1AA and Section 508 standards out of the box. This plugin uses WP Scripts to handle the build process for the blocks.

To better manage ACF Field Groups, the plugin supports synchronized JSON for Advanced Custom Fields.

Getting Started

Prerequisites

Because the plugin compiles and bundles assets via NPM scripts, basic knowledge of the command line and the following dependencies are required: Node LTS and NPM.

IMPORTANT

This plugin relies entirely on Advanced Custom Fields Pro 6.0+ for WordPress. The Pro version is required, along with a version greater than > 6.0 - it will not work with any ACF 5.x version. Additonally, the WebDevStudios theme wd_s is required - there are dependencies in the theme that this plugin relies on.

Installation

Follow these steps:

From the command line, change directories to your new plugin directory:

cd /plugins/demchco-acf-blocks

Install plugin dependencies and trigger an initial build:

npm i

NPM Scripts

From the command line, type any of the following to perform an action:

npm run build - Compile and build all assets.

npm run start - Automatically compile the SCSS & Tailwind to CSS; minifies the JS. This will also build all the blocks using WP Scripts.

About


Languages

Language:PHP 88.1%Language:JavaScript 6.5%Language:SCSS 5.4%Language:CSS 0.1%