├── .editorconfig
├── .github
    └── workflows
    │   └── php.yml
├── .gitignore
├── .phpunit-watcher.yml
├── LICENSE
├── README.md
├── composer.json
├── frontend
    ├── .eslintrc.js
    ├── .gitignore
    ├── assets
    │   ├── .gitkeep
    │   ├── index.js
    │   └── style.css
    ├── gulpfile.esm.js
    ├── index.html
    ├── package.json
    ├── postcss.config.js
    ├── public
    │   ├── favicon.ico
    │   ├── images
    │   │   ├── spinner-2x.gif
    │   │   ├── spinner.gif
    │   │   ├── stars-2x.png
    │   │   └── stars.png
    │   ├── wp-includes
    │   │   └── fonts
    │   │   │   ├── dashicons.eot
    │   │   │   ├── dashicons.svg
    │   │   │   ├── dashicons.ttf
    │   │   │   ├── dashicons.woff
    │   │   │   └── dashicons.woff2
    │   └── wp.css
    ├── src
    │   ├── App.vue
    │   ├── assets
    │   │   └── logo.png
    │   ├── components
    │   │   ├── Spinner.vue
    │   │   ├── Windsor.vue
    │   │   ├── WindsorError.vue
    │   │   ├── WindsorFieldGroupItem.vue
    │   │   ├── WindsorFieldGroups.vue
    │   │   ├── WindsorHeader.vue
    │   │   ├── WindsorSidebar.vue
    │   │   ├── WindsorYamlPreview.vue
    │   │   └── useLoadYaml.js
    │   ├── index.css
    │   ├── main.js
    │   ├── store.js
    │   └── utils
    │   │   ├── ajax.js
    │   │   ├── clipboard.js
    │   │   ├── config.js
    │   │   └── repository.js
    ├── tailwind.config.js
    ├── vite.config.js
    └── yarn.lock
├── phpcs.xml
├── screenshot.png
├── src
    ├── AcfBlock.php
    ├── AcfServiceProvider.php
    ├── Admin
    │   ├── Exporter
    │   │   ├── CompactRules
    │   │   │   ├── CompactAccordion.php
    │   │   │   ├── CompactButtonGroup.php
    │   │   │   ├── CompactCheckbox.php
    │   │   │   ├── CompactClone.php
    │   │   │   ├── CompactField.php
    │   │   │   ├── CompactFieldGroup.php
    │   │   │   ├── CompactFile.php
    │   │   │   ├── CompactFlexibleContent.php
    │   │   │   ├── CompactGallery.php
    │   │   │   ├── CompactGoogleMap.php
    │   │   │   ├── CompactHelper.php
    │   │   │   ├── CompactImage.php
    │   │   │   ├── CompactLayout.php
    │   │   │   ├── CompactMessage.php
    │   │   │   ├── CompactNumber.php
    │   │   │   ├── CompactOEmbed.php
    │   │   │   ├── CompactPageLink.php
    │   │   │   ├── CompactPostObject.php
    │   │   │   ├── CompactRadio.php
    │   │   │   ├── CompactRange.php
    │   │   │   ├── CompactRelationship.php
    │   │   │   ├── CompactRepeater.php
    │   │   │   ├── CompactRichEditor.php
    │   │   │   ├── CompactSelect.php
    │   │   │   ├── CompactTab.php
    │   │   │   ├── CompactTaxonomy.php
    │   │   │   ├── CompactTextArea.php
    │   │   │   ├── CompactTrueFalse.php
    │   │   │   └── CompactUser.php
    │   │   ├── FieldGroupsStore.php
    │   │   ├── FieldsPacker.php
    │   │   ├── MutableField.php
    │   │   ├── MutableFieldCollection.php
    │   │   └── YamlComposer.php
    │   └── WordPress
    │   │   ├── AjaxHandler.php
    │   │   └── UiLoader.php
    ├── Capsule
    │   ├── AbstractCapsule.php
    │   ├── Block.php
    │   ├── BlueprintBuilder.php
    │   ├── BlueprintsFactory.php
    │   ├── FieldGroup.php
    │   └── Manager.php
    ├── Contracts
    │   └── ParserContract.php
    ├── Parser
    │   ├── Finder.php
    │   └── YamlParser.php
    ├── Rules
    │   ├── FieldConditionRule.php
    │   ├── FieldDefaultsRule.php
    │   ├── GroupLocationRule.php
    │   ├── HelperRule.php
    │   ├── Utilities
    │   │   └── TransformConditionalLogic.php
    │   └── WrapperShortcuts.php
    ├── Support
    │   ├── Config.php
    │   ├── Fluent.php
    │   ├── RulesCollector.php
    │   └── Singleton.php
    ├── config.php
    └── helpers.php
└── tests
    ├── BaseTestCase.php
    ├── BlockSimpleTest.php
    ├── BlueprintsTest.php
    ├── ChangeInstructionsToFoo.php
    ├── CompactRulesTest.php
    ├── ConditionalTest.php
    ├── DummyHandler.php
    ├── FieldsPackerTest.php
    ├── KeysTest.php
    ├── MutableFieldTest.php
    ├── RulesTest.php
    ├── SetupTest.php
    ├── bootstrap.php
    ├── raw
        ├── default.php
        ├── simple-conditional.php
        ├── simple-flex-content.php
        ├── simple-group.php
        └── simple-repeater.php
    └── yaml
        ├── blocks
            ├── block-with-handler.acf.yaml
            └── sample-block.acf.yaml
        ├── blueprints
            ├── my-blueprint.acf.yaml
            ├── test-default.acf.yaml
            ├── test-exclude.acf.yaml
            ├── test-layout.acf.yaml
            ├── test-merge.acf.yaml
            ├── test-only.acf.yaml
            └── test-prefix.acf.yaml
        ├── clones.acf.yaml
        ├── index-empty.yaml
        ├── index.yaml
        ├── keys-static.acf.yaml
        ├── keys.acf.yaml
        ├── rules
            ├── conditional-rules.acf.yaml
            ├── default-rules.acf.yaml
            ├── helper-rules.acf.yaml
            └── wrapper-rules.acf.yaml
        ├── sample-field.acf.yaml
        ├── sample-page.acf.yaml
        ├── sample-post.acf.yaml
        ├── simple.acf.yaml
        └── sub
            ├── fields
                └── empty-field.acf.yaml
            └── index.yaml


/.editorconfig:
--------------------------------------------------------------------------------
 1 | # editorconfig.org
 2 | root = true
 3 | 
 4 | [*]
 5 | indent_style = space
 6 | indent_size = 2
 7 | end_of_line = lf
 8 | charset = utf-8
 9 | trim_trailing_whitespace = true
10 | insert_final_newline = true
11 | 
12 | [*.php]
13 | indent_size = 4
14 | 


--------------------------------------------------------------------------------
/.github/workflows/php.yml:
--------------------------------------------------------------------------------
 1 | name: PHP Composer
 2 | 
 3 | on:
 4 |   push:
 5 |     branches: [ master ]
 6 |   pull_request:
 7 |     branches: [ master ]
 8 | 
 9 | jobs:
10 |   build:
11 | 
12 |     runs-on: ubuntu-latest
13 | 
14 |     steps:
15 |     - uses: actions/checkout@v2
16 | 
17 |     - name: Validate composer.json and composer.lock
18 |       run: composer validate
19 |       
20 |     - name: Cache Composer packages
21 |       id: composer-cache
22 |       uses: actions/cache@v2
23 |       with:
24 |         path: vendor
25 |         key: ${{ runner.os }}-node-${{ hashFiles('**/composer.lock') }}
26 |         restore-keys: |
27 |           ${{ runner.os }}-node-
28 | 
29 |     - name: Install dependencies
30 |       run: composer install --prefer-dist --no-progress --no-suggest
31 | 
32 |     # Add a test script to composer.json, for instance: "test": "vendor/bin/phpunit"
33 |     # Docs: https://getcomposer.org/doc/articles/scripts.md
34 | 
35 |     - name: Run test suite
36 |       run: composer run-script test
37 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # Composer
 2 | composer.phar
 3 | composer.lock
 4 | /vendor/
 5 | 
 6 | # OS files
 7 | .DS_Store
 8 | 
 9 | # Environment file
10 | .env
11 | .env.*.php
12 | .env.php
13 | 
14 | # Logs
15 | php_errors.log
16 | nginx-error.log
17 | nginx-access.log
18 | nginx-ssl.access.log
19 | nginx-ssl.error.log
20 | php-errors.log
21 | yarn-error.log
22 | 
23 | # IDE specific
24 | nbproject
25 | .phpintel
26 | .idea
27 | _ide_helper.php
28 | .phpstorm.meta.php
29 | .vscode


--------------------------------------------------------------------------------
/.phpunit-watcher.yml:
--------------------------------------------------------------------------------
1 | phpunit:
2 |   binaryPath: vendor/bin/phpunit
3 |   arguments: 'tests --bootstrap tests/bootstrap.php --colors=always'
4 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # ACF Windsor
  2 | 
  3 | [![Latest Stable Version](https://poser.pugx.org/jofrysutanto/windsor/v)](//packagist.org/packages/jofrysutanto/windsor) [![Total Downloads](https://poser.pugx.org/jofrysutanto/windsor/downloads)](//packagist.org/packages/jofrysutanto/windsor) [![Latest Unstable Version](https://poser.pugx.org/jofrysutanto/windsor/v/unstable)](//packagist.org/packages/jofrysutanto/windsor) [![License](https://poser.pugx.org/jofrysutanto/windsor/license)](//packagist.org/packages/jofrysutanto/windsor)
  4 | 
  5 | This package extends [Advanced Custom Fields](https://advancedcustomfields.com) plugin for WordPress and enable developers to write their ACF fields blazingly fast in configuration file.
  6 | 
  7 | ![ACF Windsor](https://raw.githubusercontent.com/jofrysutanto/windsor/master/screenshot.png)
  8 | 
  9 | ### Features
 10 | - Permanently lock your custom fields in your version-controlled code, preventing accidental edits that quickly leads to out-of-sync configurations.
 11 | - Create your fields much faster, especially when complimented with the IDE integration.
 12 | - Composition is at the heart of it. Write your own rules to further supercharge your development productivity.
 13 | 
 14 | ### Getting Started
 15 | 
 16 | - The easiest way to install Windsor is to use composer:
 17 | ```sh
 18 | composer require jofrysutanto/windsor
 19 | ```
 20 | - If you are using VSCode, be sure to add the Schema file to your configuration.
 21 | - Ensure you have included composer auto-loader file. If you're not sure, add the following line into your `functions.php` file:
 22 | ```php
 23 | require_once __DIR__ . '/vendor/autoload.php';
 24 | ```
 25 | - Register Windsor on ACF initialization. You may also do this in `functions.php` file:
 26 | ```php
 27 | function register_acf_windsor()
 28 | {
 29 |     \Windsor\Capsule\Manager::make()->register();
 30 | }
 31 | add_action('acf/init', 'register_acf_windsor');
 32 | ```
 33 | - Create YAML entry file at `[your-active-theme]/acf-fields/index.yaml`, where `[your-active-theme]` refers to your currently active WordPress theme directory. At minimum, your entry file should contain:
 34 | ```yaml
 35 | fields: []
 36 | pages: []
 37 | blocks: []
 38 | ```
 39 | - Test your installation:
 40 |   - Create your first custom field YAML, for example create a file `your-theme/acf-fields/page-default.acf.yaml`:
 41 |   ```yaml
 42 |   title: 'Page Default'
 43 |   key: 'page_default'
 44 |   position: 'acf_after_title'
 45 |   hide_on_screen: []
 46 |   location:
 47 |     -
 48 |       -
 49 |         param: 'page_template'
 50 |         operator: '=='
 51 |         value: 'default'
 52 |   fields:
 53 |     heading:
 54 |       type: text
 55 |       label: Heading
 56 |   ```
 57 |   - Register this new ACF file in your index:
 58 |   ```yaml
 59 |   fields: []
 60 |   pages:
 61 |     - page-default.acf.yaml
 62 |   blocks: []
 63 |   ```
 64 |   - You have successfully registered a new field group which will be made available when creating a new default page.
 65 | - Check out our full documentation below. Now go and create beautiful ACF fields!
 66 | 
 67 | ## Migrating Existing Fields
 68 | If you have existing field groups created through ACF interface, you can easily export them out to YAML by enabling the exporter through `ui` configuration when registering Windsor:
 69 | ```php
 70 | function register_acf_windsor()
 71 | {
 72 |     \Windsor\Capsule\Manager::make([
 73 |         'ui' => true
 74 |       ])
 75 |       ->register();
 76 | }
 77 | add_action('acf/init', 'register_acf_windsor');
 78 | ```
 79 | 
 80 | Once enabled, you access the exporter within WordPress backend by clicking on Custom Fields > Export to YAML link in sidebar.
 81 | 
 82 | More information about this tool can be found in [configurations section](https://windsor-docs.netlify.app/configurations.html#ui).
 83 | 
 84 | ## Learn More
 85 | Check out full documentations at [https://windsor-docs.netlify.app/](https://windsor-docs.netlify.app/)
 86 | 
 87 | ## IDE Integration
 88 | 
 89 | Only VSCode integration is available at the moment. To enable autocompletion and useful snippets, follow the installation steps below:
 90 | - If not already installed, download and enable [YAML language server](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml) extension.
 91 | - Update your VSCode [settings](https://code.visualstudio.com/docs/getstarted/settings#_settings-file-locations) (i.e. `settings.json`):
 92 | ```json
 93 | "yaml.schemas": {
 94 |     "https://windsor-docs.netlify.app/schema.json": "*.acf.yaml"
 95 | }
 96 | ```
 97 | 
 98 | ## Credits
 99 | 
100 | This package is written to be used with [Advanced Custom Fields](https://www.advancedcustomfields.com/) plugin by [Elliot Condon](https://www.elliotcondon.com/), who deserves most of the credits for delivering and maintaining such an incredible plugin for WordPress developers.
101 | 
102 | If you have not already started using Advanced Custom Fields, be sure to check it out; it will definitely be worth your while.
103 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "jofrysutanto/windsor",
 3 |     "description": "YAML-ised Configuration for ACF",
 4 |     "homepage": "https://github.com/jofrysutanto/windsor",
 5 |     "type": "package",
 6 |     "keywords": [
 7 |         "wordpress", "advanced-custom-fields"
 8 |     ],
 9 |     "license": "Apache-2.0",
10 |     "authors": [
11 |         {
12 |             "name": "Jofry Sutanto",
13 |             "email": "jofrysutanto@gmail.com"
14 |         }
15 |     ],
16 |     "require": {
17 |         "php": ">=7.0.0",
18 |         "symfony/yaml": "~3.4|~4.0|~5.0",
19 |         "tightenco/collect": "^8.0"
20 |     },
21 |     "require-dev": {
22 |         "squizlabs/php_codesniffer": "^3.2",
23 |         "phpunit/phpunit": "^9",
24 |         "mockery/mockery": "^1.4",
25 |         "spatie/phpunit-watcher": "^1.22"
26 |     },
27 |     "autoload": {
28 |         "psr-4": {
29 |             "Windsor\\": "src/"
30 |         },
31 |         "files": [
32 |             "src/helpers.php"
33 |         ]
34 |     },
35 |     "scripts": {
36 |         "test": [
37 |             "phpcs --extensions=php --standard=PSR2 src/",
38 |             "vendor/bin/phpunit tests --bootstrap tests/bootstrap.php"
39 |         ],
40 |         "fix": [
41 |             "phpcbf src/"
42 |         ]
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/frontend/.eslintrc.js:
--------------------------------------------------------------------------------
 1 | module.exports = {
 2 |   'root': true,
 3 |   'extends': [
 4 |     'eslint:recommended',
 5 |     'plugin:vue/essential',
 6 |   ],
 7 |   'globals': {
 8 |     'wp': true,
 9 |   },
10 |   'env': {
11 |     'node': true,
12 |     'es6': true,
13 |     'amd': true,
14 |     'browser': true,
15 |     'jquery': true,
16 |   },
17 |   'parserOptions': {
18 |     'parser': 'babel-eslint',
19 |     'ecmaFeatures': {
20 |       'globalReturn': true,
21 |       'generators': false,
22 |       'objectLiteralDuplicateProperties': false
23 |     },
24 |     'ecmaVersion': 2017,
25 |     'sourceType': 'module',
26 |   },
27 |   'plugins': [
28 |     'import',
29 |   ],
30 |   'settings': {
31 |     'import/core-modules': [],
32 |     'import/ignore': [
33 |       'node_modules',
34 |       '\\.(coffee|scss|css|less|hbs|svg|json)$',
35 |     ],
36 |   },
37 |   'rules': {
38 |     'no-console': 0,
39 |     'quotes': ['error', 'single'],
40 |     'comma-dangle': [
41 |       'error',
42 |       {
43 |         'arrays': 'always-multiline',
44 |         'objects': 'always-multiline',
45 |         'imports': 'always-multiline',
46 |         'exports': 'always-multiline',
47 |         'functions': 'ignore',
48 |       },
49 |     ],
50 |   },
51 | };
52 | 


--------------------------------------------------------------------------------
/frontend/.gitignore:
--------------------------------------------------------------------------------
1 | node_modules
2 | .DS_Store
3 | dist
4 | *.local


--------------------------------------------------------------------------------
/frontend/assets/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/frontend/assets/.gitkeep


--------------------------------------------------------------------------------
/frontend/gulpfile.esm.js:
--------------------------------------------------------------------------------
 1 | const { join, extname, basename } = require('path')
 2 | const { readdir, stat, copyFileSync } = require('fs')
 3 | const { promisify } = require('util')
 4 | const readdirP = promisify(readdir)
 5 | const statP = promisify(stat)
 6 | 
 7 | const config = {
 8 |   src: './dist/_assets',
 9 |   output: './assets/',
10 |   copy: [
11 |     'index.js',
12 |     'style.css',
13 |   ]
14 | }
15 | 
16 | /**
17 |  * Scan and retrieve all files from given directory
18 |  * @param {String} dir
19 |  * @param {Array} allFiles
20 |  */
21 | async function rreaddir(dir, allFiles = []) {
22 |     const files = (await readdirP(dir)).map(f => join(dir, f))
23 |     allFiles.push(...files)
24 |     await Promise.all(
25 |         files.map(
26 |             async f => (await statP(f)).isDirectory() && rreaddir(f, allFiles)
27 |         )
28 |     )
29 |     return allFiles
30 | }
31 | 
32 | /**
33 |  * Clean up given file path by removing hash.
34 |  * e.g. 'dist/_assets/index.abcdefg.js' -> 'index.js'
35 |  * @param {String} filepath
36 |  */
37 | function removeFileHash (filepath) {
38 |   let fragments = basename(filepath).split('.')
39 |   fragments.splice(fragments.length - 2, 1)
40 |   return fragments.join('.')
41 | }
42 | 
43 | /**
44 |  * Copy and normalise compiled Vite files
45 |  * @param {Closure} cb
46 |  */
47 | async function copy (cb) {
48 |   let assets = await rreaddir(config.src)
49 |   assets.forEach(filepath => {
50 |       if (!extname(filepath)) {
51 |         return
52 |       }
53 |       if (!(filepath.endsWith('.js') || (filepath.endsWith('.css')))) {
54 |         return
55 |       }
56 |       let filename = removeFileHash(filepath)
57 |       if (config.copy.indexOf(filename) === -1) {
58 |         return
59 |       }
60 |       let destination = `${config.output}/${filename}`
61 |       copyFileSync(filepath, destination)
62 |   })
63 |   cb();
64 | }
65 | 
66 | exports.build = copy
67 | 


--------------------------------------------------------------------------------
/frontend/index.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en" class="wp-toolbar">
 3 | <head>
 4 |   <meta charset="UTF-8">
 5 |   <link rel="icon" href="/favicon.ico" />
 6 |   <meta name="viewport" content="width=device-width, initial-scale=1.0">
 7 |   <link rel="stylesheet" href="/wp.css">
 8 |   <!-- <link href="https://unpkg.com/prismjs@v1.x/themes/prism.css" rel="stylesheet" /> -->
 9 |   <link href="https://unpkg.com/prismjs@v1.x/themes/prism-tomorrow.css" rel="stylesheet" />
10 |   <title>Vite App</title>
11 | </head>
12 | <body class="wp-core-ui custom-fields_page_windsor">
13 |   <div id="wpwrap">
14 |     <div id="adminmenumain" role="navigation" aria-label="Main menu">
15 |       <a href="#wpbody-content" class="screen-reader-shortcut">Skip to main content</a>
16 |       <a href="#wp-toolbar" class="screen-reader-shortcut">Skip to toolbar</a>
17 |       <div id="adminmenuback"></div>
18 |       <div id="adminmenuwrap">
19 |           <ul id="adminmenu">
20 |           <li
21 |               class="wp-first-item wp-has-submenu wp-not-current-submenu menu-top menu-top-first menu-icon-dashboard"
22 |               id="menu-dashboard"
23 |           >
24 |               <a
25 |               href="#"
26 |               class="wp-first-item wp-has-submenu wp-not-current-submenu menu-top menu-top-first menu-icon-dashboard"
27 |               aria-haspopup="true"
28 |               >
29 |               <div class="wp-menu-arrow">
30 |                   <div></div>
31 |               </div>
32 |               <div class="wp-menu-image dashicons-before dashicons-admin-site-alt">
33 |                   <br>
34 |               </div>
35 |               <div class="wp-menu-name">Dashboard</div>
36 |               </a>
37 |           </li>
38 |           <li
39 |               class="current menu-top toplevel_page_windsor menu-top-last"
40 |               id="toplevel_page_windsor"
41 |           >
42 |               <a
43 |               href="#"
44 |               class="current menu-top toplevel_page_windsor menu-top-last"
45 |               aria-current="page"
46 |               >
47 |               <div class="wp-menu-arrow">
48 |                   <div></div>
49 |               </div>
50 |               <div class="wp-menu-image dashicons-before dashicons-upload">
51 |                   <br>
52 |               </div>
53 |               <div class="wp-menu-name">ACF Windsor</div>
54 |               </a>
55 |           </li>
56 |           </ul>
57 |       </div>
58 |     </div>
59 |     <div id="wpcontent">
60 |       <div id="wpadminbar">
61 |         <div class="quicklinks" id="wp-toolbar" role="navigation" aria-label="Toolbar">
62 |           <ul id="wp-admin-bar-root-default" class="ab-top-menu">
63 |             <li id="wp-admin-bar-site-name" class="menupop">
64 |               <a class="ab-item" aria-haspopup="true" href="#">My Site</a>
65 |             </li>
66 |           </ul>
67 |           <ul id="wp-admin-bar-top-secondary" class="ab-top-secondary ab-top-menu">
68 |             <li id="wp-admin-bar-my-account" class="menupop with-avatar">
69 |               <a class="ab-item" aria-haspopup="true" href="#">
70 |                 G'day,
71 |                 <span class="display-name">Developer</span>
72 |               </a>
73 |             </li>
74 |           </ul>
75 |         </div>
76 |       </div>
77 |       <div id="wpbody">
78 |         <div id="windsor"></div>
79 |       </div>
80 |     </div>
81 |   </div>
82 |   <!-- These are fade localized Wordpress script, can be configured to test different environment -->
83 |   <script>
84 |   var _acf_windsor = {"acf":{"version":"5.9.0"}};
85 |   </script>
86 |   <!-- These libraries are unfortunately not Vite-compatible and has to be loaded manually via CDN -->
87 |   <!-- These libraries will have to be enqueued in Wordpress, see UiLoader.php -->
88 |   <script src="https://unpkg.com/prismjs@v1.x/components/prism-core.min.js"></script>
89 | 	<script src="https://unpkg.com/prismjs@v1.x/components/prism-yaml.min.js"></script>
90 | 	<script src="https://cdnjs.cloudflare.com/ajax/libs/jszip/3.5.0/jszip.min.js"></script>
91 |   <script type="module" src="/src/main.js"></script>
92 | </body>
93 | </html>
94 | 


--------------------------------------------------------------------------------
/frontend/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "frontend",
 3 |   "version": "0.0.0",
 4 |   "scripts": {
 5 |     "dev": "vite",
 6 |     "build": "vite build && gulp build"
 7 |   },
 8 |   "dependencies": {
 9 |     "@vueuse/core": "^4.0.0-beta.2",
10 |     "axios": "^0.21.1",
11 |     "file-saver": "^2.0.2",
12 |     "vue": "^3.0.0-rc.1"
13 |   },
14 |   "devDependencies": {
15 |     "@tailwindcss/ui": "^0.3.1",
16 |     "@vue/compiler-sfc": "^3.0.0-rc.1",
17 |     "autoprefixer": "^9.8.5",
18 |     "eslint": "^7.5.0",
19 |     "esm": "^3.2.25",
20 |     "gulp": "^4.0.2",
21 |     "tailwindcss": "^1.5.1",
22 |     "vite": "^1.0.0-rc.1"
23 |   }
24 | }
25 | 


--------------------------------------------------------------------------------
/frontend/postcss.config.js:
--------------------------------------------------------------------------------
1 | module.exports = {
2 |   plugins: [
3 |     require('tailwindcss'),
4 |     require('autoprefixer'),
5 |   ]
6 | }
7 | 


--------------------------------------------------------------------------------
/frontend/public/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/frontend/public/favicon.ico


--------------------------------------------------------------------------------
/frontend/public/images/spinner-2x.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/frontend/public/images/spinner-2x.gif


--------------------------------------------------------------------------------
/frontend/public/images/spinner.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/frontend/public/images/spinner.gif


--------------------------------------------------------------------------------
/frontend/public/images/stars-2x.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/frontend/public/images/stars-2x.png


--------------------------------------------------------------------------------
/frontend/public/images/stars.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/frontend/public/images/stars.png


--------------------------------------------------------------------------------
/frontend/public/wp-includes/fonts/dashicons.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/frontend/public/wp-includes/fonts/dashicons.eot


--------------------------------------------------------------------------------
/frontend/public/wp-includes/fonts/dashicons.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/frontend/public/wp-includes/fonts/dashicons.ttf


--------------------------------------------------------------------------------
/frontend/public/wp-includes/fonts/dashicons.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/frontend/public/wp-includes/fonts/dashicons.woff


--------------------------------------------------------------------------------
/frontend/public/wp-includes/fonts/dashicons.woff2:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/frontend/public/wp-includes/fonts/dashicons.woff2


--------------------------------------------------------------------------------
/frontend/src/App.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <windsor/>
 3 | </template>
 4 | 
 5 | <script>
 6 | import Windsor from './components/Windsor.vue'
 7 | 
 8 | export default {
 9 |   name: 'App',
10 |   components: {
11 |     Windsor
12 |   }
13 | }
14 | </script>
15 | 


--------------------------------------------------------------------------------
/frontend/src/assets/logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/frontend/src/assets/logo.png


--------------------------------------------------------------------------------
/frontend/src/components/Spinner.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <div class="absolute top-0 left-0 flex items-center justify-center w-full h-full windsor-spinner-wrap">
 3 |     <div v-if="overlay"
 4 |       class="absolute w-full h-full bg-white opacity-75 cursor-wait">
 5 |     </div>
 6 |     <div class="windsor-spinner"></div>
 7 |   </div>
 8 | </template>
 9 | 
10 | <script>
11 | export default {
12 |   props: {
13 |     overlay: [Boolean],
14 |   },
15 | }
16 | </script>
17 | 
18 | <style scoped>
19 | .windsor-spinner {
20 |   display: block;
21 |   margin-left: auto;
22 |   margin-right: auto;
23 |   width: 50px;
24 |   height: 50px;
25 |   margin-bottom: 50px;
26 |   border: 1px solid rgba(202, 202, 202, 0.6);
27 |   border-radius: 50%;
28 |   border-top-color: rgb(31, 36, 48);
29 |   animation: spin 0.6s linear infinite;
30 | }
31 | @keyframes spin {
32 |   to { transform: rotate(360deg); }
33 | }
34 | </style>
35 | 


--------------------------------------------------------------------------------
/frontend/src/components/Windsor.vue:
--------------------------------------------------------------------------------
  1 | <template>
  2 |   <div class="flex w-full min-h-wp-body">
  3 |     <div class="relative order-2 w-72">
  4 |       <windsor-sidebar />
  5 |     </div>
  6 |     <div class="flex-grow order-1">
  7 |       <windsor-header />
  8 |       <div class="max-w-4xl px-6 py-4 mx-auto">
  9 |         <div
 10 |           v-if="!hasError">
 11 |           <windsor-field-groups
 12 |             :items="fields" />
 13 |           <div v-if="fieldsUnavailable.length > 0"
 14 |             class="mt-8">
 15 |             <div class="bg-white border border-yellow-300">
 16 |               <div class="flex items-center justify-between px-4 py-3">
 17 |                 <div class="">
 18 |                   {{ fieldsUnavailable.length }} field(s) are not shown because they are not available for exporting.
 19 |                 </div>
 20 |                 <div class="flex-shrink-0 pl-4">
 21 |                   <button type="button"
 22 |                     @click="showUnavailable = !showUnavailable"
 23 |                     class="p-1 transition duration-150 ease-in-out rounded-full hover:bg-gray-50 focus:shadow-outline-gray focus:outline-none">
 24 |                     <svg
 25 |                       v-if="!showUnavailable"
 26 |                       class="w-5 h-5 text-gray-400"
 27 |                       fill="currentColor" viewBox="0 0 20 20"><path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm1-11a1 1 0 10-2 0v2H7a1 1 0 100 2h2v2a1 1 0 102 0v-2h2a1 1 0 100-2h-2V7z" clip-rule="evenodd"></path></svg>
 28 |                     <svg
 29 |                       v-else
 30 |                       class="w-5 h-5 text-gray-400"
 31 |                       fill="currentColor" viewBox="0 0 20 20"><path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zM7 9a1 1 0 000 2h6a1 1 0 100-2H7z" clip-rule="evenodd"></path></svg>
 32 |                   </button>
 33 |                 </div>
 34 |               </div>
 35 |               <div class="p-4 bg-gray-50" v-if="showUnavailable">
 36 |                 <div class="flex flex-wrap -mx-2">
 37 |                   <div class="w-1/2 px-2 mb-2 lg:w-1/3"
 38 |                     :key="field.key"
 39 |                     v-for="field in fieldsUnavailable">
 40 |                     <div class="px-4 py-3 bg-white border">
 41 |                       <h4 class="text-sm" v-html="field.title"></h4>
 42 |                       <div class="flex">
 43 |                         <div
 44 |                           style="font-size: 11px;"
 45 |                           class="px-3 py-0.5 mt-2 text-xs text-yellow-500 bg-yellow-100 rounded-full" v-if="field.local === 'php'">
 46 |                           Local PHP
 47 |                         </div>
 48 |                       </div>
 49 |                     </div>
 50 |                   </div>
 51 |                 </div>
 52 |               </div>
 53 |             </div>
 54 |           </div>
 55 | 
 56 |         </div>
 57 |         <windsor-error v-else />
 58 |       </div>
 59 |     </div>
 60 |   </div>
 61 | </template>
 62 | 
 63 | <script>
 64 | import repository from './../utils/repository'
 65 | import WindsorHeader from "./WindsorHeader.vue";
 66 | import WindsorSidebar from "./WindsorSidebar.vue";
 67 | import WindsorFieldGroups from "./WindsorFieldGroups.vue";
 68 | import WindsorError from "./WindsorError.vue";
 69 | export default {
 70 |   setup () {
 71 |   },
 72 |   data () {
 73 |     return {
 74 |       fields: [],
 75 |       fieldsUnavailable: [],
 76 |       showUnavailable: false,
 77 |       hasError: false,
 78 |       ui: _acf_windsor.acf.ui
 79 |     }
 80 |   },
 81 |   components: {
 82 |     WindsorHeader,
 83 |     WindsorSidebar,
 84 |     WindsorFieldGroups,
 85 |     WindsorError,
 86 |   },
 87 |   computed: {
 88 |   },
 89 |   async mounted () {
 90 |     try {
 91 |       const { fields, fields_unavailable } = await repository.fetchAll()
 92 |       this.fields = fields
 93 |       this.fieldsUnavailable = fields_unavailable
 94 |     } catch (error) {
 95 |       console.error(error)
 96 |       this.hasError = error
 97 |     }
 98 |   }
 99 | }
100 | </script>
101 | 


--------------------------------------------------------------------------------
/frontend/src/components/WindsorError.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 | <div class="relative flex max-w-4xl p-4 mx-auto text-red-700 rounded shadow-md bg-red-50">
 3 |   <div class="flex-shrink-0">
 4 |     <svg
 5 |       class="w-12 h-12 mr-4 text-red-400"
 6 |       fill="currentColor" viewBox="0 0 20 20"><path fill-rule="evenodd" d="M11.757 2.034a1 1 0 01.638.519c.483.967.844 1.554 1.207 2.03.368.482.756.876 1.348 1.467A6.985 6.985 0 0117 11a7.002 7.002 0 01-14 0c0-1.79.684-3.583 2.05-4.95a1 1 0 011.707.707c0 1.12.07 1.973.398 2.654.18.374.461.74.945 1.067.116-1.061.328-2.354.614-3.58.225-.966.505-1.93.839-2.734.167-.403.356-.785.57-1.116.208-.322.476-.649.822-.88a1 1 0 01.812-.134zm.364 13.087A2.998 2.998 0 017 13s.879.5 2.5.5c0-1 .5-4 1.25-4.5.5 1 .786 1.293 1.371 1.879.586.585.879 1.353.879 2.121s-.293 1.536-.879 2.121z" clip-rule="evenodd"></path></svg>
 7 |   </div>
 8 |   <div>
 9 |     <h3 class="mb-2 text-lg text-red-800">Yikes, something went really wrong.</h3>
10 |     <p class="text-red-800">
11 |       We can't seem to load this page correctly; please try again later. If issue persists, consider reporting this issue to the developer. If you are a more hands-on type user, more information might be available in your console.
12 |     </p>
13 |   </div>
14 | </div>
15 | </template>
16 | 
17 | <script>
18 | export default {
19 | 
20 | }
21 | </script>
22 | 
23 | <style>
24 | 
25 | </style>
26 | 


--------------------------------------------------------------------------------
/frontend/src/components/WindsorFieldGroupItem.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <div class="transition-all duration-150 ease-in-out"
 3 |     :class="{
 4 |       'my-4 -mx-2': isActive,
 5 |       'my-0 mx-0': isActive,
 6 |     }">
 7 |     <div>
 8 |       <a
 9 |         href="javascript:;"
10 |         @click="activePreview = (isActive) ? null : field.key"
11 |         class="block transition duration-150 ease-in-out hover:bg-gray-50 focus:outline-none focus:bg-gray-50 focus:shadow-none">
12 |         <div class="flex items-center px-2 py-3">
13 |           <div class="flex items-center flex-1 min-w-0">
14 |             <div class="flex-1 min-w-0 px-4 md:grid md:grid-cols-2 md:gap-4">
15 |               <div>
16 |                 <div class="text-sm font-medium leading-5 truncate text-wp-blue">
17 |                   {{ field.title }}
18 |                 </div>
19 |                 <div class="flex items-center mt-1 text-sm leading-5 text-gray-500">
20 |                   <span class="text-xs italic truncate">
21 |                     {{ field.key }}
22 |                   </span>
23 |                 </div>
24 |               </div>
25 |               <div class="self-center hidden text-right md:block">
26 |                 <div class="ml-auto">
27 |                   <div class="inline-flex items-center justify-center w-6 h-6 px-3 py-1 text-xs leading-5 text-center text-gray-800 bg-gray-200 rounded-full">
28 |                     {{ field.count }}
29 |                   </div>
30 |                 </div>
31 |               </div>
32 |             </div>
33 |           </div>
34 |           <div class="pr-2">
35 |             <svg class="w-5 h-5 text-gray-400 transition duration-150 transform"
36 |               :class="{
37 |                 'rotate-90': isActive,
38 |                 'rotate-0': !isActive,
39 |               }"
40 |               viewBox="0 0 20 20" fill="currentColor">
41 |               <path fill-rule="evenodd" d="M7.293 14.707a1 1 0 010-1.414L10.586 10 7.293 6.707a1 1 0 011.414-1.414l4 4a1 1 0 010 1.414l-4 4a1 1 0 01-1.414 0z" clip-rule="evenodd" />
42 |             </svg>
43 |           </div>
44 |         </div>
45 |       </a>
46 |     </div>
47 |     <!-- Expand YAML -->
48 |     <windsor-yaml-preview
49 |       v-if="isActive"
50 |       :field-key="field.key" />
51 |   </div>
52 | </template>
53 | 
54 | <script>
55 | import { useGlobalState } from "./../store";
56 | import WindsorYamlPreview from "./WindsorYamlPreview.vue";
57 | import { toRefs, computed } from 'vue';
58 | export default {
59 |   props: ['field'],
60 |   setup (props) {
61 |     const { activePreview } = toRefs(useGlobalState())
62 |     const { field } = toRefs(props)
63 |     const isActive = computed(() => {
64 |       return field.value.key === activePreview.value
65 |     })
66 |     return {
67 |       activePreview,
68 |       isActive
69 |     }
70 |   },
71 |   components: {
72 |     WindsorYamlPreview,
73 |   }
74 | }
75 | </script>
76 | 


--------------------------------------------------------------------------------
/frontend/src/components/WindsorFieldGroups.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <div class="">
 3 |     <div class="my-0">
 4 |       <windsor-field-group-item
 5 |         :key="field.key"
 6 |         class="bg-white "
 7 |         :class="{
 8 |           'border-t border-gray-200': index > 0
 9 |         }"
10 |         :field="field"
11 |         v-for="(field, index) in items"/>
12 |     </div>
13 |   </div>
14 | </template>
15 | 
16 | <script>
17 | import WindsorFieldGroupItem from "./WindsorFieldGroupItem.vue";
18 | export default {
19 |   props: {
20 |     items: {
21 |       type: [Array]
22 |     }
23 |   },
24 |   data () {
25 |     return {
26 |     }
27 |   },
28 |   components: {
29 |     WindsorFieldGroupItem,
30 |   },
31 |   methods: {
32 |   },
33 | }
34 | </script>
35 | 


--------------------------------------------------------------------------------
/frontend/src/components/WindsorHeader.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <div>
 3 |     <div class="flex items-center justify-between px-4 mb-4 bg-white border-b border-acf-border h-acf-header-height">
 4 |       <h1 class="my-0 text-base font-semibold text-gray-800">
 5 |         <span class="font-normal text-gray-600">ACF Windsor -</span> YAML Exporter
 6 |       </h1>
 7 |       <div>
 8 |         <button type="button"
 9 |           @click="showTip = !showTip"
10 |           class="inline-flex items-center justify-center bg-yellow-100 rounded-full w-7 h-7 focus:shadow-outline-orange focus:outline-none">
11 |           <svg
12 |             class="w-6 h-6 text-yellow-300"
13 |             fill="currentColor" viewBox="0 0 20 20"><path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"></path></svg>
14 |         </button>
15 |       </div>
16 |     </div>
17 |     <div class="px-4 pt-4 mb-4 -mt-4"
18 |       v-if="showTip">
19 |       <div class="relative flex items-center max-w-4xl p-4 mx-auto text-yellow-700 rounded shadow-md bg-yellow-50">
20 |         <div class="absolute top-0 right-0 p-2">
21 |           <button type="button"
22 |             @click="showTip = !showTip"
23 |             class="inline-flex items-center justify-center p-1 transition duration-150 ease-in-out rounded-full hover:bg-yellow-100 focus:shadow-outline-orange focus:outline-none">
24 |             <svg
25 |               class="w-4 h-4 text-yellow-300"
26 |               fill="currentColor" viewBox="0 0 20 20"><path fill-rule="evenodd" d="M4.293 4.293a1 1 0 011.414 0L10 8.586l4.293-4.293a1 1 0 111.414 1.414L11.414 10l4.293 4.293a1 1 0 01-1.414 1.414L10 11.414l-4.293 4.293a1 1 0 01-1.414-1.414L8.586 10 4.293 5.707a1 1 0 010-1.414z" clip-rule="evenodd"></path></svg>
27 |           </button>
28 |         </div>
29 |         <div class="flex-shrink-0">
30 |           <svg
31 |             class="w-8 h-8 mr-4 text-yellow-300"
32 |             fill="currentColor" viewBox="0 0 20 20"><path fill-rule="evenodd" d="M8.257 3.099c.765-1.36 2.722-1.36 3.486 0l5.58 9.92c.75 1.334-.213 2.98-1.742 2.98H4.42c-1.53 0-2.493-1.646-1.743-2.98l5.58-9.92zM11 13a1 1 0 11-2 0 1 1 0 012 0zm-1-8a1 1 0 00-1 1v3a1 1 0 002 0V6a1 1 0 00-1-1z" clip-rule="evenodd"></path></svg>
33 |         </div>
34 |         <div>
35 |           It is recommended that you disable this page when you no longer need access to this tool. <br>
36 |           For help on how to safely disable this page, visit our documentation page.
37 |         </div>
38 |       </div>
39 |     </div>
40 |   </div>
41 | </template>
42 | 
43 | <script>
44 | export default {
45 |   data () {
46 |     return {
47 |       showTip: false
48 |     }
49 |   }
50 | }
51 | </script>
52 | 


--------------------------------------------------------------------------------
/frontend/src/components/WindsorSidebar.vue:
--------------------------------------------------------------------------------
  1 | <template>
  2 |   <div class="fixed top-0 right-0 z-10 h-screen pt-8 bg-white border-l border-acf-border w-72">
  3 |     <div class="flex flex-col h-full">
  4 |       <!-- Sidebar Top -->
  5 |       <div>
  6 |         <div class="flex items-center px-4 border-b border-acf-border h-acf-header-height">
  7 |           <h2 class="text-sm font-medium text-gray-700">
  8 |             Settings
  9 |           </h2>
 10 |           <div class="ml-auto">
 11 |             <a href="https://windsor-docs.netlify.app/configurations.html#ui"
 12 |               target="_blank"
 13 |               class="flex items-center w-full text-gray-400 transition duration-150 ease-in-out hover:text-gray-600">
 14 |               <div class="mr-1">Documentation</div>
 15 |               <svg class="flex-shrink-0 inline-block w-4 h-4" fill="currentColor" viewBox="0 0 20 20"><path d="M11 3a1 1 0 100 2h2.586l-6.293 6.293a1 1 0 101.414 1.414L15 6.414V9a1 1 0 102 0V4a1 1 0 00-1-1h-5z"></path><path d="M5 5a2 2 0 00-2 2v8a2 2 0 002 2h8a2 2 0 002-2v-3a1 1 0 10-2 0v3H5V7h3a1 1 0 000-2H5z"></path></svg>
 16 |             </a>
 17 |           </div>
 18 |         </div>
 19 |         <div class="flex flex-col transition duration-150 ease-in-out divide-y border-acf-border divide-y-gray-200">
 20 |           <div class="flex p-4">
 21 |             <div class="flex-grow">
 22 |               <label for="location" class="block text-sm font-medium leading-5 text-black">Indentation</label>
 23 |               <select id="location"
 24 |                 v-model="indentation"
 25 |                 @input="changeIndentation($event.target.value)"
 26 |                 class="block w-full py-2 pl-3 pr-10 mt-1 text-base leading-6 border-gray-300 form-select focus:outline-none focus:shadow-outline-blue focus:border-blue-300 sm:text-sm sm:leading-5">
 27 |                 <option v-for="opt in indentOptions"
 28 |                   :key="opt.value"
 29 |                   :value="opt.value"
 30 |                   v-html="opt.label"></option>
 31 |               </select>
 32 |             </div>
 33 |           </div>
 34 |           <div class="flex p-4 cursor-pointer group hover:bg-gray-50"
 35 |             @click="changeMode(!isModeCompact)">
 36 |             <div class="flex-shrink-0">
 37 |               <span role="checkbox"
 38 |                 tabindex="0"
 39 |                 :aria-checked="isModeCompact"
 40 |                 @keyup.enter="changeMode(!isModeCompact)"
 41 |                 class="relative inline-flex items-center justify-center flex-shrink-0 w-10 h-5 cursor-pointer group focus:outline-none">
 42 |                 <!-- On: "bg-indigo-600", Off: "bg-gray-200" -->
 43 |                 <span aria-hidden="true"
 44 |                   :class="isModeCompact ? 'bg-wp-blue' : 'bg-gray-200'"
 45 |                   class="absolute h-4 mx-auto transition-colors duration-200 ease-in-out bg-gray-200 rounded-full w-9"></span>
 46 |                 <!-- On: "translate-x-5", Off: "translate-x-0" -->
 47 |                 <span aria-hidden="true"
 48 |                   :class="isModeCompact ? 'translate-x-5' : 'translate-x-0'"
 49 |                   class="absolute left-0 inline-block w-5 h-5 transition-transform duration-200 ease-in-out transform translate-x-0 bg-white border rounded-full shadow border-acf-border group-focus:shadow-outline group-focus:border-blue-300"></span>
 50 |               </span>
 51 |             </div>
 52 |             <div class="pl-2">
 53 |               <h4 class="text-sm font-medium text-black transition duration-150 ease-in-out group-hover:text-wp-blue">
 54 |                 Compact Mode
 55 |               </h4>
 56 |               <p class="mt-1 text-xs text-gray-600">
 57 |                 Exclude empty field settings to generate smaller YAML files.
 58 |               </p>
 59 |             </div>
 60 |           </div>
 61 |           <template v-if="isShowingAllSettings">
 62 |           <div class="flex p-4 cursor-pointer group hover:bg-gray-50"
 63 |             @click="isFriendlyFilename = !isFriendlyFilename">
 64 |             <div class="flex-shrink-0">
 65 |               <span role="checkbox"
 66 |                 tabindex="0"
 67 |                 :aria-checked="isFriendlyFilename"
 68 |                 @keyup.enter="isFriendlyFilename = !isFriendlyFilename"
 69 |                 class="relative inline-flex items-center justify-center flex-shrink-0 w-10 h-5 cursor-pointer group focus:outline-none">
 70 |                 <!-- On: "bg-indigo-600", Off: "bg-gray-200" -->
 71 |                 <span aria-hidden="true"
 72 |                   :class="isFriendlyFilename ? 'bg-wp-blue' : 'bg-gray-200'"
 73 |                   class="absolute h-4 mx-auto transition-colors duration-200 ease-in-out bg-gray-200 rounded-full w-9"></span>
 74 |                 <!-- On: "translate-x-5", Off: "translate-x-0" -->
 75 |                 <span aria-hidden="true"
 76 |                   :class="isFriendlyFilename ? 'translate-x-5' : 'translate-x-0'"
 77 |                   class="absolute left-0 inline-block w-5 h-5 transition-transform duration-200 ease-in-out transform translate-x-0 bg-white border rounded-full shadow border-acf-border group-focus:shadow-outline group-focus:border-blue-300"></span>
 78 |               </span>
 79 |             </div>
 80 |             <div class="pl-2">
 81 |               <h4 class="text-sm font-medium text-black transition duration-150 ease-in-out group-hover:text-wp-blue">
 82 |                 Rename YAML fields
 83 |               </h4>
 84 |               <p class="mt-1 text-xs text-gray-600">
 85 |                 Generated YAML filenames are inferred from the title. When disabled, unique keys are used: <i>group_xxxxx.acf.yaml</i>.
 86 |               </p>
 87 |             </div>
 88 |           </div>
 89 |           <div class="flex p-4 cursor-pointer group hover:bg-gray-50"
 90 |             @click="shouldIncludeIndex = !shouldIncludeIndex">
 91 |             <div class="flex-shrink-0">
 92 |               <span role="checkbox"
 93 |                 tabindex="0"
 94 |                 :aria-checked="shouldIncludeIndex"
 95 |                 @keyup.enter="shouldIncludeIndex = !shouldIncludeIndex"
 96 |                 class="relative inline-flex items-center justify-center flex-shrink-0 w-10 h-5 cursor-pointer group focus:outline-none">
 97 |                 <!-- On: "bg-indigo-600", Off: "bg-gray-200" -->
 98 |                 <span aria-hidden="true"
 99 |                   :class="shouldIncludeIndex ? 'bg-wp-blue' : 'bg-gray-200'"
100 |                   class="absolute h-4 mx-auto transition-colors duration-200 ease-in-out bg-gray-200 rounded-full w-9"></span>
101 |                 <!-- On: "translate-x-5", Off: "translate-x-0" -->
102 |                 <span aria-hidden="true"
103 |                   :class="shouldIncludeIndex ? 'translate-x-5' : 'translate-x-0'"
104 |                   class="absolute left-0 inline-block w-5 h-5 transition-transform duration-200 ease-in-out transform translate-x-0 bg-white border rounded-full shadow border-acf-border group-focus:shadow-outline group-focus:border-blue-300"></span>
105 |               </span>
106 |             </div>
107 |             <div class="pl-2">
108 |               <h4 class="text-sm font-medium text-black transition duration-150 ease-in-out group-hover:text-wp-blue">
109 |                 Generate Index YAML
110 |               </h4>
111 |               <p class="mt-1 text-xs text-gray-600">
112 |                 Include <code>index.yaml</code> which you can drop into <code>acf-yaml/</code> directly to auto-register fields via Windsor.
113 |               </p>
114 |             </div>
115 |           </div>
116 |           </template>
117 |           <a
118 |             href="javascript:;"
119 |             class="flex justify-center px-4 py-2 text-gray-500 no-underline cursor-pointer group hover:text-wp-blue"
120 |             @click="isShowingAllSettings = !isShowingAllSettings">
121 |             <span v-if="!isShowingAllSettings">Show All Settings</span>
122 |             <span v-else>Hide Extra Settings</span>
123 |           </a>
124 |         </div>
125 |       </div>
126 |       <!-- ./ Sidebar Top -->
127 |       <div class="mt-auto">
128 |         <div class="px-6 py-3 border-t border-acf-border">
129 |           <button
130 |             @click="onExport"
131 |             type="button"
132 |             class="block w-full button button-primary button-large">
133 |             Export All
134 |           </button>
135 |         </div>
136 |       </div>
137 |     </div>
138 |   </div>
139 | 
140 | </template>
141 | 
142 | <script>
143 | import repository from "./../utils/repository";
144 | import { useGlobalState } from "./../store";
145 | import { toRefs, ref } from 'vue';
146 | import fileSaver from 'file-saver';
147 | export default {
148 |   setup () {
149 |     let { isModeCompact, changeMode, indentation, changeIndentation } = toRefs(useGlobalState())
150 |     let isFriendlyFilename = ref(true)
151 |     let shouldIncludeIndex = ref(true)
152 |     let isShowingAllSettings = ref(false)
153 |     let indentOptions = ref([
154 |       { value: 2, label: '2 Spaces' },
155 |       { value: 4, label: '4 Spaces' },
156 |       { value: 6, label: '6 Spaces' },
157 |       { value: 8, label: '8 Spaces' },
158 |     ])
159 |     return {
160 |       isModeCompact,
161 |       indentation,
162 |       indentOptions,
163 |       isFriendlyFilename,
164 |       shouldIncludeIndex,
165 |       isShowingAllSettings,
166 |       changeMode,
167 |       changeIndentation,
168 |     }
169 |   },
170 |   methods: {
171 |     async onExport () {
172 |       let mode = this.isModeCompact ? 'compact' : 'full'
173 |       let indent = this.indentation
174 |       let { fields } = await repository.export({
175 |         mode,
176 |         indent,
177 |         include_index: this.shouldIncludeIndex,
178 |         rename_files: this.isFriendlyFilename,
179 |       })
180 |       var zip = new window.JSZip()
181 |       fields.forEach(({ filename, content }) => {
182 |         zip.file(filename, content);
183 |       });
184 |       let blob = await zip.generateAsync({ type:"blob" })
185 |       fileSaver.saveAs(blob, 'acf-yaml.zip')
186 |     }
187 |   }
188 | }
189 | </script>
190 | 


--------------------------------------------------------------------------------
/frontend/src/components/WindsorYamlPreview.vue:
--------------------------------------------------------------------------------
 1 | <template>
 2 |   <div class="relative">
 3 |     <pre
 4 |       :class="{
 5 |         'h-72': isLoadingYaml
 6 |       }"
 7 |       class="px-6 py-4 mt-0 overflow-y-auto max-h-96 language-yaml line-numbers rounded-b-md"><code class="p-0 language-yaml" v-html="fieldYaml"></code></pre>
 8 |     <div v-if="!isLoadingYaml"
 9 |       class="absolute top-0 right-0 p-2">
10 |       <button
11 |         title="Copy to clipboard"
12 |         @click="copyToClipboard(fieldYaml)"
13 |         type="button"
14 |         class="inline-flex items-center justify-center p-1 bg-transparent rounded-sm hover:bg-gray-600 focus:outline-none focus:border-gray-700 focus:shadow-outline-gray">
15 |         <svg
16 |           class="inline-block w-5 h-5 text-gray-400"
17 |           fill="currentColor" viewBox="0 0 20 20"><path d="M8 3a1 1 0 011-1h2a1 1 0 110 2H9a1 1 0 01-1-1z"></path><path d="M6 3a2 2 0 00-2 2v11a2 2 0 002 2h8a2 2 0 002-2V5a2 2 0 00-2-2 3 3 0 01-3 3H9a3 3 0 01-3-3z"></path></svg>
18 |       </button>
19 |     </div>
20 |     <spinner v-if="isLoadingYaml && !hasError" />
21 |     <div class="absolute inset-0 flex items-center justify-center" v-if="hasError">
22 |       <div class="max-w-sm px-4 py-2 mx-auto text-center text-white bg-red-500 rounded-sm shadow-lg">
23 |         Whoops sorry, something went wrong.
24 |       </div>
25 |     </div>
26 |   </div>
27 | </template>
28 | 
29 | <script>
30 | import { useGlobalState } from "./../store";
31 | import { copyToClipboard } from "./../utils/clipboard";
32 | import { toRefs, markRaw, onMounted, ref, watch } from 'vue';
33 | import { useLoadYaml } from "./useLoadYaml";
34 | import Spinner from "./Spinner.vue";
35 | 
36 | const cmConfig = {
37 |   mode: 'yaml',
38 |   lineNumbers: true,
39 |   foldGutter: false,
40 |   gutters: [],
41 |   tabSize: 2,
42 |   indentUnit: 2,
43 |   lineWrapping: false,
44 |   theme: 'ayu-mirage',
45 |   readOnly: true,
46 | }
47 | 
48 | export default {
49 |   props: ['field-key'],
50 |   data () {
51 |     return {
52 |       codemirror: null
53 |     }
54 |   },
55 |   components: {
56 |     Spinner,
57 |   },
58 |   setup (props) {
59 |     const { fieldKey } = toRefs(props)
60 |     let { fieldYaml, isLoadingYaml, hasError } = useLoadYaml(fieldKey)
61 |     let cmTextarea = ref(null)
62 |     let cm = ref(null)
63 | 
64 |     watch(fieldYaml, (newVal) => {
65 |       window.Prism.highlightAll()
66 |     }, { deep: true })
67 | 
68 |     onMounted(() => {
69 |       setTimeout(() => {
70 |         window.Prism.highlightAll()
71 |       }, 10);
72 |     })
73 |     return {
74 |       cm,
75 |       cmTextarea,
76 |       isLoadingYaml,
77 |       hasError,
78 |       fieldYaml,
79 |       copyToClipboard,
80 |     }
81 |   }
82 | }
83 | </script>
84 | 
85 | <style>
86 | </style>
87 | 


--------------------------------------------------------------------------------
/frontend/src/components/useLoadYaml.js:
--------------------------------------------------------------------------------
 1 | import { onMounted, computed, ref, toRefs } from 'vue'
 2 | import { useGlobalState } from "./../store";
 3 | 
 4 | export const useLoadYaml = (fieldKey) => {
 5 |   const { yamlFields, isLoadingField } = toRefs(useGlobalState())
 6 |   const { loadField } = useGlobalState()
 7 |   let hasError = ref(false)
 8 |   const fieldYaml = computed(() => {
 9 |     return yamlFields.value[fieldKey.value]
10 |   })
11 |   onMounted(async () => {
12 |     try {
13 |       await loadField(fieldKey.value)
14 |     } catch (error) {
15 |       console.error(error)
16 |       hasError.value = true
17 |     }
18 |   })
19 |   let isLoadingYaml = computed(() => {
20 |     return isLoadingField.value === fieldKey.value
21 |   })
22 |   return {
23 |     isLoadingYaml,
24 |     hasError,
25 |     fieldYaml
26 |   }
27 | }
28 | 


--------------------------------------------------------------------------------
/frontend/src/index.css:
--------------------------------------------------------------------------------
 1 | @tailwind base;
 2 | 
 3 | @tailwind components;
 4 | 
 5 | @tailwind utilities;
 6 | 
 7 | body.custom-fields_page_windsor #wpcontent {
 8 |   padding-left: 0;
 9 | }
10 | 


--------------------------------------------------------------------------------
/frontend/src/main.js:
--------------------------------------------------------------------------------
1 | import { createApp } from 'vue'
2 | import Windsor from './components/Windsor.vue'
3 | import './index.css'
4 | 
5 | createApp(Windsor).mount('#windsor')
6 | 


--------------------------------------------------------------------------------
/frontend/src/store.js:
--------------------------------------------------------------------------------
 1 | import { createGlobalState } from '@vueuse/core'
 2 | import { ref, watch } from 'vue'
 3 | import repository from './utils/repository'
 4 | 
 5 | export const useGlobalState = createGlobalState(
 6 |   () => {
 7 |     let isModeCompact = ref(true)
 8 |     let indentation = ref(2)
 9 |     let yamlFields = ref({})
10 |     let activePreview = ref(null)
11 |     let isLoadingField = ref(null)
12 | 
13 |     const changeMode = (mode) => {
14 |       isModeCompact.value = mode
15 |     }
16 | 
17 |     const changeIndentation = (newVal) => {
18 |       indentation.value = newVal
19 |     }
20 | 
21 |     const loadField = async (key) => {
22 |       if (typeof yamlFields.value[key] !== 'undefined') {
23 |         return
24 |       }
25 |       isLoadingField.value = key
26 |       let { yaml } = await repository.fetchSingle({
27 |         key,
28 |         indent: indentation.value,
29 |         mode: (isModeCompact.value === true) ? 'compact' : 'full'
30 |       })
31 |       yamlFields.value[key] = yaml
32 |       isLoadingField.value = null
33 |     }
34 | 
35 |     watch([isModeCompact, indentation], () => {
36 |       yamlFields.value = {}
37 |       if (activePreview.value) {
38 |         loadField(activePreview.value)
39 |       }
40 |     })
41 | 
42 |     return {
43 |       isModeCompact,
44 |       indentation,
45 |       isLoadingField,
46 |       yamlFields,
47 |       activePreview,
48 |       changeMode,
49 |       changeIndentation,
50 |       loadField,
51 |     }
52 |   },
53 | )
54 | 


--------------------------------------------------------------------------------
/frontend/src/utils/ajax.js:
--------------------------------------------------------------------------------
 1 | import config from './config'
 2 | import axios from 'axios'
 3 | export default {
 4 |   post (params) {
 5 |     // Use FormData instead of normal POST parameters,
 6 |     // @see https://wordpress.stackexchange.com/questions/282163/wordpress-ajax-with-axios
 7 |     let form_data = new FormData;
 8 |     for (const key in params) {
 9 |       if (params.hasOwnProperty(key)) {
10 |         form_data.append(key, params[key])
11 |       }
12 |     }
13 |     return axios.post(config.ajaxurl, form_data, {
14 |       ...this.buildHeaders()
15 |     })
16 |   },
17 |   buildHeaders () {
18 |     return {
19 |       headers: {
20 |         'Content-Type': 'application/json'
21 |       }
22 |     }
23 |   }
24 | }
25 | 


--------------------------------------------------------------------------------
/frontend/src/utils/clipboard.js:
--------------------------------------------------------------------------------
 1 | export const copyToClipboard = (str) => {
 2 |   /* ——— Derived from: https://hackernoon.com/copying-text-to-clipboard-with-javascript-df4d4988697f
 3 |           improved to add iOS device compatibility——— */
 4 |   const el = document.createElement('textarea'); // Create a <textarea> element
 5 | 
 6 |   let storeContentEditable = el.contentEditable;
 7 |   let storeReadOnly = el.readOnly;
 8 | 
 9 |   el.value = str; // Set its value to the string that you want copied
10 |   el.contentEditable = true;
11 |   el.readOnly = false;
12 |   el.setAttribute('readonly', false); // Make it readonly false for iOS compatability
13 |   el.setAttribute('contenteditable', true); // Make it editable for iOS
14 |   el.style.position = 'absolute';
15 |   el.style.left = '-9999px'; // Move outside the screen to make it invisible
16 |   document.body.appendChild(el); // Append the <textarea> element to the HTML document
17 |   const selected =
18 |       document.getSelection().rangeCount > 0 // Check if there is any content selected previously
19 |           ? document.getSelection().getRangeAt(0) // Store selection if found
20 |           : false; // Mark as false to know no selection existed before
21 |   el.select(); // Select the <textarea> content
22 |   el.setSelectionRange(0, 999999);
23 |   document.execCommand('copy'); // Copy - only works as a result of a user action (e.g. click events)
24 |   document.body.removeChild(el); // Remove the <textarea> element
25 |   if (selected) {
26 |       // If a selection existed before copying
27 |       document.getSelection().removeAllRanges(); // Unselect everything on the HTML document
28 |       document.getSelection().addRange(selected); // Restore the original selection
29 |   }
30 | 
31 |   el.contentEditable = storeContentEditable;
32 |   el.readOnly = storeReadOnly;
33 | }
34 | 


--------------------------------------------------------------------------------
/frontend/src/utils/config.js:
--------------------------------------------------------------------------------
 1 | let ajaxurl = window.ajaxurl
 2 | 
 3 | if (window.ajaxurl) {
 4 |   ajaxurl = window.ajaxurl
 5 | } else if (import.meta.env.MODE === 'development' && import.meta.env.VITE_WP_AJAX) {
 6 |   ajaxurl = import.meta.env.VITE_WP_AJAX
 7 | }
 8 | 
 9 | export default {
10 |   ajaxurl
11 | }
12 | 


--------------------------------------------------------------------------------
/frontend/src/utils/repository.js:
--------------------------------------------------------------------------------
 1 | import ajax from "./ajax";
 2 | export default new class {
 3 | 
 4 |   async fetchAll () {
 5 |     let { data } = await ajax.post({
 6 |       action: 'windsor_load_fields',
 7 |     })
 8 |     return {
 9 |       fields: data.field_groups,
10 |       fields_unavailable: data.field_groups_unavailable,
11 |     }
12 |   }
13 | 
14 |   async fetchSingle ({key, mode, indent = 2}) {
15 |     let { data } = await ajax.post({
16 |         action: 'windsor_load_single',
17 |         indent,
18 |         key,
19 |         mode
20 |       })
21 |     let { field_group, yaml } = data
22 |     return { field_group, yaml }
23 |   }
24 | 
25 |   async export ({ mode, include_index = true, rename_files = true, indent = 2 }) {
26 |     let { data } = await ajax.post({
27 |       action: 'windsor_export',
28 |       indent,
29 |       mode,
30 |       include_index,
31 |       rename_files,
32 |     })
33 |     let { fields } = data
34 |     return { fields }
35 |   }
36 | 
37 | }
38 | 


--------------------------------------------------------------------------------
/frontend/tailwind.config.js:
--------------------------------------------------------------------------------
 1 | module.exports = {
 2 |   purge: [
 3 |     'src/**/*.vue',
 4 |     'src/**/*.js',
 5 |   ],
 6 |   important: '#windsor',
 7 |   theme: {
 8 |     extend: {
 9 |       height: {
10 |         'acf-header-height': '47px',
11 |       },
12 |       colors: {
13 |         'wp-blue': {
14 |           'medium': '#00A0D2',
15 |           'default': '#0073AA',
16 |         },
17 |         'acf-border': {
18 |           'default': '#ccd0d4',
19 |         }
20 |       },
21 |       minHeight: {
22 |         'wp-body': 'calc(100vh - 32px)',
23 |       },
24 |     },
25 |   },
26 |   variants: {},
27 |   plugins: [
28 |     require('@tailwindcss/ui'),
29 |   ]
30 | }
31 | 


--------------------------------------------------------------------------------
/frontend/vite.config.js:
--------------------------------------------------------------------------------
1 | module.exports = {
2 | }
3 | 


--------------------------------------------------------------------------------
/phpcs.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0"?>
 2 | <ruleset name="Sober">
 3 |   <description>Sober Coding Standards</description>
 4 | 
 5 |   <rule ref="PSR2">
 6 |     <exclude name="Generic.Files.LineLength"/>
 7 |     <exclude name="PSR1.Files.SideEffects"/>
 8 |   </rule>
 9 | 
10 |   <arg value="-colors"/>
11 | </ruleset>


--------------------------------------------------------------------------------
/screenshot.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jofrysutanto/windsor/0a130f2920283ea42033777600aec9d5a45b88e1/screenshot.png


--------------------------------------------------------------------------------
/src/AcfBlock.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor;
 3 | 
 4 | abstract class AcfBlock
 5 | {
 6 | 
 7 |     /**
 8 |      * @var array ACF block configuration array
 9 |      */
10 |     protected $block;
11 | 
12 |     public function __construct($block)
13 |     {
14 |         $this->block = $block;
15 |     }
16 | 
17 |     /**
18 |      * Runs whenever your block is displayed (front-end and back-end) and enqueues scripts and/or styles
19 |      *
20 |      * @return void
21 |      */
22 |     public function enqueueAssets()
23 |     {
24 |     }
25 | 
26 |     /**
27 |      * Renders resulting HTML for current block
28 |      *
29 |      * @return void
30 |      */
31 |     public function render()
32 |     {
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/AcfServiceProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor;
 3 | 
 4 | use EvolveEngine\Core\ServiceProvider;
 5 | use Windsor\Capsule\Manager;
 6 | 
 7 | class AcfServiceProvider extends ServiceProvider
 8 | {
 9 | 
10 |     /**
11 |      * Register the service provider.
12 |      *
13 |      * @return void
14 |      */
15 |     public function register()
16 |     {
17 |         $this->app->singleton('acf.capsule', function ($app) {
18 |             return new Manager($app['config']->get('acf-yaml', []));
19 |         });
20 | 
21 |         // Using our capsulated ACF
22 |         $this->app->action('acf/init', 'acf.capsule@register');
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactAccordion.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactAccordion
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfZero($array, [
17 |             'open',
18 |             'multi_expand',
19 |             'endpoint',
20 |         ]);
21 |         $array = $this->formatBoolean($array, [
22 |             'open',
23 |             'multi_expand',
24 |             'endpoint',
25 |         ]);
26 |         return $array;
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactButtonGroup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactButtonGroup
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfZero($array, [
17 |             'allow_null',
18 |         ]);
19 |         $array = $this->formatBoolean($array, [
20 |             'allow_null',
21 |         ]);
22 |         $array = $this->unsetIfVal($array, [
23 |             'layout' => 'horizontal',
24 |         ]);
25 |         return $array;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactCheckbox.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactCheckbox
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfZero($array, [
17 |             'allow_custom',
18 |             'toggle',
19 |             'save_custom',
20 |         ]);
21 |         $array = $this->formatBoolean($array, [
22 |             'allow_custom',
23 |             'toggle',
24 |             'save_custom',
25 |         ]);
26 |         $array = $this->unsetIfVal($array, [
27 |             'layout' => 'vertical',
28 |         ]);
29 |         return $array;
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactClone.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactClone
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfZero($array, [
17 |             'prefix_label',
18 |             'prefix_name',
19 |         ]);
20 |         $array = $this->formatBoolean($array, [
21 |             'prefix_label',
22 |             'prefix_name',
23 |         ]);
24 |         return $array;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactField.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | use Tightenco\Collect\Support\Arr;
 5 | 
 6 | class CompactField
 7 | {
 8 |     use CompactHelper;
 9 | 
10 |     /**
11 |      * Run this rule
12 |      *
13 |      * @param array $array
14 |      * @return array
15 |      */
16 |     public function run($array)
17 |     {
18 |         $array = $this->unsetIfEmpty($array, [
19 |             'instructions',
20 |             'default_value',
21 |             'placeholder',
22 |             'prepend',
23 |             'append',
24 |             'maxlength',
25 |         ]);
26 |         $array = $this->unsetIfZero($array, [
27 |             'required',
28 |             'conditional_logic',
29 |         ]);
30 |         $array = $this->unsetEmptyWrapper($array);
31 |         return $array;
32 |     }
33 | 
34 |     /**
35 |      * Unset empty wrapper key with empty values,
36 |      * or completely remove wrapper key if empty
37 |      *
38 |      * @param array $array
39 |      * @return array
40 |      */
41 |     protected function unsetEmptyWrapper($array)
42 |     {
43 |         if (!Arr::has($array, 'wrapper')) {
44 |             return $array;
45 |         }
46 |         $wrapper = Arr::get($array, 'wrapper');
47 |         if (!is_array($wrapper)) {
48 |             return $array;
49 |         }
50 |         $result = [];
51 |         foreach ($wrapper as $key => $value) {
52 |             if (!empty($value)) {
53 |                 $result[$key] = $value;
54 |             }
55 |         }
56 |         if (count($result) <= 0) {
57 |             unset($array['wrapper']);
58 |         } else {
59 |             $array['wrapper'] = $result;
60 |         }
61 |         return $array;
62 |     }
63 | }
64 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactFieldGroup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactFieldGroup
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'description',
18 |             'hide_on_screen',
19 |         ]);
20 |         $array = $this->unsetIfZero($array, [
21 |             'menu_order',
22 |         ]);
23 |         $array = $this->unsetIfVal($array, [
24 |             'label_placement' => 'top',
25 |             'instruction_placement' => 'label',
26 |         ]);
27 |         return $array;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactFile.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactFile
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'min_size',
18 |             'max_size',
19 |             'mime_types',
20 |         ]);
21 |         return $array;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactFlexibleContent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactFlexibleContent
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'min',
18 |             'max',
19 |         ]);
20 |         $array = $this->unsetIfZero($array, [
21 |             'min',
22 |             'max',
23 |         ]);
24 | 
25 |         return $array;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactGallery.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactGallery extends CompactImage
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = parent::run($array);
17 |         $array = $this->unsetIfEmpty($array, [
18 |             'min',
19 |             'max',
20 |         ]);
21 |         return $array;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactGoogleMap.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactGoogleMap
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'center_lat',
18 |             'center_lng',
19 |             'zoom',
20 |             'height',
21 |         ]);
22 |         return $array;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactHelper.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | namespace Windsor\Admin\Exporter\CompactRules;
  3 | 
  4 | use Tightenco\Collect\Support\Arr;
  5 | 
  6 | trait CompactHelper
  7 | {
  8 | 
  9 |     /**
 10 |      * Unset given keys when the values are empty
 11 |      *
 12 |      * @param array $array
 13 |      * @param array $keys
 14 |      * @return array
 15 |      */
 16 |     protected function unsetIfEmpty($array, $keys)
 17 |     {
 18 |         if (!is_array($keys)) {
 19 |             $keys = [$keys];
 20 |         }
 21 |         foreach ($keys as $key) {
 22 |             if (!Arr::has($array, $key)) {
 23 |                 continue;
 24 |             }
 25 |             $val = Arr::get($array, $key);
 26 |             if (!$val) {
 27 |                 unset($array[$key]);
 28 |             }
 29 |         }
 30 |         return $array;
 31 |     }
 32 | 
 33 |     /**
 34 |      * Unset given keys when values are zero
 35 |      *
 36 |      * @param array $array
 37 |      * @param array $keys
 38 |      * @return array
 39 |      */
 40 |     protected function unsetIfZero($array, $keys)
 41 |     {
 42 |         if (!is_array($keys)) {
 43 |             $keys = [$keys];
 44 |         }
 45 |         foreach ($keys as $key) {
 46 |             if (!Arr::has($array, $key)) {
 47 |                 continue;
 48 |             }
 49 |             $val = Arr::get($array, $key);
 50 |             if ($val === 0) {
 51 |                 unset($array[$key]);
 52 |             }
 53 |         }
 54 |         return $array;
 55 |     }
 56 | 
 57 |     /**
 58 |      * Unset given keys when values are one (indicating `true`)
 59 |      *
 60 |      * @param array $array
 61 |      * @param array $keys
 62 |      * @return array
 63 |      */
 64 |     protected function unsetIfOne($array, $keys)
 65 |     {
 66 |         if (!is_array($keys)) {
 67 |             $keys = [$keys];
 68 |         }
 69 |         foreach ($keys as $key) {
 70 |             if (!Arr::has($array, $key)) {
 71 |                 continue;
 72 |             }
 73 |             $val = Arr::get($array, $key);
 74 |             if ($val === 1) {
 75 |                 unset($array[$key]);
 76 |             }
 77 |         }
 78 |         return $array;
 79 |     }
 80 | 
 81 |     /**
 82 |      * Unset given keys when the value match given value
 83 |      * ```
 84 |      * unsetIfVal(['foo' => 'bar'], ['foo' => 'bar']) => returns [];
 85 |      * ```
 86 |      *
 87 |      * @param array $array
 88 |      * @param array $keyValues
 89 |      * @return array
 90 |      */
 91 |     protected function unsetIfVal($array, $keyValues)
 92 |     {
 93 |         foreach ($keyValues as $key => $value) {
 94 |             if (!Arr::has($array, $key)) {
 95 |                 continue;
 96 |             }
 97 |             $val = Arr::get($array, $key);
 98 |             if ($val === $value) {
 99 |                 unset($array[$key]);
100 |             }
101 |         }
102 |         return $array;
103 |     }
104 | 
105 |     /**
106 |      * Format given key values to either `true` if value is 1,
107 |      * of `false` if value is 0.
108 |      *
109 |      * @param array $array
110 |      * @param array $keys
111 |      * @return array
112 |      */
113 |     protected function formatBoolean($array, $keys)
114 |     {
115 |         foreach ($keys as $key) {
116 |             if (!Arr::has($array, $key)) {
117 |                 continue;
118 |             }
119 |             $val = Arr::get($array, $key);
120 |             if ($val === 1) {
121 |                 $array[$key] = true;
122 |             }
123 |             if ($val === 0) {
124 |                 $array[$key] = false;
125 |             }
126 |         }
127 |         return $array;
128 |     }
129 | }
130 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactImage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactImage extends CompactFile
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = parent::run($array);
17 |         $array = $this->unsetIfEmpty($array, [
18 |             'min_width',
19 |             'min_height',
20 |             'max_width',
21 |             'max_height',
22 |             'min_size',
23 |             'max_size',
24 |         ]);
25 |         return $array;
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactLayout.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactLayout
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'min',
18 |             'max',
19 |         ]);
20 |         $array = $this->unsetIfZero($array, [
21 |             'min',
22 |             'max',
23 |         ]);
24 |         return $array;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactMessage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactMessage
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfZero($array, [
17 |             'esc_html',
18 |         ]);
19 |         $array = $this->formatBoolean($array, [
20 |             'esc_html',
21 |         ]);
22 |         return $array;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactNumber.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactNumber
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'min',
18 |             'max',
19 |             'step',
20 |         ]);
21 |         return $array;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactOEmbed.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactOEmbed
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'width',
18 |             'height',
19 |         ]);
20 |         return $array;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactPageLink.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactPageLink
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'post_type',
18 |             'taxonomy',
19 |         ]);
20 |         $array = $this->unsetIfZero($array, [
21 |             'allow_null',
22 |             'multiple',
23 |         ]);
24 |         $array = $this->unsetIfOne($array, [
25 |             'allow_archives',
26 |         ]);
27 |         $array = $this->formatBoolean($array, [
28 |             'allow_null',
29 |             'allow_archives',
30 |             'multiple',
31 |         ]);
32 |         return $array;
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactPostObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactPostObject
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'post_type',
18 |             'taxonomy',
19 |         ]);
20 |         $array = $this->unsetIfZero($array, [
21 |             'allow_null',
22 |             'multiple',
23 |         ]);
24 |         $array = $this->formatBoolean($array, [
25 |             'allow_null',
26 |             'multiple',
27 |             'ui',
28 |         ]);
29 |         return $array;
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactRadio.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactRadio
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfZero($array, [
17 |             'allow_null',
18 |             'other_choice',
19 |             'save_other_choice',
20 |         ]);
21 |         $array = $this->formatBoolean($array, [
22 |             'allow_null',
23 |             'other_choice',
24 |             'save_other_choice',
25 |         ]);
26 |         $array = $this->unsetIfVal($array, [
27 |             'layout' => 'vertical',
28 |         ]);
29 |         return $array;
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactRange.php:
--------------------------------------------------------------------------------
1 | <?php
2 | namespace Windsor\Admin\Exporter\CompactRules;
3 | 
4 | class CompactRange extends CompactNumber
5 | {
6 | }
7 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactRelationship.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactRelationship
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'post_type',
18 |             'taxonomy',
19 |             'elements',
20 |             'min',
21 |             'max',
22 |         ]);
23 |         return $array;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactRepeater.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactRepeater
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'collapsed',
18 |             'button_label',
19 |             'min',
20 |             'max',
21 |         ]);
22 |         $array = $this->unsetIfZero($array, [
23 |             'min',
24 |             'max',
25 |         ]);
26 | 
27 |         return $array;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactRichEditor.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactRichEditor
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfZero($array, [
17 |             'delay',
18 |         ]);
19 |         $array = $this->formatBoolean($array, [
20 |             'media_upload',
21 |         ]);
22 |         return $array;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactSelect.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactSelect
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfZero($array, [
17 |             'allow_null',
18 |             'multiple',
19 |             'ui',
20 |             'ajax',
21 |         ]);
22 |         $array = $this->formatBoolean($array, [
23 |             'allow_null',
24 |             'multiple',
25 |             'ui',
26 |             'ajax',
27 |         ]);
28 |         return $array;
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactTab.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactTab
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfZero($array, [
17 |             'endpoint',
18 |         ]);
19 |         return $array;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactTaxonomy.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactTaxonomy
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfZero($array, [
17 |             'save_terms',
18 |             'load_terms',
19 |             'multiple',
20 |             'allow_null',
21 |         ]);
22 |         $array = $this->unsetIfOne($array, [
23 |             'add_term',
24 |         ]);
25 |         $array = $this->formatBoolean($array, [
26 |             'save_terms',
27 |             'load_terms',
28 |             'multiple',
29 |             'allow_null',
30 |             'add_term',
31 |         ]);
32 |         return $array;
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactTextArea.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactTextArea
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'rows',
18 |             'new_lines',
19 |         ]);
20 |         return $array;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactTrueFalse.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactTrueFalse
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'ui_on_text',
18 |             'ui_off_text',
19 |             'message',
20 |         ]);
21 |         $array = $this->unsetIfZero($array, [
22 |             'ui',
23 |         ]);
24 |         return $array;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/CompactRules/CompactUser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter\CompactRules;
 3 | 
 4 | class CompactUser
 5 | {
 6 |     use CompactHelper;
 7 | 
 8 |     /**
 9 |      * Run this rule
10 |      *
11 |      * @param array $array
12 |      * @return array
13 |      */
14 |     public function run($array)
15 |     {
16 |         $array = $this->unsetIfEmpty($array, [
17 |             'role',
18 |         ]);
19 |         $array = $this->unsetIfZero($array, [
20 |             'multiple',
21 |             'allow_null',
22 |         ]);
23 |         return $array;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/FieldGroupsStore.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter;
 3 | 
 4 | use Tightenco\Collect\Support\Arr;
 5 | 
 6 | class FieldGroupsStore
 7 | {
 8 | 
 9 |     /**
10 |      * Query available field groups for exporting
11 |      *
12 |      * @return array
13 |      */
14 |     public function query()
15 |     {
16 |         $groups = acf_get_field_groups();
17 |         return array_values(array_filter($groups, function ($group) {
18 |             return !in_array(Arr::get($group, 'local'), ['php']);
19 |         }));
20 |     }
21 | 
22 |     /**
23 |      * Query field groups NOT available for exporting
24 |      *
25 |      * @return array
26 |      */
27 |     public function queryNotExportable()
28 |     {
29 |         $groups = acf_get_field_groups();
30 |         return array_values(array_filter($groups, function ($group) {
31 |             return in_array(Arr::get($group, 'local'), ['php']);
32 |         }));
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/FieldsPacker.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | namespace Windsor\Admin\Exporter;
  3 | 
  4 | use Tightenco\Collect\Support\Arr;
  5 | 
  6 | class FieldsPacker
  7 | {
  8 | 
  9 |     /**
 10 |      * @var array Raw field group data
 11 |      */
 12 |     protected $raw;
 13 | 
 14 |     /**
 15 |      * @var string Packing mode.
 16 |      * - 'full' for default packing (leave fields as is)
 17 |      * - 'compact' to remove empty or fields with default values
 18 |      */
 19 |     protected $mode = 'full';
 20 | 
 21 |     /**
 22 |      * List of instantiable classes to simplify fields configuration
 23 |      *
 24 |      * @var array
 25 |      */
 26 |     protected $compactRulesByType = [
 27 |         // Basic
 28 |         'number'           => CompactRules\CompactNumber::class,
 29 |         'range'            => CompactRules\CompactRange::class,
 30 |         'textarea'         => CompactRules\CompactTextArea::class,
 31 |         // Content
 32 |         'image'            => CompactRules\CompactImage::class,
 33 |         'file'             => CompactRules\CompactFile::class,
 34 |         'wysiwyg'          => CompactRules\CompactRichEditor::class,
 35 |         'oembed'           => CompactRules\CompactOEmbed::class,
 36 |         'true_false'       => CompactRules\CompactTrueFalse::class,
 37 |         'gallery'          => CompactRules\CompactGallery::class,
 38 |         // Choice
 39 |         'select'           => CompactRules\CompactSelect::class,
 40 |         'checkbox'         => CompactRules\CompactCheckbox::class,
 41 |         'radio'            => CompactRules\CompactRadio::class,
 42 |         'button_group'     => CompactRules\CompactButtonGroup::class,
 43 |         // Relational
 44 |         'post_object'      => CompactRules\CompactPostObject::class,
 45 |         'page_link'        => CompactRules\CompactPageLink::class,
 46 |         'relationship'     => CompactRules\CompactRelationship::class,
 47 |         'taxonomy'         => CompactRules\CompactTaxonomy::class,
 48 |         'user'             => CompactRules\CompactUser::class,
 49 |         // jQuery
 50 |         'google_map'       => CompactRules\CompactGoogleMap::class,
 51 |         // Layout
 52 |         'tab'              => CompactRules\CompactTab::class,
 53 |         'accordion'        => CompactRules\CompactAccordion::class,
 54 |         'message'          => CompactRules\CompactMessage::class,
 55 |         'clone'            => CompactRules\CompactClone::class,
 56 |         'repeater'         => CompactRules\CompactRepeater::class,
 57 |         'flexible_content' => CompactRules\CompactFlexibleContent::class,
 58 |     ];
 59 | 
 60 |     public function __construct($raw = [])
 61 |     {
 62 |         $this->raw = $raw;
 63 |     }
 64 | 
 65 |     /**
 66 |      * Set packing mode
 67 |      *
 68 |      * @param string $mode 'full' or 'compact'
 69 |      * @return self
 70 |      */
 71 |     public function setMode($mode)
 72 |     {
 73 |         $this->mode = $mode;
 74 |         return $this;
 75 |     }
 76 | 
 77 |     /**
 78 |      * Check if we are using compact mode
 79 |      *
 80 |      * @return boolean
 81 |      */
 82 |     public function isCompact()
 83 |     {
 84 |         return $this->mode === 'compact';
 85 |     }
 86 | 
 87 |     /**
 88 |      * Start packing process
 89 |      *
 90 |      * @return array
 91 |      */
 92 |     public function pack()
 93 |     {
 94 |         return (new MutableField($this->raw))
 95 |             ->shiftToLast('fields')
 96 |             ->when($this->isCompact(), function (MutableField $mutable) {
 97 |                 $mutable->compactify([
 98 |                     CompactRules\CompactFieldGroup::class,
 99 |                 ]);
100 |             })
101 |             ->modify('fields', function ($fields) {
102 |                 return $this->packFields($fields);
103 |             })
104 |             ->toArray();
105 |     }
106 | 
107 |     /**
108 |      * Pack given fields definition
109 |      *
110 |      * @param array $array
111 |      * @return array
112 |      */
113 |     protected function packFields($array)
114 |     {
115 |         return (new MutableFieldCollection($array))
116 |             ->associateBy('name', function ($item) {
117 |                 return str_replace('-', '_', sanitize_title_with_dashes($item['type'] . '-' . $item['label']));
118 |             })
119 |             ->transformAsMutable(function (MutableField $item) {
120 |                 return $item
121 |                     ->modify(function ($fieldArray) {
122 |                         return $this->expandConditionalLogic($fieldArray);
123 |                     })
124 |                     ->modifyAsMutable(function (MutableField $fieldConfig) {
125 |                         switch ($fieldConfig->get('type')) {
126 |                             case 'repeater':
127 |                             case 'group':
128 |                                 $fieldConfig
129 |                                     ->modify('sub_fields', function ($subFields) {
130 |                                         return $this->packFields($subFields);
131 |                                     });
132 |                                 break;
133 |                             case 'flexible_content':
134 |                                 $fieldConfig->shiftToLast('layouts');
135 |                                 $fieldConfig['layouts'] = (new MutableFieldCollection($fieldConfig['layouts']))
136 |                                     ->associateBy('name')
137 |                                     ->transformAsMutable(function (MutableField $layoutConfig) {
138 |                                         return $layoutConfig
139 |                                             ->shiftToLast('sub_fields')
140 |                                             ->modify('sub_fields', function ($layoutSubFields) {
141 |                                                 return $this->packFields($layoutSubFields);
142 |                                             })
143 |                                             ->when($this->isCompact(), function (MutableField $mutable) {
144 |                                                 $mutable->compactify([
145 |                                                     CompactRules\CompactLayout::class
146 |                                                 ]);
147 |                                             })
148 |                                             ->toArray();
149 |                                     })
150 |                                     ->toArray();
151 |                                 break;
152 |                             default:
153 |                                 break;
154 |                         }
155 |                         $fieldConfig->when($this->isCompact(), function (MutableField $mutable) {
156 |                             $mutable->compactify($this->getFieldCompactRules($mutable->toArray()));
157 |                         });
158 |                         return $fieldConfig;
159 |                     })
160 |                     ->toArray();
161 |             })
162 |             ->toArray();
163 |     }
164 | 
165 |     /**
166 |      * Retrieve available compacting rules based on given field array
167 |      *
168 |      * @param array $array
169 |      * @return array
170 |      */
171 |     protected function getFieldCompactRules($array)
172 |     {
173 |         $rules = [
174 |             CompactRules\CompactField::class,
175 |         ];
176 |         $typeRules = Arr::get($this->compactRulesByType, Arr::get($array, 'type'), []);
177 |         if (!is_array($typeRules)) {
178 |             $typeRules = [$typeRules];
179 |         }
180 |         if (count($typeRules) > 0) {
181 |             $rules = array_merge($rules, $typeRules);
182 |         }
183 |         return $rules;
184 |     }
185 | 
186 |     /**
187 |      * Prefix all conditional logic field to use expanded keys
188 |      *
189 |      * @param array $array
190 |      * @return array
191 |      */
192 |     protected function expandConditionalLogic($array)
193 |     {
194 |         if (!Arr::has($array, 'conditional_logic')) {
195 |             return $array;
196 |         }
197 |         $conditions = Arr::get($array, 'conditional_logic');
198 |         if (!is_array($conditions)) {
199 |             return $array;
200 |         }
201 |         if (count($conditions) <= 0) {
202 |             return $array;
203 |         }
204 |         foreach ($conditions as $and => $andContent) {
205 |             foreach ($andContent as $or => $value) {
206 |                 Arr::set(
207 |                     $array,
208 |                     sprintf('conditional_logic.%s.%s.field', $and, $or),
209 |                     '~' . Arr::get($value, 'field')
210 |                 );
211 |             }
212 |         }
213 |         return $array;
214 |     }
215 | }
216 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/MutableField.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter;
 3 | 
 4 | use Windsor\Support\Fluent;
 5 | 
 6 | class MutableField extends Fluent
 7 | {
 8 | 
 9 |     /**
10 |      * Shift given key to last, only works for associative array
11 |      *
12 |      * @param string $key
13 |      * @return self
14 |      */
15 |     public function shiftToLast($key)
16 |     {
17 |         $pos = array_search($key, array_keys($this->attributes));
18 |         if ($pos === false) {
19 |             return $this;
20 |         }
21 |         $item = array_splice($this->attributes, $pos, 1);
22 |         $this->attributes = array_merge($this->attributes, $item);
23 |         return $this;
24 |     }
25 | 
26 |     public function when($condition, $callback)
27 |     {
28 |         if ($condition !== true) {
29 |             return $this;
30 |         }
31 |         call_user_func_array($callback, [$this]);
32 |         return $this;
33 |     }
34 | 
35 |     public function modifyAsMutable($key, $callback = null)
36 |     {
37 |         if (is_callable($key)) {
38 |             $mutable = new static($this->attributes);
39 |             $this->attributes = call_user_func_array($key, [$mutable])->toArray();
40 |             return $this;
41 |         }
42 |         $value = $this->get($key);
43 |         if (!$value) {
44 |             return $this;
45 |         }
46 |         $this->attributes[$key] = call_user_func_array($callback, [new static($value)])->toArray();
47 |         return $this;
48 |     }
49 | 
50 |     public function modify($key, $callback = null)
51 |     {
52 |         if (is_callable($key)) {
53 |             $this->attributes = call_user_func_array($key, [$this->attributes]);
54 |             return $this;
55 |         }
56 |         $value = $this->get($key);
57 |         if (!$value) {
58 |             return $this;
59 |         }
60 |         $this->attributes[$key] = call_user_func_array($callback, [$value]);
61 |         return $this;
62 |     }
63 | 
64 |     /**
65 |      * Run compact rules on given array
66 |      *
67 |      * @param array $rules Instantiable rule class
68 |      * @return self
69 |      */
70 |     public function compactify($rules)
71 |     {
72 |         foreach ($rules as $rule) {
73 |             $this->attributes = (new $rule)->run($this->attributes);
74 |         }
75 |         return $this;
76 |     }
77 | 
78 |     /**
79 |      * Dump current attributes, for debugging purpose
80 |      *
81 |      * @return self
82 |      */
83 |     public function dump()
84 |     {
85 |         dump($this->attributes);
86 |         return $this;
87 |     }
88 | }
89 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/MutableFieldCollection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter;
 3 | 
 4 | use Tightenco\Collect\Support\Collection;
 5 | 
 6 | class MutableFieldCollection extends Collection
 7 | {
 8 | 
 9 |     /**
10 |      * Ensure conversion of attributes to associate array.
11 |      * Optionally receive callback as fallback when given identifier is empty
12 |      *
13 |      * @param string $key
14 |      * @param \Closure $whenMissing
15 |      * @return self
16 |      */
17 |     public function associateBy($key, \Closure $whenMissing = null)
18 |     {
19 |         return $this
20 |             ->keyBy(function ($item) use ($key, $whenMissing) {
21 |                 if (isset($item[$key]) && !empty($item[$key])) {
22 |                     return $item[$key];
23 |                 }
24 |                 if ($whenMissing) {
25 |                     return $whenMissing($item);
26 |                 }
27 |                 return uniqid($key . '_');
28 |             })
29 |             ->map(function ($item) use ($key) {
30 |                 unset($item[$key]);
31 |                 return $item;
32 |             });
33 |     }
34 | 
35 |     /**
36 |      * Transform items in collection into mutable
37 |      *
38 |      * @param \Closure $callback
39 |      * @return self
40 |      */
41 |     public function transformAsMutable($callback)
42 |     {
43 |         $this->transform(function ($item) use ($callback) {
44 |             return call_user_func_array($callback, [new MutableField($item)]);
45 |         });
46 |         return $this;
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Admin/Exporter/YamlComposer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Admin\Exporter;
 3 | 
 4 | use Symfony\Component\Yaml\Yaml;
 5 | 
 6 | class YamlComposer
 7 | {
 8 | 
 9 |     /**
10 |      * @var integer Indentation in spaces
11 |      */
12 |     protected $indent;
13 | 
14 |     public function __construct($indent = 2)
15 |     {
16 |         $this->indent = $indent;
17 |     }
18 | 
19 |     /**
20 |      * Generate YAML string
21 |      *
22 |      * @return string
23 |      */
24 |     public function generate($array)
25 |     {
26 |         $result = Yaml::dump(
27 |             $array,
28 |             50,
29 |             $this->indent,
30 |             Yaml::DUMP_EMPTY_ARRAY_AS_SEQUENCE
31 |         );
32 |         return $result;
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Admin/WordPress/AjaxHandler.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | namespace Windsor\Admin\WordPress;
  3 | 
  4 | use Windsor\Support\Singleton;
  5 | use Tightenco\Collect\Support\Arr;
  6 | use Windsor\Admin\Exporter\FieldsPacker;
  7 | use Windsor\Admin\Exporter\YamlComposer;
  8 | use Tightenco\Collect\Support\Collection;
  9 | use Windsor\Admin\Exporter\FieldGroupsStore;
 10 | 
 11 | class AjaxHandler
 12 | {
 13 |     use Singleton;
 14 | 
 15 |     /**
 16 |      * Data store for field groups
 17 |      *
 18 |      * @var \Windsor\Admin\FieldGroupsStore
 19 |      */
 20 |     protected $store;
 21 | 
 22 |     public function init()
 23 |     {
 24 |         $this->store = new FieldGroupsStore;
 25 |     }
 26 | 
 27 |     /**
 28 |      * Register WordPress AJAX handlers
 29 |      *
 30 |      * @return void
 31 |      */
 32 |     public function registerHandlers()
 33 |     {
 34 |         add_action('wp_ajax_nopriv_windsor_load_fields', [$this, 'ajaxLoadFields']);
 35 |         add_action('wp_ajax_windsor_load_fields', [$this, 'ajaxLoadFields']);
 36 | 
 37 |         add_action('wp_ajax_nopriv_windsor_load_single', [$this, 'ajaxLoadSingle']);
 38 |         add_action('wp_ajax_windsor_load_single', [$this, 'ajaxLoadSingle']);
 39 | 
 40 |         add_action('wp_ajax_nopriv_windsor_export', [$this, 'ajaxExport']);
 41 |         add_action('wp_ajax_windsor_export', [$this, 'ajaxExport']);
 42 |     }
 43 | 
 44 |     /**
 45 |      * Handle AJAX request to load field groups
 46 |      *
 47 |      * @return mixed
 48 |      */
 49 |     public function ajaxLoadFields()
 50 |     {
 51 |         $results = $this->store->query();
 52 |         $collection = new Collection;
 53 |         foreach ($results as $result) {
 54 |             $collection->push(array_merge($result, [
 55 |                 'count' => acf_get_field_count($result)
 56 |             ]));
 57 |         }
 58 |         return wp_send_json([
 59 |             'field_groups' => $collection->toArray(),
 60 |             'field_groups_unavailable' => $this->store->queryNotExportable(),
 61 |         ]);
 62 |     }
 63 | 
 64 |     /**
 65 |      * Handle AJAX request to load individual field group
 66 |      *
 67 |      * @return mixed
 68 |      */
 69 |     public function ajaxLoadSingle()
 70 |     {
 71 |         $key = isset($_POST['key']) ? $_POST['key'] : null;
 72 |         $mode = isset($_POST['mode']) ? $_POST['mode'] : 'full';
 73 |         $indent = isset($_POST['indent']) ? $_POST['indent'] : 2;
 74 |         if (!$key) {
 75 |             return wp_send_json_error();
 76 |         }
 77 |         $yaml = new YamlComposer($indent);
 78 |         $packer = new FieldsPacker($this->loadFieldGroupForExport($key));
 79 |         $result = $packer
 80 |             ->setMode($mode)
 81 |             ->pack();
 82 |         return wp_send_json([
 83 |             'yaml' => $yaml->generate($result),
 84 |         ]);
 85 |     }
 86 | 
 87 |     /**
 88 |      * Handle AJAX request to export available field groups
 89 |      *
 90 |      * @return mixed
 91 |      */
 92 |     public function ajaxExport()
 93 |     {
 94 |         $mode = isset($_POST['mode']) ? $_POST['mode'] : 'full';
 95 |         $indent = isset($_POST['indent']) ? $_POST['indent'] : 2;
 96 |         $hasIndex = isset($_POST['include_index']) ? $_POST['include_index'] === 'true' : true;
 97 |         $shouldRename = isset($_POST['rename_files']) ? $_POST['rename_files'] === 'true' : true;
 98 |         $groups = $this->store->query();
 99 |         $result = [];
100 |         $filenames = [];
101 |         foreach ($groups as $group) {
102 |             $packer = new FieldsPacker(
103 |                 $this->loadFieldGroupForExport(Arr::get($group, 'key'))
104 |             );
105 |             $fieldSettings = $packer
106 |                 ->setMode($mode)
107 |                 ->pack();
108 |             $yaml = (new YamlComposer($indent))
109 |                 ->generate($fieldSettings);
110 |             $filename = sprintf(
111 |                 "%s.acf.yaml",
112 |                 ($shouldRename ? sanitize_title_with_dashes($group['title']) : $group['key'])
113 |             );
114 |             $filenames[] = $filename;
115 |             $result[] = [
116 |                 'filename' => $filename,
117 |                 'content' => $yaml
118 |             ];
119 |         }
120 |         if ($hasIndex) {
121 |             $indexContent = [
122 |                 'fields'     => [],
123 |                 'blueprints' => [],
124 |                 'blocks'     => [],
125 |                 'pages'      => $filenames,
126 |             ];
127 |             $result[] = [
128 |                 'filename' => 'index.yaml',
129 |                 'content' => (new YamlComposer($indent))->generate($indexContent)
130 |             ];
131 |         }
132 |         return wp_send_json([
133 |             'fields' => $result
134 |         ]);
135 |     }
136 | 
137 |     /**
138 |      * Load field group export configuration
139 |      *
140 |      * @param string $key
141 |      * @return array
142 |      */
143 |     public function loadFieldGroupForExport($key)
144 |     {
145 |         // Only work with raw, unmodified field structure
146 |         $filters = acf_disable_filters();
147 | 
148 |         $field_group = acf_get_field_group($key);
149 |         $field_group['fields'] = acf_get_fields($field_group);
150 |         $result = acf_prepare_field_group_for_export($field_group);
151 | 
152 |         acf_enable_filters($filters);
153 |         return $result;
154 |     }
155 | }
156 | 


--------------------------------------------------------------------------------
/src/Admin/WordPress/UiLoader.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | namespace Windsor\Admin\WordPress;
  3 | 
  4 | use Tightenco\Collect\Support\Arr;
  5 | use Windsor\Admin\WordPress\AjaxHandler;
  6 | 
  7 | class UiLoader
  8 | {
  9 |     /**
 10 |      * Current asset version
 11 |      *
 12 |      * @var string
 13 |      */
 14 |     protected $version = '1.0.0';
 15 | 
 16 |     /**
 17 |      * Admin page suffix hook coming from menu registration
 18 |      *
 19 |      * @var string
 20 |      */
 21 |     protected $adminHook;
 22 | 
 23 |     /**
 24 |      * Determine if Windsor assets are enqueued as inline
 25 |      *
 26 |      * @var boolean
 27 |      */
 28 |     protected $shouldInlineAssets = false;
 29 | 
 30 |     public function __construct($config = [])
 31 |     {
 32 |         $this->shouldInlineAssets = Arr::get($config, 'inline_assets') === true;
 33 |     }
 34 | 
 35 |     /**
 36 |      * All hooks and filters are registered through this method
 37 |      *
 38 |      * @return void
 39 |      */
 40 |     public function boot()
 41 |     {
 42 |         add_action('admin_menu', [$this, 'registerMenu']);
 43 |         AjaxHandler::instance()->registerHandlers();
 44 |     }
 45 | 
 46 |     /**
 47 |      * Register administration menu
 48 |      *
 49 |      * @return void
 50 |      */
 51 |     public function registerMenu()
 52 |     {
 53 |         $this->adminHook = add_submenu_page(
 54 |             'edit.php?post_type=acf-field-group',
 55 |             'Windsor - Export Tool',
 56 |             'Export to YAML',
 57 |             'manage_options',
 58 |             'windsor',
 59 |             array($this, 'renderAdminPage'),
 60 |             70
 61 |         );
 62 |         add_action('load-' . $this->adminHook, [$this, 'loadAssets']);
 63 |     }
 64 | 
 65 |     /**
 66 |      * Opportunity to add asset-related hooks, specific to Windsor
 67 |      *
 68 |      * @return void
 69 |      */
 70 |     public function loadAssets()
 71 |     {
 72 |         add_action('admin_enqueue_scripts', [$this, 'enqueueAdminAssets']);
 73 |         add_filter('script_loader_tag', [$this, 'addAssetAttribute'], 10, 3);
 74 |     }
 75 | 
 76 |     /**
 77 |      * Render HTML view of admin page
 78 |      *
 79 |      * @return void
 80 |      */
 81 |     public function renderAdminPage()
 82 |     {
 83 |         if (!current_user_can('manage_options')) {
 84 |             wp_die(__('You do not have sufficient permissions to access this page.'));
 85 |         }
 86 | 
 87 |         // Our Vite app register itself to this element
 88 |         // and let it take care of the rest
 89 |         echo '<div id="windsor"></div>';
 90 |     }
 91 | 
 92 |     /**
 93 |      * Enqueue additional assets
 94 |      *
 95 |      * @return void
 96 |      */
 97 |     public function enqueueAdminAssets()
 98 |     {
 99 |         wp_enqueue_style('windsor-prism-css', 'https://unpkg.com/prismjs@v1.x/themes/prism-tomorrow.css', []);
100 | 
101 |         if ($this->shouldInlineAssets) {
102 |             wp_add_inline_style(
103 |                 'windsor-prism-css',
104 |                 file_get_contents(__DIR__ . '/../../../frontend/assets/style.css')
105 |             );
106 |         } else {
107 |             wp_enqueue_style(
108 |                 'windsor-css',
109 |                 get_stylesheet_directory_uri() . '/vendor/jofrysutanto/windsor/frontend/assets/style.css',
110 |                 [],
111 |                 $this->version,
112 |                 'all'
113 |             );
114 |         }
115 |         // Prevent layout shift, intentionally hiding meta links on current page.
116 |         wp_add_inline_style('windsor-prism-css', '#screen-meta-links { display: none }');
117 | 
118 |         $jsDependencies = [
119 |             'windsor-prismjs-core'       => 'https://unpkg.com/prismjs@v1.x/components/prism-core.min.js',
120 |             'windsor-prismjs-yaml'       => 'https://unpkg.com/prismjs@v1.x/components/prism-yaml.min.js',
121 |             'windsor-jszip'              => 'https://cdnjs.cloudflare.com/ajax/libs/jszip/3.5.0/jszip.min.js',
122 |         ];
123 |         foreach ($jsDependencies as $key => $cdn) {
124 |             wp_enqueue_script($key, $cdn, [], null, true);
125 |         }
126 |         $lastHandle = array_keys($jsDependencies)[count($jsDependencies) - 1];
127 |         if ($this->shouldInlineAssets) {
128 |             wp_add_inline_script($lastHandle, file_get_contents(__DIR__ . '/../../../frontend/assets/index.js'));
129 |         } else {
130 |             wp_enqueue_script(
131 |                 'windsor-js',
132 |                 get_stylesheet_directory_uri() . '/vendor/jofrysutanto/windsor/frontend/assets/index.js',
133 |                 array_keys($jsDependencies),
134 |                 $this->version,
135 |                 true
136 |             );
137 |         }
138 |         wp_localize_script($lastHandle, '_acf_windsor', [
139 |             'acf' => [
140 |                 'version' => ACF_VERSION,
141 |             ],
142 |         ]);
143 |     }
144 | 
145 |     /**
146 |      * Extend default asset enqueueing HTML attributes
147 |      *
148 |      * @param string $tag
149 |      * @param string $handle
150 |      * @param string $src
151 |      * @return string
152 |      */
153 |     public function addAssetAttribute($tag, $handle, $src)
154 |     {
155 |         if ('windsor-js' !== $handle) {
156 |             return $tag;
157 |         }
158 |         // Update script tag with 'module' type for Vite compatibility
159 |         $tag = '<script type="module" src="' . esc_url($src) . '"></script>';
160 |         return $tag;
161 |     }
162 | }
163 | 


--------------------------------------------------------------------------------
/src/Capsule/AbstractCapsule.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Capsule;
 3 | 
 4 | abstract class AbstractCapsule
 5 | {
 6 | 
 7 |     /**
 8 |      * @var array Current active namespace
 9 |      */
10 |     public static $namespace = [];
11 | 
12 |     /**
13 |      * @var array Valid ACF field according to ACF's standard
14 |      */
15 |     protected $parsed;
16 | 
17 |     /**
18 |      * Debug mode flag
19 |      *
20 |      * @var boolean
21 |      */
22 |     protected $debug = false;
23 | 
24 |     /**
25 |      * Create and parse group with given content
26 |      *
27 |      * @param array $content
28 |      * @return self
29 |      */
30 |     abstract public function make($content);
31 | 
32 |     /**
33 |      * Retrieve parsed and valid ACF array
34 |      *
35 |      * @return array
36 |      */
37 |     public function parsed()
38 |     {
39 |         return $this->parsed;
40 |     }
41 | 
42 |     /**
43 |      * Group and scope all fields to given namespace.
44 |      * The namespace is used to prefix all fields to ensure their uniqueness.
45 |      *
46 |      * @param string $namespace
47 |      * @param Closure $callback
48 |      * @return self
49 |      */
50 |     public function namespace($namespace, $callback)
51 |     {
52 |         static::$namespace[] = $namespace;
53 |         $callback($this);
54 |         array_pop(static::$namespace);
55 |         return $this;
56 |     }
57 | 
58 |     /**
59 |      * Generate unique key based on current active namespace
60 |      *
61 |      * @param string $key
62 |      * @return string
63 |      */
64 |     public function makeKey($key)
65 |     {
66 |         if (count(static::$namespace) <= 0) {
67 |             return $key;
68 |         }
69 |         if (starts_with($key, '~')) {
70 |             return ltrim($key, '~');
71 |         }
72 |         $namespace = array_values(array_slice(static::$namespace, -1))[0];
73 |         return $namespace . '_' . $key;
74 |     }
75 | 
76 |     /**
77 |      * Set debug mode
78 |      *
79 |      * @param boolean $isDebugging
80 |      * @return self
81 |      */
82 |     public function setDebug($isDebugging = true)
83 |     {
84 |         $this->debug = $isDebugging;
85 |         return $this;
86 |     }
87 | 
88 |     /**
89 |      * Check debug mode
90 |      *
91 |      * @return boolean
92 |      */
93 |     public function isDebugging()
94 |     {
95 |         return $this->debug;
96 |     }
97 | }
98 | 


--------------------------------------------------------------------------------
/src/Capsule/Block.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Capsule;
 3 | 
 4 | use Tightenco\Collect\Support\Arr;
 5 | use Windsor\Capsule\BlueprintsFactory;
 6 | 
 7 | class Block extends AbstractCapsule
 8 | {
 9 | 
10 |     /**
11 |      * Templates repository
12 |      *
13 |      * @var \Windsor\Capsule\BlueprintsFactory
14 |      */
15 |     protected $templates;
16 | 
17 |     public function __construct()
18 |     {
19 |         $this->templates = BlueprintsFactory::instance();
20 |     }
21 | 
22 |     /**
23 |      * @inheritDoc
24 |      */
25 |     public function make($content)
26 |     {
27 |         $this->parsed = tap($content, function (&$block) {
28 |             $block['name'] = $block['key'];
29 |             unset($block['key']);
30 |             unset($block['fields']);
31 |             if ($handler = Arr::get($block, 'handler')) {
32 |                 $block = $this->attachHandler($handler, $block);
33 |             }
34 |         });
35 |         return $this;
36 |     }
37 | 
38 |     /**
39 |      * Creates callable block handler
40 |      *
41 |      * @param string $handler classname
42 |      * @param array $block
43 |      *
44 |      * @return \Windsor\AcfBlock
45 |      */
46 |     protected function attachHandler($handler, $block)
47 |     {
48 |         if (!class_exists($handler)) {
49 |             return null;
50 |         }
51 |         $instance = new $handler($block);
52 |         if (!$instance instanceof \Windsor\AcfBlock) {
53 |             throw new \Exception("Invalid $handler — block handler should extend from Windsor\\AcfBlock");
54 |         }
55 |         $block['render_callback'] = [$instance, 'render'];
56 |         $block['enqueue_assets'] = [$instance, 'enqueueAssets'];
57 |         return $block;
58 |     }
59 | }
60 | 


--------------------------------------------------------------------------------
/src/Capsule/BlueprintBuilder.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | namespace Windsor\Capsule;
  3 | 
  4 | use Windsor\Support\Fluent;
  5 | use Tightenco\Collect\Support\Arr;
  6 | use Windsor\Rules\Utilities\TransformConditionalLogic;
  7 | 
  8 | class BlueprintBuilder
  9 | {
 10 | 
 11 |     /**
 12 |      * Template fields configuration,
 13 |      * containing fields which can be copied
 14 |      *
 15 |      * @var Fluent
 16 |      */
 17 |     protected $config;
 18 | 
 19 |     /**
 20 |      * Key of the fields to be copied to
 21 |      *
 22 |      * @var string
 23 |      */
 24 |     protected $key;
 25 | 
 26 |     /**
 27 |      * Parameters of the fields to be copied to
 28 |      *
 29 |      * @var array
 30 |      */
 31 |     protected $fields;
 32 | 
 33 |     public function __construct(array $config, $key, $fields)
 34 |     {
 35 |         $this->config = new Fluent($config);
 36 |         $this->key = $key;
 37 |         $this->fields = $fields;
 38 |     }
 39 | 
 40 |     /**
 41 |      * Creates a copy of the template based on
 42 |      * stored configurations
 43 |      *
 44 |      * @return array
 45 |      */
 46 |     public function makeCopy(): array
 47 |     {
 48 |         $keys = $this->collectKeys();
 49 |         $result = [];
 50 |         foreach ($keys as $key) {
 51 |             $field = Arr::get($this->config->fields, $key);
 52 |             if (!$field) {
 53 |                 continue;
 54 |             }
 55 |             $result[$key] = $field;
 56 |         }
 57 | 
 58 |         // Prefix labels if necessary
 59 |         $prefixLabel = Arr::get($this->fields, 'prefix_label', false);
 60 |         if ($prefixLabel) {
 61 |             $result = array_map(function ($field) {
 62 |                 $label = Arr::get($field, 'label');
 63 |                 if (!$label) {
 64 |                     return $field;
 65 |                 }
 66 |                 $prefix = Arr::get($this->fields, 'label');
 67 |                 $field['label'] = $prefix . ' ' . $label;
 68 |                 return $field;
 69 |             }, $result);
 70 |         }
 71 | 
 72 |         // Merge fields
 73 |         // Additional fields can be added, or existing fields can be overwritten
 74 |         // by YAML config using the `merge` key
 75 |         $mergeFields = Arr::get($this->fields, 'merge', []);
 76 |         if (count($mergeFields) > 0) {
 77 |             $result = array_replace_recursive($result, $mergeFields);
 78 |         }
 79 | 
 80 |         // Layout
 81 |         $layout = Arr::get($this->fields, 'layout', []);
 82 |         if (count($layout) > 0) {
 83 |             $result = $this->reLayout($result, $layout);
 84 |         }
 85 | 
 86 |         // Finally return result while optionally prefixing keys
 87 |         return $this->prefixAllKeys($result);
 88 |     }
 89 | 
 90 |     /**
 91 |      * Filter keys to be included in template
 92 |      *
 93 |      * @param array $template
 94 |      * @param array $fields
 95 |      * @return array
 96 |      */
 97 |     protected function collectKeys()
 98 |     {
 99 |         if ($keys = Arr::get($this->fields, 'only')) {
100 |             return $keys;
101 |         }
102 |         $fieldKeys = array_keys(Arr::get($this->config, 'fields'));
103 |         if ($excludes = Arr::get($this->fields, 'excludes')) {
104 |             return array_diff($fieldKeys, $excludes);
105 |         }
106 |         return $fieldKeys;
107 |     }
108 | 
109 |     /**
110 |      * Re-organise the layout of the copied fields
111 |      * Fields can be re-ordered, and also resized by using the following convention
112 |      * ```
113 |      * layout:
114 |      * - field1@50 : where `field1` is the name of the key, and `50` is the width %
115 |      * - field2@50
116 |      * ```
117 |      * The items above are ordered according to the index.
118 |      * Any missing fields will be appended last.
119 |      *
120 |      * @param array $fields
121 |      * @param array $layout
122 |      * @return array
123 |      */
124 |     protected function reLayout($fields, $layout)
125 |     {
126 |         $result = [];
127 |         foreach ($layout as $layoutConfig) {
128 |             $fragments = explode('@', $layoutConfig);
129 |             if (count($fragments) <= 0) {
130 |                 continue;
131 |             }
132 |             $key = $fragments[0];
133 |             if (!isset($fields[$key])) {
134 |                 continue;
135 |             }
136 |             $width = null;
137 |             if (count($fragments) > 1) {
138 |                 $width = $fragments[1];
139 |             }
140 |             $result[$key] = Arr::pull($fields, $key);
141 |             if ($width) {
142 |                 $result[$key]['wrapper_width'] = $width;
143 |             }
144 |         }
145 |         // If there are left overs, we simply append them to the end of resulting array
146 |         if (count($fields) > 0) {
147 |             $result = $result + $fields;
148 |         }
149 |         return $result;
150 |     }
151 | 
152 |     /**
153 |      * Prefix all keys in the array
154 |      *
155 |      * @param array $beforeArray
156 |      * @return array
157 |      */
158 |     protected function prefixAllKeys($beforeArray = [])
159 |     {
160 |         $result = [];
161 |         $prefix = $this->getPrefix();
162 |         if ($prefix === '') {
163 |             return $beforeArray;
164 |         }
165 |         foreach ($beforeArray as $key => $value) {
166 |             $newKey = $prefix . $key;
167 |             $value = $this->processConditionalLogic($prefix, $value);
168 |             $result[$newKey] = $value;
169 |         }
170 | 
171 |         return $result;
172 |     }
173 | 
174 |     /**
175 |      * Apply conditional logic transformation rules
176 |      *
177 |      * @param string $prefix
178 |      * @param array $acf
179 |      * @return array
180 |      */
181 |     protected function processConditionalLogic($prefix, $acf)
182 |     {
183 |         $prefixer = new TransformConditionalLogic;
184 |         return $prefixer->run($acf, $prefix);
185 |     }
186 | 
187 |     /**
188 |      * Retrieve prefix to be used for current copy operation
189 |      *
190 |      * @return string
191 |      */
192 |     protected function getPrefix()
193 |     {
194 |         $prefix = Arr::get($this->fields, 'prefix', false);
195 |         if ($prefix === false) {
196 |             return '';
197 |         }
198 |         // If 'prefix' is `true`, it is implied that prefix uses parent key
199 |         if ($prefix === true) {
200 |             $prefix = $this->key;
201 |         }
202 |         return $prefix . '_';
203 |     }
204 | }
205 | 


--------------------------------------------------------------------------------
/src/Capsule/BlueprintsFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Capsule;
 3 | 
 4 | use Windsor\Support\Singleton;
 5 | use Tightenco\Collect\Support\Arr;
 6 | 
 7 | class BlueprintsFactory
 8 | {
 9 |     use Singleton;
10 | 
11 |     /**
12 |      * Stored blueprints
13 |      *
14 |      * @var array
15 |      */
16 |     protected $blueprints = [];
17 | 
18 |     /**
19 |      * Store blueprint configuration
20 |      *
21 |      * @param string $key
22 |      * @param array $data
23 |      * @return $this
24 |      */
25 |     public function store($key, array $data = [])
26 |     {
27 |         $this->blueprints[$key] = $data;
28 |         return $this;
29 |     }
30 | 
31 |     /**
32 |      * Attempt to merge all fields from blueprints if available
33 |      *
34 |      * @param array $yamlFields
35 |      * @return array
36 |      */
37 |     public function mergeBlueprints(array $yamlFields)
38 |     {
39 |         $result = [];
40 |         foreach ($yamlFields as $key => $fields) {
41 |             // Bail early if not 'blueprint' type field
42 |             if (Arr::get($fields, 'type') !== 'blueprint') {
43 |                 $result[$key] = $fields;
44 |                 continue;
45 |             }
46 |             $result = array_merge($result, $this->unpackBlueprint($key, $fields));
47 |         }
48 |         return $result;
49 |     }
50 | 
51 |     /**
52 |      * Unpack given field blueprint
53 |      *
54 |      * @param string $key
55 |      * @param array $fields
56 |      * @return array
57 |      */
58 |     protected function unpackBlueprint($key, array $fields = [])
59 |     {
60 |         $source = Arr::get($fields, 'source');
61 |         $blueprint = Arr::get($this->blueprints, $source);
62 |         if (!$blueprint) {
63 |             return [
64 |                 $key => $this->reportMissingBlueprint($source)
65 |             ];
66 |         }
67 |         $cloner = new BlueprintBuilder($blueprint, $key, $fields);
68 |         return $cloner->makeCopy();
69 |     }
70 | 
71 |     /**
72 |      * Create missing blueprint block message field
73 |      *
74 |      * @param string $name
75 |      * @return array
76 |      */
77 |     protected function reportMissingBlueprint($name)
78 |     {
79 |         $styles = [
80 |             'background-color: #ff7f50',
81 |             'padding: 10px 15px',
82 |             'color: #fff',
83 |             'border-radius: 4px',
84 |         ];
85 |         $message = sprintf('
86 |             <div style="%s">
87 |                 Missing blueprint: <strong>%s</strong>
88 |             </div>
89 |         ', implode('; ', $styles), $name);
90 |         return [
91 |             'type' => 'message',
92 |             'message' => $message,
93 |             'esc_html' => false
94 |         ];
95 |     }
96 | }
97 | 


--------------------------------------------------------------------------------
/src/Capsule/FieldGroup.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | namespace Windsor\Capsule;
  3 | 
  4 | use Tightenco\Collect\Support\Arr;
  5 | use Windsor\Support\RulesCollector;
  6 | use Windsor\Capsule\BlueprintsFactory;
  7 | 
  8 | class FieldGroup extends AbstractCapsule
  9 | {
 10 |     const TYPE_FIELD_GROUP = 'FIELD_GROUP';
 11 |     const TYPE_REPEATER = 'REPEATER';
 12 |     const TYPE_GROUP = 'GROUP';
 13 |     const TYPE_FLEX = 'FLEXIBLE_CONTENT';
 14 | 
 15 |     /**
 16 |      * @var array Raw content of ACF definition file
 17 |      */
 18 |     protected $content;
 19 | 
 20 |     /**
 21 |      * Type of field group
 22 |      *
 23 |      * @var string
 24 |      */
 25 |     protected $type;
 26 | 
 27 |     /**
 28 |      * Templates repository
 29 |      *
 30 |      * @var \Windsor\Capsule\BlueprintsFactory
 31 |      */
 32 |     protected $templates;
 33 | 
 34 |     /**
 35 |      * Rules collection
 36 |      *
 37 |      * @var \Windsor\Support\RulesCollector
 38 |      */
 39 |     protected $rules;
 40 | 
 41 |     public function __construct($type)
 42 |     {
 43 |         $this->type = $type;
 44 |         $this->templates = BlueprintsFactory::instance();
 45 |     }
 46 | 
 47 |     /**
 48 |      * @inheritdoc
 49 |      */
 50 |     public function make($content)
 51 |     {
 52 |         $this->namespace(Arr::get($content, 'key'), function () use ($content) {
 53 |             $this->content = $content;
 54 |             $this->parsed = tap($content, function (&$group) {
 55 |                 $group = $this->parseGroup($group);
 56 |                 if ($this->type === static::TYPE_FLEX) {
 57 |                     $group['layouts'] = $this->parseLayouts($group);
 58 |                 } else {
 59 |                     $group[$this->getFieldsKey()] = $this->parseFields($group);
 60 |                 }
 61 |             });
 62 |         });
 63 |         return $this;
 64 |     }
 65 | 
 66 |     /**
 67 |      * Parse group-type content
 68 |      *
 69 |      * @param array $group
 70 |      * @return array
 71 |      */
 72 |     protected function parseGroup($group)
 73 |     {
 74 |         $this->rules
 75 |             ->get('groups')
 76 |             ->each(function ($rule) use (&$group) {
 77 |                 $group = (new $rule)->process($this, '', $group);
 78 |             });
 79 |         return $group;
 80 |     }
 81 | 
 82 |     /**
 83 |      * Parse collection of ACF fields
 84 |      *
 85 |      * @param array $group
 86 |      * @return array
 87 |      */
 88 |     protected function parseFields($group)
 89 |     {
 90 |         $fields = [];
 91 |         $yamlFields = Arr::get($group, $this->getFieldsKey(), []);
 92 |         if (!$yamlFields) {
 93 |             return [];
 94 |         }
 95 | 
 96 |         // If templates, merge definitions
 97 |         $yamlFields = $this->templates->mergeBlueprints($yamlFields);
 98 | 
 99 |         foreach ($yamlFields as $key => $value) {
100 |             $fields[] = $this->makeField($key, $value);
101 |         }
102 |         return $fields;
103 |     }
104 | 
105 |     /**
106 |      * Parse flexible content layouts
107 |      * which in essence parse nested repeaters
108 |      *
109 |      * @param array $group
110 |      * @return array
111 |      */
112 |     protected function parseLayouts($group)
113 |     {
114 |         $parsedLayouts = [];
115 |         $layouts = Arr::get($group, 'layouts', []);
116 |         foreach ($layouts as $layoutKey => $layoutConfig) {
117 |             $parsedLayout = $this->makeField($layoutKey, $layoutConfig);
118 |             // We don't need 'type' for layouts
119 |             unset($parsedLayout['type']);
120 |             $yamlFields = Arr::get($parsedLayout, 'sub_fields', []);
121 |             $yamlFields = $this->templates->mergeBlueprints($yamlFields);
122 | 
123 |             $fields = [];
124 |             $this->namespace($this->makeKey($layoutKey), function () use ($yamlFields, &$fields) {
125 |                 foreach ($yamlFields as $key => $value) {
126 |                     $fields[] = $this->makeField($key, $value);
127 |                 }
128 |             });
129 | 
130 |             $parsedLayout['sub_fields'] = $fields;
131 |             $parsedLayouts[] = $parsedLayout;
132 |         }
133 |         return $parsedLayouts;
134 |     }
135 | 
136 |     /**
137 |      * Creates ACF-valid field
138 |      *
139 |      * @param string $key
140 |      * @param array $value
141 |      * @return array
142 |      */
143 |     protected function makeField($key, $value)
144 |     {
145 |         $uniqueKey = $this->makeKey($key);
146 |         if ($staticKey = Arr::get($value, 'key')) {
147 |             $uniqueKey = $staticKey;
148 |         }
149 |         $value = array_merge($value, [
150 |             'name' => $key,
151 |             'key'  => $uniqueKey
152 |         ]);
153 | 
154 |         if ($groupType = $this->getGroupType(Arr::get($value, 'type'))) {
155 |             $value = (new FieldGroup($groupType))
156 |                 ->setRules(new RulesCollector($this->rules))
157 |                 ->setDebug($this->isDebugging())
158 |                 ->make($value)
159 |                 ->parsed();
160 |         }
161 | 
162 |         $this->rules
163 |             ->get('fields')
164 |             ->each(function ($rule) use ($key, &$value) {
165 |                 $value = (new $rule)->process($this, $key, $value);
166 |             });
167 | 
168 |         return $value;
169 |     }
170 | 
171 |     /**
172 |      * Set transformation rules
173 |      *
174 |      * @param \Windsor\Support\RulesCollector $rules
175 |      * @return self
176 |      */
177 |     public function setRules($rules)
178 |     {
179 |         $this->rules = $rules;
180 |         return $this;
181 |     }
182 | 
183 |     /**
184 |      * Retrieve associative keys of fields based on active group type
185 |      *
186 |      * @return string
187 |      */
188 |     protected function getFieldsKey()
189 |     {
190 |         switch ($this->type) {
191 |             case static::TYPE_FIELD_GROUP:
192 |                 return 'fields';
193 |                 break;
194 |             case static::TYPE_REPEATER:
195 |             case static::TYPE_GROUP:
196 |                 return 'sub_fields';
197 |                 break;
198 |             case static::TYPE_FLEX:
199 |                 return 'layouts';
200 |                 break;
201 |             default:
202 |                 throw new \Exception("Invalid type: $this->type");
203 |                 break;
204 |         }
205 |     }
206 | 
207 |     /**
208 |      * Return 'grouping' type field, some fields
209 |      * are container of other fields
210 |      *
211 |      * @param string $type
212 |      * @return string|null
213 |      */
214 |     protected function getGroupType($type)
215 |     {
216 |         $groupType = null;
217 |         switch ($type) {
218 |             case 'repeater':
219 |                 $groupType = static::TYPE_REPEATER;
220 |                 break;
221 |             case 'group':
222 |                 $groupType = static::TYPE_GROUP;
223 |                 break;
224 |             case 'flexible_content':
225 |                 $groupType = static::TYPE_FLEX;
226 |                 break;
227 |             default:
228 |                 break;
229 |         }
230 |         return $groupType;
231 |     }
232 | }
233 | 


--------------------------------------------------------------------------------
/src/Capsule/Manager.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | namespace Windsor\Capsule;
  3 | 
  4 | use Windsor\Parser\Finder;
  5 | use Windsor\Support\Config;
  6 | use Tightenco\Collect\Support\Arr;
  7 | use Windsor\Support\RulesCollector;
  8 | use Windsor\Admin\WordPress\UiLoader;
  9 | 
 10 | class Manager
 11 | {
 12 |     /**
 13 |      * @var \Windsor\Parser\Finder
 14 |      */
 15 |     protected $finder;
 16 | 
 17 |     /**
 18 |      * @var \Windsor\Capsule\BlueprintsFactory
 19 |      */
 20 |     protected $blueprints;
 21 | 
 22 |     /**
 23 |      * @var \Windsor\Support\Config
 24 |      */
 25 |     protected $config;
 26 | 
 27 |     public function __construct($config, $finder, $blueprints)
 28 |     {
 29 |         $this->config = $config;
 30 |         $this->finder = $finder;
 31 |         $this->blueprints = $blueprints;
 32 |     }
 33 | 
 34 |     /**
 35 |      * Create default instance with optional configurations
 36 |      * @link https://windsor-docs.netlify.app/configurations.html
 37 |      *
 38 |      * @param array $config Additional configuration.
 39 |      *
 40 |      * @return \Windsor\Capsule\Manager
 41 |      */
 42 |     public static function make(array $config = [])
 43 |     {
 44 |         return new static(
 45 |             Config::initialise($config),
 46 |             new Finder,
 47 |             BlueprintsFactory::instance()
 48 |         );
 49 |     }
 50 | 
 51 |     /**
 52 |      * Register our in-code ACF fields
 53 |      *
 54 |      * @param array $config
 55 |      * @return void
 56 |      */
 57 |     public function register()
 58 |     {
 59 |         $this->maybeLoadUI();
 60 |         $this->build()
 61 |             ->each(function ($parsed) {
 62 |                 if ($parsed['type'] === 'field-group') {
 63 |                     acf_add_local_field_group($parsed['parsed']);
 64 |                 } elseif ($parsed['type'] === 'block') {
 65 |                     if (function_exists('acf_register_block_type')) {
 66 |                         acf_register_block_type(Arr::get($parsed, 'parsed.block'));
 67 |                     }
 68 |                     acf_add_local_field_group(Arr::get($parsed, 'parsed.field-group'));
 69 |                 }
 70 |             });
 71 |     }
 72 | 
 73 |     /**
 74 |      * Build and return parsed ACF fields
 75 |      *
 76 |      * @return \Tightenco\Collect\Support\Collection
 77 |      */
 78 |     public function build()
 79 |     {
 80 |         $this->finder
 81 |             ->setBasePath($this->config('path'))
 82 |             ->setIndex($this->config('entry'))
 83 |             ->setParser($this->config('parser'));
 84 | 
 85 |         // Collect all reusable blueprints
 86 |         $this->storeBlueprints(
 87 |             $this->getDefinitions('blueprints')
 88 |         );
 89 | 
 90 |         $results = collect();
 91 |         foreach (['fields', 'pages'] as $type) {
 92 |             collect($this->getDefinitions($type))
 93 |                 ->each(function ($def) use ($results) {
 94 |                     $parsed = $this->readFieldGroup($def);
 95 |                     $results->push([
 96 |                         'type' => 'field-group',
 97 |                         'parsed' => $parsed
 98 |                     ]);
 99 |                 });
100 |         }
101 |         foreach (['blocks'] as $type) {
102 |             collect($this->getDefinitions($type))
103 |                 ->each(function ($def) use ($results) {
104 |                     $parsed = $this->readBlock($def);
105 |                     $results->push([
106 |                         'type' => 'block',
107 |                         'parsed' => [
108 |                             'field-group' => $parsed['field-group'],
109 |                             'block' => $parsed['block'],
110 |                         ]
111 |                     ]);
112 |                 });
113 |         }
114 |         return $results;
115 |     }
116 | 
117 |     /**
118 |      * Reads an ACF field group definition file
119 |      *
120 |      * @param string $def
121 |      * @return array Array containing ACF fields as-per ACF definitions
122 |      */
123 |     public function readFieldGroup($def)
124 |     {
125 |         if (is_string($def)) {
126 |             $def = $this->finder->read($def);
127 |         }
128 | 
129 |         $result = (new FieldGroup(FieldGroup::TYPE_FIELD_GROUP))
130 |             ->setRules(
131 |                 new RulesCollector($this->config('rules', []))
132 |             )
133 |             ->setDebug($this->config('debug', false))
134 |             ->make($def)
135 |             ->parsed();
136 | 
137 |         return $result;
138 |     }
139 | 
140 |     /**
141 |      * Reads an ACF block definition file
142 |      *
143 |      * @param string $def
144 |      * @return array Array containing ACF fields as-per ACF definitions
145 |      */
146 |     public function readBlock($def)
147 |     {
148 |         $content = $this->finder->read($def);
149 |         $blockDefinition = (new Block())
150 |             ->setDebug($this->config('debug', false))
151 |             ->make($content)
152 |             ->parsed();
153 |         $fieldGroupsDefinition = array_merge($content, [
154 |             'location' => [
155 |                 [
156 |                     [
157 |                         'param' => 'block',
158 |                         'operator' => '==',
159 |                         'value' => sprintf("acf/%s", $content['key'])
160 |                     ]
161 |                 ]
162 |             ]
163 |         ]);
164 |         return [
165 |             'field-group' => $this->readFieldGroup($fieldGroupsDefinition),
166 |             'block' => $blockDefinition
167 |         ];
168 |     }
169 | 
170 |     /**
171 |      * Optionally initiate UI (Admin) components of Windsor
172 |      *
173 |      * @return void
174 |      */
175 |     protected function maybeLoadUI()
176 |     {
177 |         $uiConfig = $this->config('ui');
178 |         if (!$uiConfig) {
179 |             return;
180 |         }
181 |         if (!is_array($uiConfig)) {
182 |             $uiConfig = [];
183 |         }
184 |         if (Arr::get($uiConfig, 'enabled') === false) {
185 |             return;
186 |         }
187 |         $ui = new UiLoader($uiConfig);
188 |         $ui->boot($uiConfig);
189 |     }
190 | 
191 |     /**
192 |      * Store blueprints data
193 |      *
194 |      * @param array $data
195 |      * @return void
196 |      */
197 |     protected function storeBlueprints(array $data = [])
198 |     {
199 |         foreach ($data as $def) {
200 |             $content = $this->finder->read($def);
201 |             $key = str_replace('.acf.yaml', '', basename($def));
202 |             $this->blueprints->store($key, $content);
203 |         }
204 |     }
205 | 
206 |     /**
207 |      * Retrieve stored configuration value
208 |      *
209 |      * @param string $key
210 |      * @param mixed $default
211 |      * @return mixed
212 |      */
213 |     protected function config($key, $default = null)
214 |     {
215 |         return $this->config->get($key, $default);
216 |     }
217 | 
218 |     /**
219 |      * Retrieve locations of ACF definitions
220 |      *
221 |      * @return array
222 |      */
223 |     protected function getDefinitions($type)
224 |     {
225 |         try {
226 |             $fields = $this->finder->index();
227 |             return Arr::get($fields, $type, []);
228 |         } catch (\Throwable $th) {
229 |             throw $th;
230 |             return [];
231 |         }
232 |     }
233 | }
234 | 


--------------------------------------------------------------------------------
/src/Contracts/ParserContract.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Contracts;
 3 | 
 4 | interface ParserContract
 5 | {
 6 | 
 7 |     /**
 8 |      * Parse file content into fields array
 9 |      *
10 |      * @param string $content
11 |      * @return array
12 |      */
13 |     public function parse($content);
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Parser/Finder.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | namespace Windsor\Parser;
  3 | 
  4 | class Finder
  5 | {
  6 | 
  7 |     /**
  8 |      * Root directory
  9 |      *
 10 |      * @var string
 11 |      */
 12 |     protected $root;
 13 | 
 14 |     /**
 15 |      * Filename of entry point
 16 |      *
 17 |      * @var string
 18 |      */
 19 |     protected $entry;
 20 | 
 21 |     /**
 22 |      * @var \Windsor\Contracts\ParserContract
 23 |      */
 24 |     protected $parser;
 25 | 
 26 |     /**
 27 |      * Set parser
 28 |      *
 29 |      * @param Reader $parser
 30 |      * @return $this
 31 |      */
 32 |     public function setParser($parser)
 33 |     {
 34 |         if (is_string($parser) && class_exists($parser)) {
 35 |             $parser = apply_filters('acf-windsor/init_parser', new $parser);
 36 |         }
 37 |         $this->parser = $parser;
 38 |         return $this;
 39 |     }
 40 | 
 41 |     /**
 42 |      * Set entry point for acf fields
 43 |      *
 44 |      * @param string
 45 |      * @return $this
 46 |      */
 47 |     public function setIndex($name)
 48 |     {
 49 |         $this->entry = $name;
 50 |         return $this;
 51 |     }
 52 | 
 53 |     /**
 54 |      * Read a definition file content
 55 |      *
 56 |      * @param string $name
 57 |      * @return array
 58 |      */
 59 |     public function read($name)
 60 |     {
 61 |         return $this->readFile($this->path($name));
 62 |     }
 63 | 
 64 |     /**
 65 |      * Retrieve index of all definition files
 66 |      *
 67 |      * @return array
 68 |      */
 69 |     public function index()
 70 |     {
 71 |         return $this->readFile($this->path($this->entry));
 72 |     }
 73 | 
 74 |     /**
 75 |      * Set base path to find ACF fields
 76 |      *
 77 |      * @param string $path
 78 |      * @return $this
 79 |      */
 80 |     public function setBasePath($path)
 81 |     {
 82 |         $this->root = $path;
 83 |         return $this;
 84 |     }
 85 | 
 86 |     /**
 87 |      * Get absolute path of given definition file name
 88 |      *
 89 |      * @param string $name
 90 |      * @return string
 91 |      */
 92 |     protected function path($name)
 93 |     {
 94 |         return $this->root . '/' . ltrim($name, '/');
 95 |     }
 96 | 
 97 |     /**
 98 |      * Read and parse given file into array
 99 |      *
100 |      * @param string $filepath
101 |      * @return array
102 |      */
103 |     protected function readFile($filepath)
104 |     {
105 |         if (!file_exists($filepath)) {
106 |             throw new \Exception("ACF Yaml file not found at $filepath");
107 |         }
108 |         return $this->parser->parse(file_get_contents($filepath));
109 |     }
110 | }
111 | 


--------------------------------------------------------------------------------
/src/Parser/YamlParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Parser;
 3 | 
 4 | use Symfony\Component\Yaml\Yaml;
 5 | use Windsor\Contracts\ParserContract;
 6 | 
 7 | class YamlParser implements ParserContract
 8 | {
 9 | 
10 |     /**
11 |      * Parse file content into fields array
12 |      *
13 |      * @param string $content
14 |      * @return array
15 |      */
16 |     public function parse($content)
17 |     {
18 |         return Yaml::parse($content);
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Rules/FieldConditionRule.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Rules;
 3 | 
 4 | use Windsor\Rules\Utilities\TransformConditionalLogic;
 5 | 
 6 | class FieldConditionRule
 7 | {
 8 |     /**
 9 |      * Process this rule
10 |      *
11 |      * @param FieldGroup  $group
12 |      * @param string $key
13 |      * @param array $acf
14 |      * @return array
15 |      */
16 |     public function process($group, $key, array $acf): array
17 |     {
18 |         $prefixer = new TransformConditionalLogic();
19 |         return $prefixer->run($acf, function ($keyReference) use ($group) {
20 |             return $group->makeKey($keyReference);
21 |         });
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Rules/FieldDefaultsRule.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Rules;
 3 | 
 4 | use Tightenco\Collect\Support\Arr;
 5 | 
 6 | class FieldDefaultsRule
 7 | {
 8 |     /**
 9 |      * Process this rule
10 |      *
11 |      * @param FieldGroup  $group
12 |      * @param string $key
13 |      * @param array $acf
14 |      * @return array
15 |      */
16 |     public function process($group, $key, array $acf): array
17 |     {
18 |         $type = Arr::get($acf, 'type');
19 |         // Default field type to text (commonly used)
20 |         if (!$type) {
21 |             $acf['type'] = 'text';
22 |         }
23 |         // Typo resistance
24 |         // - instruction -> instructions
25 |         if ($instruction = Arr::get($acf, 'instruction')) {
26 |             Arr::set($acf, 'instructions', $instruction);
27 |             unset($acf['instruction']);
28 |         }
29 |         return $acf;
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Rules/GroupLocationRule.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Rules;
 3 | 
 4 | use Tightenco\Collect\Support\Arr;
 5 | 
 6 | class GroupLocationRule
 7 | {
 8 | 
 9 |     /**
10 |      * Process this rule
11 |      *
12 |      * @param FieldGroup $group
13 |      * @param string $key
14 |      * @param array $acf
15 |      * @return array
16 |      */
17 |     public function process($group, $key, array $acf): array
18 |     {
19 |         $acf = $this->checkLocation($group, $acf);
20 |         $acf = $this->checkCollapse($group, $acf);
21 | 
22 |         return $acf;
23 |     }
24 | 
25 |     /**
26 |      * Check referred collapsible property for repeater of flexible content
27 |      * to apply the right key namespace prefix
28 |      *
29 |      * @param FieldGroup $group
30 |      * @param array $acf
31 |      * @return array
32 |      */
33 |     protected function checkCollapse($group, $acf)
34 |     {
35 |         $collapsed = Arr::get($acf, 'collapsed');
36 |         if (!$collapsed) {
37 |             return $acf;
38 |         }
39 |         Arr::set($acf, 'collapsed', $group->makekey($collapsed));
40 |         return $acf;
41 |     }
42 | 
43 |     /**
44 |      * Check and validate location value
45 |      *
46 |      * @param FieldGroup $group
47 |      * @param array $acf
48 |      * @return array
49 |      */
50 |     protected function checkLocation($group, $acf)
51 |     {
52 |         $locations = Arr::get($acf, 'location', false);
53 |         if ($locations === false) {
54 |             return $acf;
55 |         }
56 |         if (is_null($locations)) {
57 |             $acf['location'] = $this->getHiddenLocationRule();
58 |         }
59 |         return $acf;
60 |     }
61 | 
62 |     /**
63 |      * Retrieve location rule which ensures the field is not shown
64 |      *
65 |      * @return array
66 |      */
67 |     public function getHiddenLocationRule()
68 |     {
69 |         return [
70 |             [
71 |                 [
72 |                     'param'    => 'options_page',
73 |                     'operator' => '==',
74 |                     'value'    => 'acf-options-global-options'
75 |                 ],
76 |                 [
77 |                     'param'    => 'options_page',
78 |                     'operator' => '!=',
79 |                     'value'    => 'acf-options-global-options'
80 |                 ]
81 |             ]
82 |         ];
83 |     }
84 | }
85 | 


--------------------------------------------------------------------------------
/src/Rules/HelperRule.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Rules;
 3 | 
 4 | use Windsor\Capsule\FieldGroup;
 5 | use Tightenco\Collect\Support\Arr;
 6 | 
 7 | class HelperRule
 8 | {
 9 |     /**
10 |      * Process this rule
11 |      *
12 |      * @param FieldGroup $group
13 |      * @param string $key
14 |      * @param array $acf
15 |      * @return array
16 |      */
17 |     public function process($group, $key, array $acf): array
18 |     {
19 |         if (!$group->isDebugging()) {
20 |             return $acf;
21 |         }
22 |         $instruction = Arr::get($acf, 'instructions', '');
23 |         $instruction .= $this->getDebugHtml($key);
24 |         Arr::set($acf, 'instructions', $instruction);
25 |         return $acf;
26 |     }
27 | 
28 |     /**
29 |      * Get debug HTML helper
30 |      *
31 |      * @param string $key
32 |      * @return string
33 |      */
34 |     public function getDebugHtml($key)
35 |     {
36 |         return sprintf(
37 |             "
38 |             <span style=\"
39 |                 border-radius: 0.25rem;
40 |                 background-color: #007cba;
41 |                 padding: 0.15rem 0.5rem;
42 |                 color: #fff;
43 |                 border: 1px solid #007cba;
44 |                 font-size: 11px;
45 |                 display: inline-block;
46 |             \">
47 |              %s
48 |             </span>
49 |         ",
50 |             $key
51 |         );
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/src/Rules/Utilities/TransformConditionalLogic.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Rules\Utilities;
 3 | 
 4 | use Tightenco\Collect\Support\Arr;
 5 | 
 6 | class TransformConditionalLogic
 7 | {
 8 |     public function run($acf, $prefixOrCallable = null)
 9 |     {
10 |         $conditions = Arr::get($acf, 'conditional_logic', []);
11 |         if (count($conditions) <= 0) {
12 |             return $acf;
13 |         }
14 | 
15 |         foreach ($conditions as $and => $andContent) {
16 |             foreach ($andContent as $or => $value) {
17 |                 $keyReference = Arr::get($value, 'field', '');
18 |                 $prefixedKey = $this->getPrefixedKey(
19 |                     $keyReference,
20 |                     $prefixOrCallable
21 |                 );
22 |                 if (!$prefixedKey) {
23 |                     throw new \Exception("Unable to prefix given key: $keyReference");
24 |                 }
25 |                 Arr::set(
26 |                     $acf,
27 |                     sprintf('conditional_logic.%s.%s.field', $and, $or),
28 |                     $prefixedKey
29 |                 );
30 |                 Arr::set(
31 |                     $acf,
32 |                     sprintf('conditional_logic.%s.%s.value', $and, $or),
33 |                     $this->fixValue(Arr::get($value, 'value'))
34 |                 );
35 |             }
36 |         }
37 | 
38 |         return $acf;
39 |     }
40 | 
41 |     protected function getPrefixedKey($keyReference, $prefixOrCallable)
42 |     {
43 |         if (is_string($prefixOrCallable)) {
44 |             return $prefixOrCallable . $keyReference;
45 |         } elseif (is_callable($prefixOrCallable)) {
46 |             return call_user_func($prefixOrCallable, $keyReference);
47 |         } else {
48 |             return null;
49 |         }
50 |     }
51 | 
52 |     /**
53 |      * Adjust values to ensure conditional logic is running correctly
54 |      *
55 |      * @param mixed $val
56 |      * @return mixed
57 |      */
58 |     protected function fixValue($val)
59 |     {
60 |         if (is_bool($val)) {
61 |             return $val === true ? 1 : 0;
62 |         }
63 |         return $val;
64 |     }
65 | }
66 | 


--------------------------------------------------------------------------------
/src/Rules/WrapperShortcuts.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Rules;
 3 | 
 4 | use Tightenco\Collect\Support\Arr;
 5 | 
 6 | class WrapperShortcuts
 7 | {
 8 |     /**
 9 |      * Process this rule
10 |      *
11 |      * @param FieldGroup  $group
12 |      * @param string $key
13 |      * @param array $acf
14 |      * @return array
15 |      */
16 |     public function process($group, $key, array $acf): array
17 |     {
18 |         // Shortcut to width
19 |         if ($width = Arr::get($acf, 'wrapper_width')) {
20 |             Arr::forget($acf, 'wrapper_width');
21 |             Arr::set($acf, 'wrapper.width', $width);
22 |         }
23 |         // Shortcut to 'class' attribute
24 |         if ($class = Arr::get($acf, 'wrapper_class')) {
25 |             Arr::forget($acf, 'wrapper_class');
26 |             Arr::set($acf, 'wrapper.class', $class);
27 |         }
28 |         // Shortcut to 'id' attribute
29 |         if ($class = Arr::get($acf, 'wrapper_id')) {
30 |             Arr::forget($acf, 'wrapper_id');
31 |             Arr::set($acf, 'wrapper.id', $class);
32 |         }
33 |         return $acf;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Support/Config.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | namespace Windsor\Support;
  3 | 
  4 | use ArrayAccess;
  5 | use Tightenco\Collect\Contracts\Support\Arrayable;
  6 | 
  7 | class Config implements Arrayable, ArrayAccess
  8 | {
  9 | 
 10 |     /**
 11 |      * Configuration attributes
 12 |      *
 13 |      * @var array
 14 |      */
 15 |     protected $attributes;
 16 | 
 17 |     public function __construct($attributes = [])
 18 |     {
 19 |         $this->attributes = $attributes;
 20 |     }
 21 | 
 22 |     /**
 23 |      * Initialise configuration values
 24 |      *
 25 |      * @param array $config
 26 |      *
 27 |      * @return self
 28 |      */
 29 |     public static function initialise(array $config = [])
 30 |     {
 31 |         return new static(array_merge(
 32 |             apply_filters('acf-windsor/config', static::getDefault()),
 33 |             $config
 34 |         ));
 35 |     }
 36 | 
 37 |     /**
 38 |      * Replace configuration values
 39 |      *
 40 |      * @param array $attributes
 41 |      * @return \Windsor\Support\Config
 42 |      */
 43 |     public function setValues($attributes)
 44 |     {
 45 |         $this->attributes = $attributes;
 46 |     }
 47 | 
 48 |     /**
 49 |      * Retrieve default configuration values
 50 |      *
 51 |      * @return array
 52 |      */
 53 |     public static function getDefault()
 54 |     {
 55 |         $path = __DIR__ .'/../config.php';
 56 |         if (!file_exists($path)) {
 57 |             throw new \Exception('Missing configuration file, unable to initialise Windsor helper');
 58 |         }
 59 |         return require_once $path;
 60 |     }
 61 | 
 62 |     /**
 63 |      * Get an attribute from the fluent instance.
 64 |      *
 65 |      * @param  string  $key
 66 |      * @param  mixed  $default
 67 |      * @return mixed
 68 |      */
 69 |     public function get($key, $default = null)
 70 |     {
 71 |         if (array_key_exists($key, $this->attributes)) {
 72 |             return $this->attributes[$key];
 73 |         }
 74 | 
 75 |         return value($default);
 76 |     }
 77 | 
 78 |     /**
 79 |      * Get the attributes from the fluent instance.
 80 |      *
 81 |      * @return array
 82 |      */
 83 |     public function getAttributes()
 84 |     {
 85 |         return $this->attributes;
 86 |     }
 87 | 
 88 |     /**
 89 |      * Convert the fluent instance to an array.
 90 |      *
 91 |      * @return array
 92 |      */
 93 |     public function toArray()
 94 |     {
 95 |         return $this->attributes;
 96 |     }
 97 | 
 98 |     /**
 99 |      * Convert the object into something JSON serializable.
100 |      *
101 |      * @return array
102 |      */
103 |     public function jsonSerialize()
104 |     {
105 |         return $this->toArray();
106 |     }
107 | 
108 |     /**
109 |      * Convert the fluent instance to JSON.
110 |      *
111 |      * @param  int  $options
112 |      * @return string
113 |      */
114 |     public function toJson($options = 0)
115 |     {
116 |         return json_encode($this->jsonSerialize(), $options);
117 |     }
118 | 
119 |     /**
120 |      * Determine if the given offset exists.
121 |      *
122 |      * @param  string  $offset
123 |      * @return bool
124 |      */
125 |     public function offsetExists($offset)
126 |     {
127 |         return isset($this->attributes[$offset]);
128 |     }
129 | 
130 |     /**
131 |      * Get the value for a given offset.
132 |      *
133 |      * @param  string  $offset
134 |      * @return mixed
135 |      */
136 |     public function offsetGet($offset)
137 |     {
138 |         return $this->get($offset);
139 |     }
140 | 
141 |     /**
142 |      * Set the value at the given offset.
143 |      *
144 |      * @param  string  $offset
145 |      * @param  mixed  $value
146 |      * @return void
147 |      */
148 |     public function offsetSet($offset, $value)
149 |     {
150 |         $this->attributes[$offset] = $value;
151 |     }
152 | 
153 |     /**
154 |      * Unset the value at the given offset.
155 |      *
156 |      * @param  string  $offset
157 |      * @return void
158 |      */
159 |     public function offsetUnset($offset)
160 |     {
161 |         unset($this->attributes[$offset]);
162 |     }
163 | }
164 | 


--------------------------------------------------------------------------------
/src/Support/Fluent.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | namespace Windsor\Support;
  3 | 
  4 | use ArrayAccess;
  5 | use Tightenco\Collect\Contracts\Support\Arrayable;
  6 | use Tightenco\Collect\Contracts\Support\Jsonable;
  7 | use JsonSerializable;
  8 | 
  9 | /**
 10 |  * This is a carbon copy of Laravel's Fluent class
 11 |  * @author Taylor Otwell <taylor@laravel.com>
 12 |  * @link https://github.com/illuminate/support
 13 |  */
 14 | class Fluent implements Arrayable, ArrayAccess, Jsonable, JsonSerializable
 15 | {
 16 |     /**
 17 |      * All of the attributes set on the fluent instance.
 18 |      *
 19 |      * @var array
 20 |      */
 21 |     protected $attributes = [];
 22 | 
 23 |     /**
 24 |      * Create a new fluent instance.
 25 |      *
 26 |      * @param  array|object  $attributes
 27 |      * @return void
 28 |      */
 29 |     public function __construct($attributes = [])
 30 |     {
 31 |         foreach ($attributes as $key => $value) {
 32 |             $this->attributes[$key] = $value;
 33 |         }
 34 |     }
 35 | 
 36 |     /**
 37 |      * Get an attribute from the fluent instance.
 38 |      *
 39 |      * @param  string  $key
 40 |      * @param  mixed  $default
 41 |      * @return mixed
 42 |      */
 43 |     public function get($key, $default = null)
 44 |     {
 45 |         if (array_key_exists($key, $this->attributes)) {
 46 |             return $this->attributes[$key];
 47 |         }
 48 | 
 49 |         return value($default);
 50 |     }
 51 | 
 52 |     /**
 53 |      * Get the attributes from the fluent instance.
 54 |      *
 55 |      * @return array
 56 |      */
 57 |     public function getAttributes()
 58 |     {
 59 |         return $this->attributes;
 60 |     }
 61 | 
 62 |     /**
 63 |      * Convert the fluent instance to an array.
 64 |      *
 65 |      * @return array
 66 |      */
 67 |     public function toArray()
 68 |     {
 69 |         return $this->attributes;
 70 |     }
 71 | 
 72 |     /**
 73 |      * Convert the object into something JSON serializable.
 74 |      *
 75 |      * @return array
 76 |      */
 77 |     public function jsonSerialize()
 78 |     {
 79 |         return $this->toArray();
 80 |     }
 81 | 
 82 |     /**
 83 |      * Convert the fluent instance to JSON.
 84 |      *
 85 |      * @param  int  $options
 86 |      * @return string
 87 |      */
 88 |     public function toJson($options = 0)
 89 |     {
 90 |         return json_encode($this->jsonSerialize(), $options);
 91 |     }
 92 | 
 93 |     /**
 94 |      * Determine if the given offset exists.
 95 |      *
 96 |      * @param  string  $offset
 97 |      * @return bool
 98 |      */
 99 |     public function offsetExists($offset)
100 |     {
101 |         return isset($this->attributes[$offset]);
102 |     }
103 | 
104 |     /**
105 |      * Get the value for a given offset.
106 |      *
107 |      * @param  string  $offset
108 |      * @return mixed
109 |      */
110 |     public function offsetGet($offset)
111 |     {
112 |         return $this->get($offset);
113 |     }
114 | 
115 |     /**
116 |      * Set the value at the given offset.
117 |      *
118 |      * @param  string  $offset
119 |      * @param  mixed  $value
120 |      * @return void
121 |      */
122 |     public function offsetSet($offset, $value)
123 |     {
124 |         $this->attributes[$offset] = $value;
125 |     }
126 | 
127 |     /**
128 |      * Unset the value at the given offset.
129 |      *
130 |      * @param  string  $offset
131 |      * @return void
132 |      */
133 |     public function offsetUnset($offset)
134 |     {
135 |         unset($this->attributes[$offset]);
136 |     }
137 | 
138 |     /**
139 |      * Handle dynamic calls to the fluent instance to set attributes.
140 |      *
141 |      * @param  string  $method
142 |      * @param  array  $parameters
143 |      * @return $this
144 |      */
145 |     public function __call($method, $parameters)
146 |     {
147 |         $this->attributes[$method] = count($parameters) > 0 ? $parameters[0] : true;
148 | 
149 |         return $this;
150 |     }
151 | 
152 |     /**
153 |      * Dynamically retrieve the value of an attribute.
154 |      *
155 |      * @param  string  $key
156 |      * @return mixed
157 |      */
158 |     public function __get($key)
159 |     {
160 |         return $this->get($key);
161 |     }
162 | 
163 |     /**
164 |      * Dynamically set the value of an attribute.
165 |      *
166 |      * @param  string  $key
167 |      * @param  mixed  $value
168 |      * @return void
169 |      */
170 |     public function __set($key, $value)
171 |     {
172 |         $this->offsetSet($key, $value);
173 |     }
174 | 
175 |     /**
176 |      * Dynamically check if an attribute is set.
177 |      *
178 |      * @param  string  $key
179 |      * @return bool
180 |      */
181 |     public function __isset($key)
182 |     {
183 |         return $this->offsetExists($key);
184 |     }
185 | 
186 |     /**
187 |      * Dynamically unset an attribute.
188 |      *
189 |      * @param  string  $key
190 |      * @return void
191 |      */
192 |     public function __unset($key)
193 |     {
194 |         $this->offsetUnset($key);
195 |     }
196 | }
197 | 


--------------------------------------------------------------------------------
/src/Support/RulesCollector.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Support;
 3 | 
 4 | use Tightenco\Collect\Contracts\Support\Arrayable;
 5 | 
 6 | class RulesCollector implements Arrayable
 7 | {
 8 | 
 9 |     /**
10 |      * Transformation rules
11 |      *
12 |      * @var array
13 |      */
14 |     protected $rules = [];
15 | 
16 |     public function __construct($rules = [])
17 |     {
18 |         if ($rules instanceof Arrayable) {
19 |             $this->setupRules($rules->toArray());
20 |         } elseif (is_array($rules)) {
21 |             $this->setupRules($rules);
22 |         }
23 |     }
24 | 
25 |     /**
26 |      * Store transformation rules
27 |      *
28 |      * @param array $rules
29 |      * @return \Windsor\Support\RulesCollector
30 |      */
31 |     public function setupRules($rules = [])
32 |     {
33 |         $this->rules = apply_filters('acf-windsor/config/rules', $rules);
34 |         return $this;
35 |     }
36 | 
37 |     /**
38 |      * Retrieve transformation rules for given type
39 |      *
40 |      * @param string $key Either 'fields' or 'groups'
41 |      * @return \Tightenco\Collect\Support\Collection|null
42 |      */
43 |     public function get($key)
44 |     {
45 |         if (!isset($this->rules[$key])) {
46 |             return collect();
47 |         }
48 |         return collect($this->rules[$key]);
49 |     }
50 | 
51 |     /**
52 |      * @inheritDoc
53 |      */
54 |     public function toArray()
55 |     {
56 |         return $this->rules;
57 |     }
58 | }
59 | 


--------------------------------------------------------------------------------
/src/Support/Singleton.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | namespace Windsor\Support;
 3 | 
 4 | /**
 5 |  * Singleton trait.
 6 |  *
 7 |  * Allows a simple interface for treating a class as a singleton.
 8 |  * Usage: myObject::instance()
 9 |  *
10 |  * @package october\support
11 |  * @author Alexey Bobkov, Samuel Georges
12 |  */
13 | trait Singleton
14 | {
15 |     protected static $instance;
16 | 
17 |     /**
18 |      * Create a new instance of this singleton.
19 |      */
20 |     final public static function instance()
21 |     {
22 |         return isset(static::$instance)
23 |             ? static::$instance
24 |             : static::$instance = new static;
25 |     }
26 | 
27 |     /**
28 |      * Constructor.
29 |      */
30 |     final protected function __construct()
31 |     {
32 |         $this->init();
33 |     }
34 | 
35 |     /**
36 |      * Initialize the singleton free from constructor parameters.
37 |      */
38 |     protected function init()
39 |     {
40 |     }
41 | 
42 |     public function __clone()
43 |     {
44 |         trigger_error('Cloning '.__CLASS__.' is not allowed.', E_USER_ERROR);
45 |     }
46 | 
47 |     public function __wakeup()
48 |     {
49 |         trigger_error('Unserializing '.__CLASS__.' is not allowed.', E_USER_ERROR);
50 |     }
51 | }
52 | 


--------------------------------------------------------------------------------
/src/config.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | return [
 4 | 
 5 |     /**
 6 |      * You may enable this mode to display ACF keys
 7 |      * next to each field, useful for debugging
 8 |      */
 9 |     'debug' => false,
10 | 
11 |     /**
12 |      * Enable/disable admin interface using boolean value.
13 |      * Optionally receive an array to modify admin pages behaviour
14 |      * - 'enabled' {boolean} Same effect as `'ui' => true`
15 |      * - 'inline_assets' {boolean} Use this to inline admin styles and scripts if path to vendor/ is not public.
16 |      */
17 |     'ui' => false,
18 | 
19 |     /**
20 |      * The path where all ACF fields are stored
21 |      */
22 |     'path' => get_stylesheet_directory() . '/acf-fields',
23 | 
24 |     /**
25 |      * The entry point, listing all registered fields.
26 |      */
27 |     'entry' => 'index.yaml',
28 | 
29 |     /**
30 |      * The parser responsible to translating ACF fields
31 |      * into ACF field groups
32 |      */
33 |     'parser' => \Windsor\Parser\YamlParser::class,
34 | 
35 |     /**
36 |      * List transform rules for each fields and groups
37 |      */
38 |     'rules' => [
39 |         'fields' => [
40 |             \Windsor\Rules\FieldDefaultsRule::class,
41 |             \Windsor\Rules\WrapperShortcuts::class,
42 |             \Windsor\Rules\FieldConditionRule::class,
43 |             \Windsor\Rules\HelperRule::class,
44 |         ],
45 |         'groups' => [
46 |             \Windsor\Rules\GroupLocationRule::class,
47 |         ],
48 |     ]
49 | 
50 | ];
51 | 


--------------------------------------------------------------------------------
/src/helpers.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | if (! function_exists('tap')) {
 3 |     /**
 4 |      * Call the given Closure with the given value then return the value.
 5 |      *
 6 |      * @param  mixed  $value
 7 |      * @param  callable|null  $callback
 8 |      * @return mixed
 9 |      */
10 |     function tap($value, $callback = null)
11 |     {
12 |         $callback($value);
13 |         return $value;
14 |     }
15 | }
16 | 
17 | if (! function_exists('starts_with')) {
18 |     /**
19 |      * Determine if a given string starts with a given substring.
20 |      *
21 |      * @param  string  $haystack
22 |      * @param  string|array  $needles
23 |      * @return bool
24 |      */
25 |     function starts_with($haystack, $needles)
26 |     {
27 |         foreach ((array) $needles as $needle) {
28 |             if ($needle !== '' && substr($haystack, 0, strlen($needle)) === (string) $needle) {
29 |                 return true;
30 |             }
31 |         }
32 | 
33 |         return false;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/tests/BaseTestCase.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | use Mockery as m;
  3 | use PHPUnit\Framework\TestCase;
  4 | use Mockery\Adapter\Phpunit\MockeryPHPUnitIntegration;
  5 | use Tightenco\Collect\Support\Arr;
  6 | use Windsor\Capsule\BlueprintsFactory;
  7 | use Windsor\Parser\Finder;
  8 | use Windsor\Support\Config;
  9 | 
 10 | class BaseTestCase extends TestCase
 11 | {
 12 |     use MockeryPHPUnitIntegration;
 13 | 
 14 |     protected function pluckFirst($manager, $key = null)
 15 |     {
 16 |         $first = $manager->build()->first();
 17 |         if (is_null($key)) {
 18 |             return $first;
 19 |         }
 20 |         return Arr::get($first, $key);
 21 |     }
 22 | 
 23 |     /**
 24 |     * Convenient shortcut to create new Manager instance,
 25 |     * while allowing mocked configurations
 26 |     *
 27 |     * @param array $params
 28 |     * @return \Windsor\Capsule\Manager
 29 |     */
 30 |     protected function makeManager($params = [])
 31 |     {
 32 |         return new \Windsor\Capsule\Manager(
 33 |             (isset($params['config']) ? $params['config'] : $this->mockConfig()),
 34 |             (isset($params['finder']) ? $params['finder'] : new Finder),
 35 |             (isset($params['blueprints']) ? $params['blueprints'] : BlueprintsFactory::instance())
 36 |         );
 37 |     }
 38 | 
 39 |     /**
 40 |     * Convenient way to force finder to only index specific files
 41 |     *
 42 |     * @param array $return
 43 |     * @return object
 44 |     */
 45 |     protected function mockFinderEntry($return)
 46 |     {
 47 |         $finder = m::mock(Finder::class)->makePartial();
 48 |         $finder->shouldReceive('index')
 49 |         ->andReturn($return);
 50 |         return $finder;
 51 |     }
 52 | 
 53 |     /**
 54 |     * Convenient way to force finder to return specific array fields
 55 |     *
 56 |     * @param array $return
 57 |     * @return object
 58 |     */
 59 |     protected function mockFinderFields($return)
 60 |     {
 61 |         $finder = m::mock(Finder::class)->makePartial();
 62 |         $finder
 63 |             ->shouldReceive('index')
 64 |             ->andReturn($return);
 65 |         return $finder;
 66 |     }
 67 | 
 68 |     /**
 69 |     * Creates mocked config
 70 |     *
 71 |     * @param array $params
 72 |     * @return mixed
 73 |     */
 74 |     protected function mockConfig($params = [])
 75 |     {
 76 |         $config = new Config(array_merge(
 77 |             $this->defaultTestConfig(),
 78 |             $params
 79 |         ));
 80 |         return $config;
 81 |     }
 82 | 
 83 |     /**
 84 |     * Get default configuration for testing
 85 |     *
 86 |     * @return array
 87 |     */
 88 |     protected function defaultTestConfig()
 89 |     {
 90 |         return [
 91 |             'path'   => __DIR__ . '/yaml',
 92 |             'entry'  => 'index.yaml',
 93 |             'parser' => \Windsor\Parser\YamlParser::class,
 94 |             'rules' => [
 95 |                 'fields' => [
 96 |                     \Windsor\Rules\FieldDefaultsRule::class,
 97 |                     \Windsor\Rules\WrapperShortcuts::class,
 98 |                     \Windsor\Rules\FieldConditionRule::class,
 99 |                     \Windsor\Rules\HelperRule::class,
100 |                 ],
101 |                 'groups' => [
102 |                     \Windsor\Rules\GroupLocationRule::class,
103 |                 ],
104 |             ]
105 |         ];
106 |     }
107 | }
108 | 


--------------------------------------------------------------------------------
/tests/BlockSimpleTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use Tightenco\Collect\Support\Arr;
 4 | 
 5 | final class BlockSimpleTest extends BaseTestCase
 6 | {
 7 |     public function testSimple()
 8 |     {
 9 |         $manager = $this->getBlockManager('blocks/sample-block.acf.yaml');
10 |         $fieldGroup = $this->pluckFirst($manager, 'parsed.field-group');
11 |         $block = $this->pluckFirst($manager, 'parsed.block');
12 |         $this->assertNull(Arr::get($block, 'fields'));
13 |         $this->assertEquals('acf/myblock', Arr::get($fieldGroup, 'location.0.0.value'));
14 |         $this->assertEquals('block', Arr::get($fieldGroup, 'location.0.0.param'));
15 |         $this->assertEquals('==', Arr::get($fieldGroup, 'location.0.0.operator'));
16 |         $this->assertEquals(1, count(Arr::get($fieldGroup, 'location')));
17 |         $this->assertEquals(1, count(Arr::get($fieldGroup, 'location.0')));
18 |     }
19 | 
20 |     public function testHandler()
21 |     {
22 |         $manager = $this->getBlockManager('blocks/block-with-handler.acf.yaml');
23 |         $block = $this->pluckFirst($manager, 'parsed.block');
24 |         $this->assertTrue(Arr::get($block, 'enqueue_assets.0') instanceof \Windsor\AcfBlock);
25 |         $this->assertEquals('enqueueAssets', Arr::get($block, 'enqueue_assets.1'));
26 |         $this->assertTrue(Arr::get($block, 'render_callback.0') instanceof \Windsor\AcfBlock);
27 |         $this->assertEquals('render', Arr::get($block, 'render_callback.1'));
28 |     }
29 | 
30 |     protected function getBlockManager($name)
31 |     {
32 |         return $this->makeManager([
33 |             'finder' => $this->mockFinderEntry([
34 |                 'blocks' => [$name]
35 |             ])
36 |         ]);
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/tests/BlueprintsTest.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | use Tightenco\Collect\Support\Arr;
  4 | 
  5 | final class BlueprintsTest extends BaseTestCase
  6 | {
  7 |     public function testDefault()
  8 |     {
  9 |         $manager = $this->getBlueprintManager('blueprints/test-default.acf.yaml');
 10 |         $this->assertEquals(
 11 |             [
 12 |                 'type' => 'text',
 13 |                 'label' => 'Heading',
 14 |                 'name' => 'heading',
 15 |                 'key' => '__heading',
 16 |                 'wrapper' => [
 17 |                     'width' => 50
 18 |                 ]
 19 |             ],
 20 |             $this->pluckFirst($manager, 'parsed.fields.0')
 21 |         );
 22 |         $this->assertEquals(
 23 |             '__use_image',
 24 |             $this->pluckFirst($manager, 'parsed.fields.2.conditional_logic.0.0.field')
 25 |         );
 26 |     }
 27 | 
 28 |     public function testExclude()
 29 |     {
 30 |         $manager = $this->getBlueprintManager('blueprints/test-exclude.acf.yaml');
 31 |         $fieldKeys = Arr::pluck($this->pluckFirst($manager, 'parsed.fields'), 'name');
 32 |         $this->assertEquals(
 33 |             ['use_image', 'image'],
 34 |             $fieldKeys
 35 |         );
 36 |     }
 37 | 
 38 |     public function testOnly()
 39 |     {
 40 |         $manager = $this->getBlueprintManager('blueprints/test-only.acf.yaml');
 41 |         $fieldKeys = Arr::pluck($this->pluckFirst($manager, 'parsed.fields'), 'name');
 42 |         $this->assertEquals(
 43 |             ['heading'],
 44 |             $fieldKeys
 45 |         );
 46 |     }
 47 | 
 48 |     public function testLayout()
 49 |     {
 50 |         $manager = $this->getBlueprintManager('blueprints/test-layout.acf.yaml');
 51 |         $fieldKeys = Arr::pluck($this->pluckFirst($manager, 'parsed.fields'), 'name');
 52 |         $fieldWidths = Arr::pluck($this->pluckFirst($manager, 'parsed.fields'), 'wrapper.width');
 53 |         $this->assertEquals(
 54 |             [
 55 |                 'use_image',
 56 |                 'image',
 57 |                 'heading',
 58 |                 'description',
 59 |             ],
 60 |             $fieldKeys
 61 |         );
 62 |         $this->assertEquals(
 63 |             [
 64 |                 50,
 65 |                 50,
 66 |                 40,
 67 |                 60,
 68 |             ],
 69 |             $fieldWidths
 70 |         );
 71 |     }
 72 | 
 73 |     public function testMerge()
 74 |     {
 75 |         $manager = $this->getBlueprintManager('blueprints/test-layout.acf.yaml');
 76 |         $fields = $this->pluckFirst($manager, 'parsed.fields');
 77 |         $count = count($fields);
 78 |         $last = array_pop($fields);
 79 |         $this->assertEquals('description', $last['name']);
 80 |         $this->assertEquals(4, $count);
 81 |     }
 82 | 
 83 |     public function testPrefix()
 84 |     {
 85 |         $manager = $this->getBlueprintManager('blueprints/test-prefix.acf.yaml');
 86 |         $fields = $this->pluckFirst($manager, 'parsed.fields');
 87 |         $this->assertEquals(
 88 |             'Merge Heading',
 89 |             $fields[0]['label']
 90 |         );
 91 |         $this->assertEquals(
 92 |             'merge_prefix_heading',
 93 |             $fields[0]['name']
 94 |         );
 95 |         $this->assertEquals(
 96 |             'Merge Image',
 97 |             $fields[2]['label']
 98 |         );
 99 | 
100 |         $this->assertEquals(
101 |             'merge_prefix_image',
102 |             $fields[2]['name']
103 |         );
104 |         $this->assertEquals(
105 |             '__merge_prefix_use_image',
106 |             $fields[2]['conditional_logic'][0][0]['field']
107 |         );
108 |     }
109 | 
110 |     protected function getBlueprintManager($name)
111 |     {
112 |         return $this->makeManager([
113 |             'finder' => $this->mockFinderEntry([
114 |                 'fields' => [$name],
115 |                 'blueprints' => ['blueprints/my-blueprint.acf.yaml']
116 |             ])
117 |         ]);
118 |     }
119 | }
120 | 


--------------------------------------------------------------------------------
/tests/ChangeInstructionsToFoo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | class ChangeInstructionsToFoo
 3 | {
 4 |     /**
 5 |      * Process this rule
 6 |      *
 7 |      * @param FieldGroup $group
 8 |      * @param string $key
 9 |      * @param array $acf
10 |      * @return array
11 |      */
12 |     public function process($group, $key, array $acf): array
13 |     {
14 |         $acf['instructions'] = 'foo';
15 |         return $acf;
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/tests/CompactRulesTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use Windsor\Admin\Exporter\FieldsPacker;
 4 | 
 5 | final class CompactRulesTest extends BaseTestCase
 6 | {
 7 |     public function testDefaultFieldRule()
 8 |     {
 9 |         $fields = require 'raw/default.php';
10 |         $packer = new FieldsPacker($fields);
11 |         $result = $packer
12 |             ->setMode('compact')
13 |             ->pack();
14 |         $this->assertEquals([
15 |             "key" => "group_acbdefg",
16 |             "title" => "Sample Field",
17 |             "fields" => [
18 |                 "my_new_field" => [
19 |                     "key" => "field_5f0ff95bb56b8",
20 |                     "label" => "My new field",
21 |                     "type" => "text",
22 |                 ]
23 |             ]
24 |         ], $result);
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/tests/ConditionalTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | final class ConditionalTest extends BaseTestCase
 4 | {
 5 |     public function testConditionalPrefix()
 6 |     {
 7 |         $manager = $this->makeManager([
 8 |             'finder' => $this->mockFinderEntry([
 9 |                 'fields' => ['rules/conditional-rules.acf.yaml']
10 |             ])
11 |         ]);
12 |         $this->assertEquals(
13 |             '__toggle',
14 |             $this->pluckFirst($manager, 'parsed.fields.1.conditional_logic.0.0.field')
15 |         );
16 |         $this->assertEquals(
17 |             '__toggle',
18 |             $this->pluckFirst($manager, 'parsed.fields.2.conditional_logic.0.0.field')
19 |         );
20 |     }
21 | 
22 |     public function testConditionalValue()
23 |     {
24 |         $manager = $this->makeManager([
25 |             'finder' => $this->mockFinderEntry([
26 |                 'fields' => ['rules/conditional-rules.acf.yaml']
27 |             ])
28 |         ]);
29 |         $this->assertEquals(
30 |             '1',
31 |             $this->pluckFirst($manager, 'parsed.fields.1.conditional_logic.0.0.value')
32 |         );
33 |         $this->assertNotTrue(
34 |             $this->pluckFirst($manager, 'parsed.fields.1.conditional_logic.0.0.value')
35 |         );
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/tests/DummyHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | class DummyHandler extends \Windsor\AcfBlock
 4 | {
 5 |     public function render()
 6 |     {
 7 |     }
 8 | 
 9 |     public function enqueueAssets()
10 |     {
11 |     }
12 | }
13 | 


--------------------------------------------------------------------------------
/tests/FieldsPackerTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use Windsor\Admin\Exporter\FieldsPacker;
 4 | 
 5 | final class FieldsPackerTest extends BaseTestCase
 6 | {
 7 |     public function testSimpleKey()
 8 |     {
 9 |         $fields = require 'raw/default.php';
10 |         $packer = new FieldsPacker($fields);
11 |         $result = $packer->pack();
12 |         $this->assertTrue(isset($result['fields']['my_new_field']));
13 |     }
14 | 
15 |     public function testGroup()
16 |     {
17 |         $fields = require 'raw/simple-group.php';
18 |         $packer = new FieldsPacker($fields);
19 |         $result = $packer->pack();
20 |         $this->assertTrue(isset($result['fields']['group']));
21 |         $this->assertEquals([
22 |             'my_text', 'my_text_2'
23 |         ], array_keys($result['fields']['group']['sub_fields']));
24 |     }
25 | 
26 |     public function testRepeater()
27 |     {
28 |         $fields = require 'raw/simple-repeater.php';
29 |         $packer = new FieldsPacker($fields);
30 |         $result = $packer->pack();
31 |         $this->assertTrue(isset($result['fields']['repeats']));
32 |         $this->assertEquals([
33 |             'my_text', 'my_textarea'
34 |         ], array_keys($result['fields']['repeats']['sub_fields']));
35 |     }
36 | 
37 |     public function testFlexibleContent()
38 |     {
39 |         $fields = require 'raw/simple-flex-content.php';
40 |         $packer = new FieldsPacker($fields);
41 |         $result = $packer->pack();
42 |         $this->assertTrue(isset($result['fields']['flexible_content']));
43 |         $this->assertEquals([
44 |             'call_to_action', 'slider'
45 |         ], array_keys($result['fields']['flexible_content']['layouts']));
46 |         $this->assertEquals([
47 |             'cta_heading', 'cta_link'
48 |         ], array_keys($result['fields']['flexible_content']['layouts']['call_to_action']['sub_fields']));
49 |     }
50 | 
51 |     public function testConditionRule()
52 |     {
53 |         $fields = require 'raw/simple-conditional.php';
54 |         $packer = new FieldsPacker($fields);
55 |         $result = $packer->pack();
56 |         $this->assertEquals(
57 |             ['field' => '~field_123456', 'operator' => '==', 'value' => '1'],
58 |             $result['fields']['other_field']['conditional_logic'][0][0]
59 |         );
60 |         $nestedGroupFields =  $result['fields']['nested_group']['sub_fields'];
61 |         $this->assertEquals(
62 |             ['field' => '~field_nested_sub_123456', 'operator' => '==', 'value' => '1'],
63 |             $nestedGroupFields['other_field']['conditional_logic'][0][0]
64 |         );
65 |     }
66 | }
67 | 


--------------------------------------------------------------------------------
/tests/KeysTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | final class KeysTest extends BaseTestCase
 4 | {
 5 |     public function testRepeaterKeys()
 6 |     {
 7 |         $manager = $this->makeManager([
 8 |             'finder' => $this->mockFinderEntry([
 9 |                 'fields' => ['keys.acf.yaml']
10 |             ])
11 |         ]);
12 |         $this->assertEquals(
13 |             '__repeat_sub_1',
14 |             $this->pluckFirst($manager, 'parsed.fields.0.sub_fields.0.key')
15 |         );
16 |         $this->assertEquals(
17 |             'sub_1',
18 |             $this->pluckFirst($manager, 'parsed.fields.0.sub_fields.0.name')
19 |         );
20 |         $this->assertEquals(
21 |             '__repeat_sub_2_repeat_sub_sub_1',
22 |             $this->pluckFirst($manager, 'parsed.fields.0.sub_fields.1.sub_fields.0.key')
23 |         );
24 |     }
25 | 
26 |     public function testFlexKeys()
27 |     {
28 |         $manager = $this->makeManager([
29 |             'finder' => $this->mockFinderEntry([
30 |                 'fields' => ['keys.acf.yaml']
31 |             ])
32 |         ]);
33 |         $this->assertEquals(
34 |             '__flex_layout_1',
35 |             $this->pluckFirst($manager, 'parsed.fields.1.layouts.0.key')
36 |         );
37 |         $this->assertEquals(
38 |             '__flex_layout_1_layout_sub_1',
39 |             $this->pluckFirst($manager, 'parsed.fields.1.layouts.0.sub_fields.0.key')
40 |         );
41 |     }
42 | 
43 |     public function testStaticKeys()
44 |     {
45 |         $manager = $this->makeManager([
46 |             'finder' => $this->mockFinderEntry([
47 |                 'fields' => ['keys-static.acf.yaml']
48 |             ])
49 |         ]);
50 |         $this->assertEquals(
51 |             'flex_1',
52 |             $this->pluckFirst($manager, 'parsed.fields.1.layouts.0.key')
53 |         );
54 |         $this->assertEquals(
55 |             'flex_1_sub_1',
56 |             $this->pluckFirst($manager, 'parsed.fields.1.layouts.0.sub_fields.0.key')
57 |         );
58 |     }
59 | }
60 | 


--------------------------------------------------------------------------------
/tests/MutableFieldTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use Windsor\Admin\Exporter\MutableField;
 4 | 
 5 | final class MutableFieldTest extends BaseTestCase
 6 | {
 7 |     public function testShiftToLast()
 8 |     {
 9 |         $field = new MutableField([
10 |             'shouldBeLast' => 'foo',
11 |             'other' => 'bar',
12 |         ]);
13 |         $field->shiftToLast('shouldBeLast');
14 |         $result = $field->toArray();
15 |         $last = array_pop($result);
16 |         $this->assertEquals('foo', $last);
17 |     }
18 | 
19 |     public function testWhenTrue()
20 |     {
21 |         $field = new MutableField([
22 |             'foo' => 'bar',
23 |         ]);
24 |         $field->when(true, function ($field) {
25 |             $field['foo'] = 'bar2';
26 |         });
27 |         $this->assertEquals(['foo' => 'bar2'], $field->toArray());
28 |     }
29 | 
30 |     public function testWhenFalse()
31 |     {
32 |         $field = new MutableField([
33 |             'foo' => 'bar',
34 |         ]);
35 |         $field->when(false, function ($field) {
36 |             $field['foo'] = 'bar2';
37 |         });
38 |         $this->assertEquals(['foo' => 'bar'], $field->toArray());
39 |     }
40 | 
41 |     public function testModifyMutable()
42 |     {
43 |         $field = new MutableField([
44 |             'foo' => [
45 |                 'bar' => 'alpha'
46 |             ],
47 |         ]);
48 |         $field->modifyAsMutable('foo', function ($sub) {
49 |             $this->assertTrue($sub instanceof MutableField);
50 |             $sub['bar'] = 'omega';
51 |             return $sub;
52 |         });
53 |         $this->assertEquals('omega', $field->toArray()['foo']['bar']);
54 |         $field->modifyAsMutable(function ($sub) {
55 |             $sub['baz'] = 'baz2';
56 |             return $sub;
57 |         });
58 |         $this->assertEquals('baz2', $field->toArray()['baz']);
59 |     }
60 | 
61 |     public function testModify()
62 |     {
63 |         $field = new MutableField([
64 |             'foo' => [
65 |                 'bar' => 'alpha'
66 |             ],
67 |         ]);
68 |         $field->modifyAsMutable('foo', function ($sub) {
69 |             $sub['bar'] = 'omega';
70 |             return $sub;
71 |         });
72 |         $this->assertEquals('omega', $field->toArray()['foo']['bar']);
73 |         $field->modifyAsMutable(function ($sub) {
74 |             $sub['baz'] = 'baz2';
75 |             return $sub;
76 |         });
77 |         $this->assertEquals('baz2', $field->toArray()['baz']);
78 |     }
79 | }
80 | 


--------------------------------------------------------------------------------
/tests/RulesTest.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | use Windsor\Support\Config;
  4 | 
  5 | final class RulesTest extends BaseTestCase
  6 | {
  7 |     public function testDefaultRules()
  8 |     {
  9 |         $manager = $this->makeManager([
 10 |             'finder' => $this->mockFinderEntry([
 11 |                 'fields' => ['rules/default-rules.acf.yaml']
 12 |             ])
 13 |         ]);
 14 |         $this->assertEquals([
 15 |             [
 16 |                 'key' => '__field_1',
 17 |                 'name' => 'field_1',
 18 |                 'label' => 'Field 1',
 19 |                 'type' => 'text',
 20 |             ],
 21 |             [
 22 |                 'key' => '__field_2',
 23 |                 'name' => 'field_2',
 24 |                 'label' => 'Field 2',
 25 |                 'type' => 'text',
 26 |                 'instructions' => 'My instructions'
 27 |             ]
 28 |         ], $this->pluckFirst($manager, 'parsed.fields'));
 29 |     }
 30 | 
 31 |     public function testHiddenLocation()
 32 |     {
 33 |         $manager = $this->makeManager([
 34 |             'finder' => $this->mockFinderEntry([
 35 |                 'fields' => ['rules/default-rules.acf.yaml']
 36 |             ])
 37 |         ]);
 38 |         $this->assertEquals(
 39 |             (new \Windsor\Rules\GroupLocationRule)->getHiddenLocationRule(),
 40 |             $this->pluckFirst($manager, 'parsed.location')
 41 |         );
 42 |     }
 43 | 
 44 |     public function testHelper()
 45 |     {
 46 |         $manager = $this->makeManager([
 47 |             'config' => $this->mockConfig(['debug' => true]),
 48 |             'finder' => $this->mockFinderEntry([
 49 |                 'fields' => ['rules/helper-rules.acf.yaml']
 50 |             ])
 51 |         ]);
 52 |         $helper = new \Windsor\Rules\HelperRule;
 53 |         $this->assertEquals(
 54 |             $helper->getDebugHtml('field_1'),
 55 |             $this->pluckFirst($manager, 'parsed.fields.0.instructions')
 56 |         );
 57 |         $this->assertEquals(
 58 |             'My sample instructions' . $helper->getDebugHtml('field_2'),
 59 |             $this->pluckFirst($manager, 'parsed.fields.1.instructions')
 60 |         );
 61 |     }
 62 | 
 63 |     public function testWrapperShortcuts()
 64 |     {
 65 |         $manager = $this->makeManager([
 66 |             'finder' => $this->mockFinderEntry([
 67 |                 'fields' => ['rules/wrapper-rules.acf.yaml']
 68 |             ])
 69 |         ]);
 70 |         $this->assertEquals(
 71 |             [
 72 |                 'width' => 300,
 73 |                 'class' => 'my-css',
 74 |                 'id' => 'myUniqueId',
 75 |             ],
 76 |             $this->pluckFirst($manager, 'parsed.fields.0.wrapper')
 77 |         );
 78 |     }
 79 | 
 80 |     public function testCustomRules()
 81 |     {
 82 |         $manager = $this->makeManager([
 83 |             'finder' => $this->mockFinderEntry([
 84 |                 'fields' => ['sample-field.acf.yaml']
 85 |             ]),
 86 |             'config' => $this->mockConfig([
 87 |                 'rules' => [
 88 |                     'fields' => [
 89 |                         ChangeInstructionsToFoo::class
 90 |                     ]
 91 |                 ]
 92 |             ])
 93 |         ]);
 94 |         $this->assertEquals(
 95 |             'foo',
 96 |             $this->pluckFirst($manager, 'parsed.fields.0.instructions')
 97 |         );
 98 |         $this->assertEquals(
 99 |             'foo',
100 |             $this->pluckFirst($manager, 'parsed.fields.1.instructions')
101 |         );
102 |     }
103 | }
104 | 


--------------------------------------------------------------------------------
/tests/SetupTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use Tightenco\Collect\Support\Arr;
 4 | 
 5 | final class SetupTest extends BaseTestCase
 6 | {
 7 |     public function testManageMake()
 8 |     {
 9 |         $instance = Windsor\Capsule\Manager::make();
10 |         $this->assertTrue($instance instanceof Windsor\Capsule\Manager);
11 |     }
12 | 
13 |     public function testReadSimpleYaml()
14 |     {
15 |         $manager = $this->makeManager([
16 |             'finder' => $this->mockFinderEntry([
17 |                 'pages' => ['simple.acf.yaml']
18 |             ])
19 |         ]);
20 |         $this->assertEquals([
21 |             'title'    => 'Simple Field Group',
22 |             'key'      => 'simple_field_group',
23 |             'location' => (new \Windsor\Rules\GroupLocationRule)
24 |                 ->getHiddenLocationRule(),
25 |             'fields' => [
26 |                 [
27 |                     'type'  => 'text',
28 |                     'label' => 'Heading',
29 |                     'name'  => 'heading',
30 |                     'key'   => 'simple_field_group_heading'
31 |                 ]
32 |             ]
33 |         ], Arr::get($manager->build()->first(), 'parsed'));
34 |     }
35 | 
36 |     public function testSubEntry()
37 |     {
38 |         $manager = $this->makeManager([
39 |             'config' => $this->mockConfig([
40 |                 'path' => __DIR__ . '/yaml/sub',
41 |             ])
42 |         ]);
43 | 
44 |         $this->assertEquals([
45 |             'title'    => 'Simple Field Group',
46 |             'key'      => 'simple_field_group',
47 |             'location' => (new \Windsor\Rules\GroupLocationRule)->getHiddenLocationRule(),
48 |             'fields' => [
49 |                 [
50 |                     'type'  => 'text',
51 |                     'label' => 'Heading',
52 |                     'name'  => 'heading',
53 |                     'key'   => 'simple_field_group_heading'
54 |                 ]
55 |             ]
56 |         ], Arr::get($manager->build()->first(), 'parsed'));
57 |     }
58 | }
59 | 


--------------------------------------------------------------------------------
/tests/bootstrap.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | require "BaseTestCase.php";
  4 | require "ChangeInstructionsToFoo.php";
  5 | require "DummyHandler.php";
  6 | 
  7 | /**
  8 |  * Stub WordPress functions used by Windsor
  9 |  */
 10 | if (! function_exists('apply_filters')) {
 11 |     /**
 12 |      * Stub WordPress `apply_filters`
 13 |      */
 14 |     function apply_filters($filter, $argument)
 15 |     {
 16 |         return $argument;
 17 |     }
 18 | }
 19 | 
 20 | if (! function_exists('get_stylesheet_directory')) {
 21 |     /**
 22 |      * Stub WordPress `get_stylesheet_directory`
 23 |      */
 24 |     function get_stylesheet_directory()
 25 |     {
 26 |         return __DIR__ . '/yaml';
 27 |     }
 28 | }
 29 | 
 30 | if (! function_exists('sanitize_title_with_dashes')) {
 31 |     /**
 32 |      * Sanitizes a title, replacing whitespace and a few other characters with dashes.
 33 |      *
 34 |      * @param string $title
 35 |      * @param string $raw_title
 36 |      * @param string $context
 37 |      * @return string
 38 |      */
 39 |     function sanitize_title_with_dashes($title, $raw_title = '', $context = 'display')
 40 |     {
 41 |         $title = strip_tags($title);
 42 |         // Preserve escaped octets.
 43 |         $title = preg_replace('|%([a-fA-F0-9][a-fA-F0-9])|', '---$1---', $title);
 44 |         // Remove percent signs that are not part of an octet.
 45 |         $title = str_replace('%', '', $title);
 46 |         // Restore octets.
 47 |         $title = preg_replace('|---([a-fA-F0-9][a-fA-F0-9])---|', '%$1', $title);
 48 | 
 49 |         if (seems_utf8($title)) {
 50 |             if (function_exists('mb_strtolower')) {
 51 |                 $title = mb_strtolower($title, 'UTF-8');
 52 |             }
 53 |             $title = utf8_uri_encode($title, 200);
 54 |         }
 55 | 
 56 |         $title = strtolower($title);
 57 | 
 58 |         if ('save' == $context) {
 59 |             // Convert &nbsp, &ndash, and &mdash to hyphens.
 60 |             $title = str_replace(array( '%c2%a0', '%e2%80%93', '%e2%80%94' ), '-', $title);
 61 |             // Convert &nbsp, &ndash, and &mdash HTML entities to hyphens.
 62 |             $title = str_replace(array( '&nbsp;', '&#160;', '&ndash;', '&#8211;', '&mdash;', '&#8212;' ), '-', $title);
 63 |             // Convert forward slash to hyphen.
 64 |             $title = str_replace('/', '-', $title);
 65 | 
 66 |             // Strip these characters entirely.
 67 |             $title = str_replace(
 68 |                 array(
 69 |                 // Soft hyphens.
 70 |                 '%c2%ad',
 71 |                 // &iexcl and &iquest.
 72 |                 '%c2%a1',
 73 |                 '%c2%bf',
 74 |                 // Angle quotes.
 75 |                 '%c2%ab',
 76 |                 '%c2%bb',
 77 |                 '%e2%80%b9',
 78 |                 '%e2%80%ba',
 79 |                 // Curly quotes.
 80 |                 '%e2%80%98',
 81 |                 '%e2%80%99',
 82 |                 '%e2%80%9c',
 83 |                 '%e2%80%9d',
 84 |                 '%e2%80%9a',
 85 |                 '%e2%80%9b',
 86 |                 '%e2%80%9e',
 87 |                 '%e2%80%9f',
 88 |                 // &copy, &reg, &deg, &hellip, and &trade.
 89 |                 '%c2%a9',
 90 |                 '%c2%ae',
 91 |                 '%c2%b0',
 92 |                 '%e2%80%a6',
 93 |                 '%e2%84%a2',
 94 |                 // Acute accents.
 95 |                 '%c2%b4',
 96 |                 '%cb%8a',
 97 |                 '%cc%81',
 98 |                 '%cd%81',
 99 |                 // Grave accent, macron, caron.
100 |                 '%cc%80',
101 |                 '%cc%84',
102 |                 '%cc%8c',
103 |             ),
104 |                 '',
105 |                 $title
106 |             );
107 | 
108 |             // Convert &times to 'x'.
109 |             $title = str_replace('%c3%97', 'x', $title);
110 |         }
111 | 
112 |         // Kill entities.
113 |         $title = preg_replace('/&.+?;/', '', $title);
114 |         $title = str_replace('.', '-', $title);
115 | 
116 |         $title = preg_replace('/[^%a-z0-9 _-]/', '', $title);
117 |         $title = preg_replace('/\s+/', '-', $title);
118 |         $title = preg_replace('|-+|', '-', $title);
119 |         $title = trim($title, '-');
120 | 
121 |         return $title;
122 |     }
123 | }
124 | 


--------------------------------------------------------------------------------
/tests/raw/default.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | return [
 3 |     'key' => 'group_acbdefg',
 4 |     'title' => 'Sample Field',
 5 |     'fields' => [
 6 |         [
 7 |             'key' => 'field_5f0ff95bb56b8',
 8 |             'label' => 'My new field',
 9 |             'name' => 'my_new_field',
10 |             'type' => 'text',
11 |             'instructions' => '',
12 |             'required' => 0,
13 |             'conditional_logic' => 0,
14 |             'wrapper' => [
15 |                 'width' => '',
16 |                 'class' => '',
17 |                 'id' => '',
18 |             ],
19 |             'default_value' => '',
20 |             'placeholder' => '',
21 |             'prepend' => '',
22 |             'append' => '',
23 |             'maxlength' => '',
24 |         ]
25 |     ]
26 | ];
27 | 


--------------------------------------------------------------------------------
/tests/raw/simple-conditional.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | return [
  3 |     'key' => 'group_acbdefg',
  4 |     'title' => 'Sample Field',
  5 |     'fields' => [
  6 |         array(
  7 |             'key' => 'field_123456',
  8 |             'label' => 'Show Other Field',
  9 |             'name' => 'show_other_field',
 10 |             'type' => 'true_false',
 11 |             'instructions' => '',
 12 |             'required' => 0,
 13 |             'conditional_logic' => 0,
 14 |             'wrapper' => array(
 15 |                 'width' => '30',
 16 |                 'class' => '',
 17 |                 'id' => '',
 18 |             ),
 19 |             'message' => '',
 20 |             'default_value' => 0,
 21 |             'ui' => 0,
 22 |             'ui_on_text' => '',
 23 |             'ui_off_text' => '',
 24 |         ),
 25 |         array(
 26 |             'key' => 'field_654321',
 27 |             'label' => 'Other Field',
 28 |             'name' => 'other_field',
 29 |             'type' => 'text',
 30 |             'instructions' => '',
 31 |             'required' => 0,
 32 |             'wrapper' => array(
 33 |                 'width' => '60',
 34 |                 'class' => '',
 35 |                 'id' => '',
 36 |             ),
 37 |             'default_value' => '',
 38 |             'placeholder' => '',
 39 |             'prepend' => '',
 40 |             'append' => '',
 41 |             'maxlength' => '',
 42 |             'conditional_logic' => array(
 43 |                 array(
 44 |                     array(
 45 |                         'field' => 'field_123456',
 46 |                         'operator' => '==',
 47 |                         'value' => '1',
 48 |                     ),
 49 |                 ),
 50 |             ),
 51 |         ),
 52 |         array(
 53 |             'key' => 'field_nested_12345',
 54 |             'label' => 'Nested Group',
 55 |             'name' => 'nested_group',
 56 |             'type' => 'group',
 57 |             'instructions' => '',
 58 |             'required' => 0,
 59 |             'conditional_logic' => 0,
 60 |             'wrapper' => array(
 61 |                 'width' => '',
 62 |                 'class' => '',
 63 |                 'id' => '',
 64 |             ),
 65 |             'layout' => 'block',
 66 |             'sub_fields' => array(
 67 |                 array(
 68 |                     'key' => 'field_nested_sub_123456',
 69 |                     'label' => 'Show Other Field',
 70 |                     'name' => 'show_other_field',
 71 |                     'type' => 'true_false',
 72 |                     'instructions' => '',
 73 |                     'required' => 0,
 74 |                     'conditional_logic' => 0,
 75 |                     'wrapper' => array(
 76 |                         'width' => '30',
 77 |                         'class' => '',
 78 |                         'id' => '',
 79 |                     ),
 80 |                     'message' => '',
 81 |                     'default_value' => 0,
 82 |                     'ui' => 0,
 83 |                     'ui_on_text' => '',
 84 |                     'ui_off_text' => '',
 85 |                 ),
 86 |                 array(
 87 |                     'key' => 'field_nested_sub_654321',
 88 |                     'label' => 'Other Field',
 89 |                     'name' => 'other_field',
 90 |                     'type' => 'text',
 91 |                     'instructions' => '',
 92 |                     'required' => 0,
 93 |                     'wrapper' => array(
 94 |                         'width' => '60',
 95 |                         'class' => '',
 96 |                         'id' => '',
 97 |                     ),
 98 |                     'default_value' => '',
 99 |                     'placeholder' => '',
100 |                     'prepend' => '',
101 |                     'append' => '',
102 |                     'maxlength' => '',
103 |                     'conditional_logic' => array(
104 |                         array(
105 |                             array(
106 |                                 'field' => 'field_nested_sub_123456',
107 |                                 'operator' => '==',
108 |                                 'value' => '1',
109 |                             ),
110 |                         ),
111 |                     ),
112 |                 ),
113 |             )
114 |         )
115 |     ]
116 | ];
117 | 


--------------------------------------------------------------------------------
/tests/raw/simple-flex-content.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | return [
  3 |     'key' => 'group_acbdefg',
  4 |     'title' => 'Sample Field',
  5 |     'fields' => [
  6 |         [
  7 |             'key' => 'field_5f1bec5775a4d',
  8 |             'label' => 'Flexible Content',
  9 |             'name' => 'flexible_content',
 10 |             'type' => 'flexible_content',
 11 |             'instructions' => '',
 12 |             'required' => 0,
 13 |             'conditional_logic' => 0,
 14 |             'wrapper' => array(
 15 |                 'width' => '',
 16 |                 'class' => '',
 17 |                 'id' => '',
 18 |             ),
 19 |             'layouts' => array(
 20 |                 'layout_5f1bec603b6fe' => array(
 21 |                     'key' => 'layout_5f1bec603b6fe',
 22 |                     'name' => 'call_to_action',
 23 |                     'label' => 'Call to Action',
 24 |                     'display' => 'block',
 25 |                     'sub_fields' => array(
 26 |                         array(
 27 |                             'key' => 'field_5f1bec6c75a4e',
 28 |                             'label' => 'CTA Heading',
 29 |                             'name' => 'cta_heading',
 30 |                             'type' => 'text',
 31 |                             'instructions' => '',
 32 |                             'required' => 0,
 33 |                             'conditional_logic' => 0,
 34 |                             'wrapper' => array(
 35 |                                 'width' => '',
 36 |                                 'class' => '',
 37 |                                 'id' => '',
 38 |                             ),
 39 |                             'default_value' => '',
 40 |                             'placeholder' => '',
 41 |                             'prepend' => '',
 42 |                             'append' => '',
 43 |                             'maxlength' => '',
 44 |                         ),
 45 |                         array(
 46 |                             'key' => 'field_5f1bec7575a4f',
 47 |                             'label' => 'CTA Link',
 48 |                             'name' => 'cta_link',
 49 |                             'type' => 'link',
 50 |                             'instructions' => '',
 51 |                             'required' => 0,
 52 |                             'conditional_logic' => 0,
 53 |                             'wrapper' => array(
 54 |                                 'width' => '',
 55 |                                 'class' => '',
 56 |                                 'id' => '',
 57 |                             ),
 58 |                             'return_format' => 'array',
 59 |                         ),
 60 |                     ),
 61 |                     'min' => '',
 62 |                     'max' => '',
 63 |                 ),
 64 |                 'layout_5f1bec7e75a50' => array(
 65 |                     'key' => 'layout_5f1bec7e75a50',
 66 |                     'name' => 'slider',
 67 |                     'label' => 'Slider',
 68 |                     'display' => 'block',
 69 |                     'sub_fields' => array(
 70 |                         array(
 71 |                             'key' => 'field_5f1bec8275a51',
 72 |                             'label' => 'Slider Items',
 73 |                             'name' => 'slider_items',
 74 |                             'type' => 'repeater',
 75 |                             'instructions' => '',
 76 |                             'required' => 0,
 77 |                             'conditional_logic' => 0,
 78 |                             'wrapper' => array(
 79 |                                 'width' => '',
 80 |                                 'class' => '',
 81 |                                 'id' => '',
 82 |                             ),
 83 |                             'collapsed' => '',
 84 |                             'min' => 0,
 85 |                             'max' => 0,
 86 |                             'layout' => 'table',
 87 |                             'button_label' => '',
 88 |                             'sub_fields' => array(
 89 |                                 array(
 90 |                                     'key' => 'field_5f1bec8975a52',
 91 |                                     'label' => 'Slider Heading',
 92 |                                     'name' => 'slider_heading',
 93 |                                     'type' => 'text',
 94 |                                     'instructions' => '',
 95 |                                     'required' => 0,
 96 |                                     'conditional_logic' => 0,
 97 |                                     'wrapper' => array(
 98 |                                         'width' => '',
 99 |                                         'class' => '',
100 |                                         'id' => '',
101 |                                     ),
102 |                                     'default_value' => '',
103 |                                     'placeholder' => '',
104 |                                     'prepend' => '',
105 |                                     'append' => '',
106 |                                     'maxlength' => '',
107 |                                 ),
108 |                                 array(
109 |                                     'key' => 'field_5f1bec9475a53',
110 |                                     'label' => 'Slider Image',
111 |                                     'name' => 'slider_image',
112 |                                     'type' => 'image',
113 |                                     'instructions' => '',
114 |                                     'required' => 0,
115 |                                     'conditional_logic' => 0,
116 |                                     'wrapper' => array(
117 |                                         'width' => '',
118 |                                         'class' => '',
119 |                                         'id' => '',
120 |                                     ),
121 |                                     'return_format' => 'array',
122 |                                     'preview_size' => 'medium',
123 |                                     'library' => 'all',
124 |                                     'min_width' => '',
125 |                                     'min_height' => '',
126 |                                     'min_size' => '',
127 |                                     'max_width' => '',
128 |                                     'max_height' => '',
129 |                                     'max_size' => '',
130 |                                     'mime_types' => '',
131 |                                 ),
132 |                             ),
133 |                         ),
134 |                     ),
135 |                     'min' => '',
136 |                     'max' => '',
137 |                 ),
138 |             ),
139 |             'button_label' => 'Add Row',
140 |             'min' => '',
141 |             'max' => '',
142 |         ]
143 |     ]
144 | ];
145 | 


--------------------------------------------------------------------------------
/tests/raw/simple-group.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | return [
 3 |     'key' => 'group_acbdefg',
 4 |     'title' => 'Sample Field',
 5 |     'fields' => [
 6 |         [
 7 |             'key' => 'field_group',
 8 |             'label' => 'Group',
 9 |             'name' => 'group',
10 |             'type' => 'group',
11 |             'instructions' => '',
12 |             'required' => 0,
13 |             'conditional_logic' => 0,
14 |             'wrapper' => array(
15 |                 'width' => '',
16 |                 'class' => '',
17 |                 'id' => '',
18 |             ),
19 |             'layout' => 'block',
20 |             'sub_fields' => array(
21 |                 array(
22 |                     'key' => 'field_group_text',
23 |                     'label' => 'My Text',
24 |                     'name' => 'my_text',
25 |                     'type' => 'text',
26 |                     'instructions' => '',
27 |                     'required' => 0,
28 |                     'conditional_logic' => 0,
29 |                     'wrapper' => array(
30 |                         'width' => '',
31 |                         'class' => '',
32 |                         'id' => '',
33 |                     ),
34 |                     'default_value' => '',
35 |                     'placeholder' => '',
36 |                     'prepend' => '',
37 |                     'append' => '',
38 |                     'maxlength' => '',
39 |                 ),
40 |                 array(
41 |                     'key' => 'field_group_text_2',
42 |                     'label' => 'My Text 2',
43 |                     'name' => 'my_text_2',
44 |                     'type' => 'text',
45 |                     'instructions' => '',
46 |                     'required' => 0,
47 |                     'conditional_logic' => 0,
48 |                     'wrapper' => array(
49 |                         'width' => '',
50 |                         'class' => '',
51 |                         'id' => '',
52 |                     ),
53 |                     'default_value' => '',
54 |                     'placeholder' => '',
55 |                     'prepend' => '',
56 |                     'append' => '',
57 |                     'maxlength' => '',
58 |                 ),
59 |             )
60 |         ]
61 |     ]
62 | ];
63 | 


--------------------------------------------------------------------------------
/tests/raw/simple-repeater.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | return [
 3 |     'key' => 'group_acbdefg',
 4 |     'title' => 'Sample Field',
 5 |     'fields' => [
 6 |         [
 7 |             'key' => 'field_5f0ff963b56b9',
 8 |             'label' => 'Repeat',
 9 |             'name' => 'repeats',
10 |             'type' => 'repeater',
11 |             'instructions' => '',
12 |             'required' => 0,
13 |             'conditional_logic' => 0,
14 |             'wrapper' => array(
15 |                 'width' => '',
16 |                 'class' => '',
17 |                 'id' => '',
18 |             ),
19 |             'collapsed' => '',
20 |             'min' => 0,
21 |             'max' => 0,
22 |             'layout' => 'table',
23 |             'button_label' => '',
24 |             'sub_fields' => array(
25 |                 array(
26 |                     'key' => 'repeat_sub_1',
27 |                     'label' => 'My Text',
28 |                     'name' => 'my_text',
29 |                     'type' => 'text',
30 |                     'instructions' => '',
31 |                     'required' => 0,
32 |                     'conditional_logic' => 0,
33 |                     'wrapper' => array(
34 |                         'width' => '',
35 |                         'class' => '',
36 |                         'id' => '',
37 |                     ),
38 |                     'default_value' => '',
39 |                     'placeholder' => '',
40 |                     'prepend' => '',
41 |                     'append' => '',
42 |                     'maxlength' => '',
43 |                 ),
44 |                 array(
45 |                     'key' => 'repeat_sub_2',
46 |                     'label' => 'My Textarea',
47 |                     'name' => 'my_textarea',
48 |                     'type' => 'textarea',
49 |                     'instructions' => '',
50 |                     'required' => 0,
51 |                     'conditional_logic' => 0,
52 |                     'wrapper' => array(
53 |                         'width' => '',
54 |                         'class' => '',
55 |                         'id' => '',
56 |                     ),
57 |                     'default_value' => '',
58 |                     'placeholder' => '',
59 |                     'maxlength' => '',
60 |                     'rows' => '',
61 |                     'new_lines' => '',
62 |                 ),
63 |             ),
64 |         ]
65 |     ]
66 | ];
67 | 


--------------------------------------------------------------------------------
/tests/yaml/blocks/block-with-handler.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'Sample Block with Handler'
 2 | key: 'myblock'
 3 | description: 'My sample block'
 4 | category:
 5 |   - common
 6 | icon: 'book-alt'
 7 | keywords: 'quote'
 8 | mode: 'auto'
 9 | handler: 'DummyHandler'
10 | supports:
11 |   align: true
12 |   mode: true
13 |   multiple: true
14 | fields:
15 |   field_text:
16 |     type: text
17 |     label: Field Text
18 |   field_textarea:
19 |     label: Field Textarea
20 |     type: 'textarea'
21 |     new_lines: 'br'
22 |     rows: 4
23 | 
24 | 


--------------------------------------------------------------------------------
/tests/yaml/blocks/sample-block.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'Sample Block'
 2 | key: 'myblock'
 3 | description: 'My sample block'
 4 | category:
 5 |   - common
 6 | icon: 'book-alt'
 7 | keywords: 'quote'
 8 | mode: 'auto'
 9 | render_template: template-parts/blocks/testimonial/testimonial.php
10 | supports:
11 |   align: true
12 |   mode: true
13 |   multiple: true
14 | fields:
15 |   field_text:
16 |     type: text
17 |     label: Field Text
18 |   field_textarea:
19 |     label: Field Textarea
20 |     type: 'textarea'
21 |     new_lines: 'br'
22 |     rows: 4
23 | 
24 | 


--------------------------------------------------------------------------------
/tests/yaml/blueprints/my-blueprint.acf.yaml:
--------------------------------------------------------------------------------
 1 | fields:
 2 |   heading:
 3 |       type: text
 4 |       label: Heading
 5 |       wrapper_width: 50
 6 |   use_image:
 7 |       label: Use Image
 8 |       type: "true_false"
 9 |       ui: true
10 |       default: true
11 |       wrapper_width: 50
12 |   image:
13 |     label: Image
14 |     type: "image"
15 |     preview_size: 'large'
16 |     max_size: 5 # in MB
17 |     max_width: 2000 # in px
18 |     max_height: 2000 # in px
19 |     conditional_logic:
20 |       -
21 |         -
22 |           field: use_image
23 |           operator: '=='
24 |           value: true
25 | 
26 | 


--------------------------------------------------------------------------------
/tests/yaml/blueprints/test-default.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Field Group'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location:
 6 |     -
 7 |         -
 8 |             param: 'post_type'
 9 |             operator: '=='
10 |             value: 'post'
11 | fields:
12 |     merge_default:
13 |         type: blueprint
14 |         label: Merge Default
15 |         source: "my-blueprint"
16 | 


--------------------------------------------------------------------------------
/tests/yaml/blueprints/test-exclude.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Field Group'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location:
 6 |     -
 7 |         -
 8 |             param: 'post_type'
 9 |             operator: '=='
10 |             value: 'post'
11 | fields:
12 |     merge_exclude_some:
13 |         type: blueprint
14 |         label: Merge Exclude Some
15 |         source: "my-blueprint"
16 |         excludes:
17 |           - 'heading'
18 | 


--------------------------------------------------------------------------------
/tests/yaml/blueprints/test-layout.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Field Group'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location:
 6 |     -
 7 |         -
 8 |             param: 'post_type'
 9 |             operator: '=='
10 |             value: 'post'
11 | fields:
12 |     merge_layout:
13 |         type: blueprint
14 |         label: Merge Layout
15 |         source: "my-blueprint"
16 |         merge:
17 |           description:
18 |             type: 'textarea'
19 |             label: 'Description'
20 |         layout:
21 |           - use_image@50
22 |           - image@50
23 |           - heading@40
24 |           - description@60
25 | 


--------------------------------------------------------------------------------
/tests/yaml/blueprints/test-merge.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Field Group'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location:
 6 |     -
 7 |         -
 8 |             param: 'post_type'
 9 |             operator: '=='
10 |             value: 'post'
11 | fields:
12 |     merge_additional:
13 |         type: blueprint
14 |         label: Merge Additional Fields
15 |         source: "my-blueprint"
16 |         merge:
17 |           description:
18 |             type: 'textarea'
19 |             label: 'Description'
20 | 


--------------------------------------------------------------------------------
/tests/yaml/blueprints/test-only.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Field Group'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location:
 6 |     -
 7 |         -
 8 |             param: 'post_type'
 9 |             operator: '=='
10 |             value: 'post'
11 | fields:
12 |     merge_only_some:
13 |         type: blueprint
14 |         label: Merge Only Some
15 |         source: "my-blueprint"
16 |         only:
17 |           - 'heading'
18 | 


--------------------------------------------------------------------------------
/tests/yaml/blueprints/test-prefix.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Field Group'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location:
 6 |     -
 7 |         -
 8 |             param: 'post_type'
 9 |             operator: '=='
10 |             value: 'post'
11 | fields:
12 |     merge_prefix:
13 |         type: blueprint
14 |         label: Merge
15 |         source: "my-blueprint"
16 |         prefix: true
17 |         prefix_label: true
18 | 


--------------------------------------------------------------------------------
/tests/yaml/clones.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Sample Field'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location: null
 6 | fields:
 7 |   # Test setting default 'type'
 8 |   base:
 9 |     label: Base Field
10 |     type: "group"
11 |     layout: "block"
12 |     sub_fields:
13 |       field_1:
14 |         type: text
15 |         label: Field 1
16 |   clone_seamless:
17 |     label: Clone
18 |     type: "clone"
19 |     display: "seamless"
20 |     prefix_label: false
21 |     prefix_name: false
22 |     clone:
23 |       - "base_field_1"
24 |   clone_group:
25 |     label: Clone
26 |     type: "clone"
27 |     display: group
28 |     prefix_label: false
29 |     prefix_name: false
30 |     clone:
31 |       - "base_field_1"
32 | 


--------------------------------------------------------------------------------
/tests/yaml/index-empty.yaml:
--------------------------------------------------------------------------------
1 | fields: []
2 | pages: []
3 | 


--------------------------------------------------------------------------------
/tests/yaml/index.yaml:
--------------------------------------------------------------------------------
1 | fields:
2 |   - sample-field.acf.yaml
3 | pages:
4 |   - sample-page.acf.yaml
5 |   - sample-post.acf.yaml
6 | 


--------------------------------------------------------------------------------
/tests/yaml/keys-static.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Sample Field'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location: null
 6 | fields:
 7 |   repeat:
 8 |     label: Repeat
 9 |     type: "repeater"
10 |     layout: "block"
11 |     key: field_repeat
12 |     sub_fields:
13 |       sub_1:
14 |         type: text
15 |         label: Sub 1
16 |         key: field_sub_1
17 |       sub_2_repeat:
18 |         label: Sub 2 Repeat
19 |         type: "repeater"
20 |         layout: "block"
21 |         key: field_sub_2
22 |         sub_fields:
23 |           sub_sub_1:
24 |             type: text
25 |             key: field_sub_2_1
26 |             label: Sub Sub 1
27 |   flex:
28 |     label: Flex
29 |     type: "flexible_content"
30 |     button_label: "Add Row"
31 |     min: 0
32 |     max: 0
33 |     key: field_flex
34 |     layouts:
35 |       layout_1:
36 |         display: 'block'
37 |         label: 'Layout 1'
38 |         key: flex_1
39 |         sub_fields:
40 |           layout_sub_1:
41 |             type: 'text'
42 |             label: 'My Field'
43 |             key: flex_1_sub_1
44 |       layout_2:
45 |         display: 'block'
46 |         label: 'Layout 2'
47 |         key: flex_2
48 |         sub_fields:
49 |           layout_sub_1:
50 |             type: 'text'
51 |             label: 'My Field'
52 |             key: flex_2_sub_1
53 | 


--------------------------------------------------------------------------------
/tests/yaml/keys.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Sample Field'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location: null
 6 | fields:
 7 |   # Test setting default 'type'
 8 |   repeat:
 9 |     label: Repeat
10 |     type: "repeater"
11 |     layout: "block"
12 |     sub_fields:
13 |       sub_1:
14 |         type: text
15 |         label: Sub 1
16 |       sub_2_repeat:
17 |         label: Sub 2 Repeat
18 |         type: "repeater"
19 |         layout: "block"
20 |         sub_fields:
21 |           sub_sub_1:
22 |             type: text
23 |             label: Sub Sub 1
24 |   flex:
25 |     label: Flex
26 |     type: "flexible_content"
27 |     button_label: "Add Row"
28 |     min: 0
29 |     max: 0
30 |     layouts:
31 |       layout_1:
32 |         display: 'block'
33 |         label: 'Layout 1'
34 |         sub_fields:
35 |           layout_sub_1:
36 |             type: 'text'
37 |             label: 'My Field'
38 |       layout_2:
39 |         display: 'block'
40 |         label: 'Layout 2'
41 |         sub_fields:
42 |           layout_sub_1:
43 |             type: 'text'
44 |             label: 'My Field'
45 | 


--------------------------------------------------------------------------------
/tests/yaml/rules/conditional-rules.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Sample Field'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location: null
 6 | fields:
 7 |     # Test setting default 'type'
 8 |     toggle:
 9 |         label: Toggle
10 |         type: "true_false"
11 |         ui: true
12 |         default: true
13 |     heading:
14 |         type: text
15 |         label: Heading
16 |         conditional_logic:
17 |             -
18 |                 -
19 |                     field: toggle
20 |                     operator: '=='
21 |                     value: true
22 |     heading_2:
23 |         type: text
24 |         label: Heading 2
25 |         conditional_logic:
26 |             -
27 |                 -
28 |                     field: ~__toggle
29 |                     operator: '=='
30 |                     value: true
31 | 


--------------------------------------------------------------------------------
/tests/yaml/rules/default-rules.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Sample Field'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location: null
 6 | fields:
 7 |   # Test setting default 'type'
 8 |   field_1:
 9 |     label: Field 1
10 |   field_2:
11 |     label: Field 2
12 |     type: 'text'
13 |     # Test typo resistance
14 |     instruction: "My instructions"
15 | 
16 | 


--------------------------------------------------------------------------------
/tests/yaml/rules/helper-rules.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Sample Field'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location: null
 6 | fields:
 7 |   # Test setting default 'type'
 8 |   field_1:
 9 |     label: Field 1
10 |   field_2:
11 |     label: Field 2
12 |     instructions: "My sample instructions"
13 | 
14 | 


--------------------------------------------------------------------------------
/tests/yaml/rules/wrapper-rules.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Sample Field'
 2 | key: '_'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location: null
 6 | fields:
 7 |   # Test setting default 'type'
 8 |   field_1:
 9 |     label: Field 1
10 |     wrapper_width: 300
11 |     wrapper_class: 'my-css'
12 |     wrapper_id: 'myUniqueId'
13 | 
14 | 


--------------------------------------------------------------------------------
/tests/yaml/sample-field.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'My Sample Field'
 2 | key: 'my_sample_field'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location: null
 6 | fields:
 7 |   banner_heading:
 8 |     type: text
 9 |     label: Banner Heading
10 |   banner_image:
11 |     label: Banner Image
12 |     type: "image"
13 |     preview_size: 'large'
14 |     max_size: 5 # in MB
15 |     max_width: 2000 # in px
16 |     max_height: 2000 # in px
17 | 


--------------------------------------------------------------------------------
/tests/yaml/sample-page.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'Page Default'
 2 | key: 'page_default'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location:
 6 |   -
 7 |     -
 8 |       param: 'page_template'
 9 |       operator: '=='
10 |       value: 'default'
11 | fields:
12 |   heading:
13 |     type: text
14 |     label: Heading
15 | 


--------------------------------------------------------------------------------
/tests/yaml/sample-post.acf.yaml:
--------------------------------------------------------------------------------
 1 | title: 'Blog Post'
 2 | key: 'blog_post'
 3 | position: 'acf_after_title'
 4 | hide_on_screen: []
 5 | location:
 6 |   -
 7 |     -
 8 |       param: post_type
 9 |       operator: '=='
10 |       value: post
11 | fields: []
12 | 


--------------------------------------------------------------------------------
/tests/yaml/simple.acf.yaml:
--------------------------------------------------------------------------------
1 | title: 'Simple Field Group'
2 | key: 'simple_field_group'
3 | location: null
4 | fields:
5 |   heading:
6 |     type: text
7 |     label: Heading
8 | 


--------------------------------------------------------------------------------
/tests/yaml/sub/fields/empty-field.acf.yaml:
--------------------------------------------------------------------------------
1 | title: 'Simple Field Group'
2 | key: 'simple_field_group'
3 | location: null
4 | fields:
5 |   heading:
6 |     type: text
7 |     label: Heading
8 | 


--------------------------------------------------------------------------------
/tests/yaml/sub/index.yaml:
--------------------------------------------------------------------------------
1 | fields:
2 |   - fields/empty-field.acf.yaml
3 | pages: []
4 | 


--------------------------------------------------------------------------------