@airfleet/generator-init 0.30.0 → 0.32.0

package/generators/project-plugin/templates/assets/frontend/styles/root/_fonts.scss

@@ -0,0 +1,21 @@
+@import '../../../shared/styles/lib';
+
+// Declare font-faces here.
+// Use https://transfonter.org/ to convert fonts to other formats.
+
+// ! Instead of hard-coding the font path, use the variable below like this:
+// url($font-src + 'FontName.woff')
+
+$font-src: '/assets/frontend/fonts';
+
+// ! EXAMPLE
+// @font-face {
+//   font-family: 'Roboto Condensed';
+//   src: local('Roboto Condensed Italic'), local('RobotoCondensed-Italic'),
+//     url($font-src + '/RobotoCondensed-Italic.woff2') format('woff2'),
+//     url($font-src + '/RobotoCondensed-Italic.woff') format('woff'),
+//     url($font-src + '/RobotoCondensed-Italic.ttf') format('truetype');
+//   font-weight: normal;
+//   font-style: italic;
+//   font-display: swap;
+// }

package/generators/project-plugin/templates/assets/shared/styles/_figma-variables.scss

@@ -0,0 +1,7 @@
+/**
+ * * Generated by @airfleet/figma-bridge
+ * * !!! Do not edit directly
+ */
+
+:root {
+}

package/generators/project-plugin/templates/assets/shared/styles/_lib.scss

@@ -0,0 +1,4 @@
+// ! Import here all the variables, mixins, functions
+// ! i.e. everything that does not output CSS by default
+@import 'lib/scss-variables';
+@import 'lib/mixins';

package/generators/project-plugin/templates/assets/shared/styles/_root.scss

@@ -0,0 +1,6 @@
+@import 'lib';
+@import 'figma-variables';
+
+:root {
+  // Add root styles here
+}

package/generators/project-plugin/templates/assets/shared/styles/_shared.scss

@@ -0,0 +1 @@
+// Add shared styles here

package/generators/project-plugin/templates/assets/shared/styles/lib/_mixins.scss

@@ -0,0 +1,6 @@
+@import 'mixins/body';
+@import 'mixins/breakpoints';
+@import 'mixins/list-inline';
+@import 'mixins/position';
+@import 'mixins/background';
+@import 'mixins/helpers';

package/generators/project-plugin/templates/assets/shared/styles/lib/_scss-variables.scss

@@ -0,0 +1,2 @@
+// ? Add variables here
+// ! Do not add CSS variables here, only SCSS. Add CSS variables in `_root.scss`

package/generators/project-plugin/templates/assets/shared/styles/lib/mixins/_background.scss

@@ -0,0 +1,11 @@
+/**
+ *
+ * Background
+ *
+ */
+
+@mixin background($size: cover, $position: center, $repeat: no-repeat) {
+  background-position: $position;
+  background-repeat: $repeat;
+  background-size: $size;
+}

package/generators/project-plugin/templates/assets/shared/styles/lib/mixins/_body.scss

@@ -0,0 +1,4 @@
+// ! Body styles. The reason we do a separate mixin is to help us override styles in the block editor
+@mixin theme-body-styles {
+  // Add styles here
+}

package/generators/project-plugin/templates/assets/shared/styles/lib/mixins/_breakpoints.scss

@@ -0,0 +1,79 @@
+@mixin tablet-up {
+  @media (width >= 768px) {
+    @content;
+  }
+}
+
+@mixin laptop-up {
+  @media (width >= 1280px) {
+    @content;
+  }
+}
+
+@mixin desktop-up {
+  @media (width >= 1920px) {
+    @content;
+  }
+}
+
+/**
+ *
+ * Desktop First
+ *
+ */
+
+@mixin desktop-down {
+  @media (width < 1920px) {
+    @content;
+  }
+}
+
+@mixin laptop-down {
+  @media (width < 1280px) {
+    @content;
+  }
+}
+
+@mixin tablet-down {
+  @media (width < 768px) {
+    @content;
+  }
+}
+
+/**
+ *
+ * Specific Resolution Breakpoints
+ *
+ */
+
+@mixin tablet-only() {
+  @media (width >= 768px) and (width < 1280px) {
+    @content;
+  }
+}
+
+@mixin laptop-only() {
+  @media (width >= 1280px) and (width < 1920px) {
+    @content;
+  }
+}
+
+/**
+ *
+ * WordPress Breakpoints
+ *
+ */
+
+// mobile with admin bar
+@mixin admin-bar-mobile {
+  @media (width < 600px) {
+    @content;
+  }
+}
+
+// tablet with admin bar
+@mixin admin-bar-tablet {
+  @media (width < 782px) {
+    @content;
+  }
+}

package/generators/project-plugin/templates/assets/shared/styles/lib/mixins/_helpers.scss

@@ -0,0 +1,35 @@
+// Center flex children
+@mixin afu-flex-center {
+  align-items: center;
+  display: flex;
+  justify-content: center;
+}
+
+// Center block element horizontally
+@mixin afu-center-block($w) {
+  margin-inline: auto;
+  max-width: $w;
+}
+
+// Create columns with even vertical spacing
+@mixin afu-vertical-gap($gap: 20px) {
+  display: flex;
+  flex-direction: column;
+  gap: $gap;
+}
+
+// Set an image element to object fit
+@mixin afu-image-size($type: cover) {
+  height: 100%;
+  object-fit: $type;
+  width: 100%;
+}
+
+// Truncate text to specific lines
+@mixin afu-truncate-text-lines($lines) {
+  -webkit-box-orient: vertical;
+  display: -webkit-box;
+  -webkit-line-clamp: $lines;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}

package/generators/project-plugin/templates/assets/shared/styles/lib/mixins/_list-inline.scss

@@ -0,0 +1,23 @@
+@mixin list-inline($li-margin-right: 0.5rem) {
+  padding-left: 0;
+  list-style: none;
+
+  li {
+    display: inline-block;
+
+    &:not(:last-child) {
+      margin-right: $li-margin-right;
+    }
+  }
+}
+
+// Set elements in row with gap
+// Better use this than just list-inline
+@mixin afu-list-inline-flex($gap) {
+  padding-left: 0;
+  list-style: none;
+  align-items: center;
+  display: flex;
+  flex-wrap: wrap;
+  gap: $gap;
+}

package/generators/project-plugin/templates/assets/shared/styles/lib/mixins/_position.scss

@@ -0,0 +1,24 @@
+@mixin position-fill($position: absolute) {
+  height: 100%;
+  left: 0;
+  position: $position;
+  top: 0;
+  width: 100%;
+}
+
+// Position the element absolutely centered.
+@mixin position-absolute-center() {
+  left: 50%;
+  position: absolute;
+  top: 50%;
+  transform: translateX(-50%) translateY(-50%);
+}
+
+// Similar to Bootstrap's fixed top, but with optional position.
+@mixin position-top($position, $zindex: 1030) {
+  left: 0;
+  position: $position;
+  right: 0;
+  top: 0;
+  z-index: $zindex;
+}

package/generators/project-plugin/templates/composer-scoped.json.ejs

@@ -0,0 +1,8 @@
+{
+  "require": {
+    "airfleet/wordpress-framework": "^1.5.0"
+  },
+  "config": {
+    "autoloader-suffix": "<%= name.pascal %>"
+  }
+}

package/generators/project-plugin/templates/composer-scoped.lock.ejs

@@ -0,0 +1,124 @@
+{
+    "_readme": [
+        "This file locks the dependencies of your project to a known state",
+        "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
+        "This file is @generated automatically"
+    ],
+    "content-hash": "9c5f20589b695e0465c3e3f17445638a",
+    "packages": [
+        {
+            "name": "airfleet/wordpress-framework",
+            "version": "1.5.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/airfleet/airfleet-wordpress-framework-php.git",
+                "reference": "5847995d05980b5215458b8cacd74d223a5e0d8b"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/airfleet/airfleet-wordpress-framework-php/zipball/5847995d05980b5215458b8cacd74d223a5e0d8b",
+                "reference": "5847995d05980b5215458b8cacd74d223a5e0d8b",
+                "shasum": ""
+            },
+            "require": {
+                "jawira/case-converter": "^3.5",
+                "php": ">=8.0"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "Airfleet\\Framework\\": "inc/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "authors": [
+                {
+                    "name": "Airfleet",
+                    "email": "dev@airfleet.co"
+                }
+            ],
+            "description": "Airfleet framework for WordPress",
+            "support": {
+                "issues": "https://github.com/airfleet/airfleet-wordpress-framework-php/issues",
+                "source": "https://github.com/airfleet/airfleet-wordpress-framework-php/tree/1.5.0"
+            },
+            "time": "2024-05-28T17:03:25+00:00"
+        },
+        {
+            "name": "jawira/case-converter",
+            "version": "v3.5.1",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/jawira/case-converter.git",
+                "reference": "2be05b98dcb743bef60ab6f849145bd3434ed003"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/jawira/case-converter/zipball/2be05b98dcb743bef60ab6f849145bd3434ed003",
+                "reference": "2be05b98dcb743bef60ab6f849145bd3434ed003",
+                "shasum": ""
+            },
+            "require": {
+                "ext-mbstring": "*",
+                "php": ">=7.4"
+            },
+            "require-dev": {
+                "behat/behat": "^3.0",
+                "phpstan/phpstan": "^1.0",
+                "phpunit/phpunit": "^9.0",
+                "vimeo/psalm": "^4.0"
+            },
+            "suggest": {
+                "pds/skeleton": "PHP Package Development Standards",
+                "phing/phing": "PHP Build Tool"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "Jawira\\CaseConverter\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Jawira Portugal",
+                    "email": "dev@tugal.be"
+                }
+            ],
+            "description": "Convert strings between 13 naming conventions: Snake case, Camel case, Pascal case, Kebab case, Ada case, Train case, Cobol case, Macro case, Upper case, Lower case, Sentence case, Title case and Dot notation.",
+            "homepage": "https://jawira.github.io/case-converter/",
+            "keywords": [
+                "Ada case",
+                "Cobol case",
+                "Macro case",
+                "Train case",
+                "camel case",
+                "dot notation",
+                "kebab case",
+                "lower case",
+                "pascal case",
+                "sentence case",
+                "snake case",
+                "title case",
+                "upper case"
+            ],
+            "support": {
+                "issues": "https://github.com/jawira/case-converter/issues",
+                "source": "https://github.com/jawira/case-converter/tree/v3.5.1"
+            },
+            "time": "2022-08-14T11:40:18+00:00"
+        }
+    ],
+    "packages-dev": [],
+    "aliases": [],
+    "minimum-stability": "stable",
+    "stability-flags": [],
+    "prefer-stable": false,
+    "prefer-lowest": false,
+    "platform": [],
+    "platform-dev": [],
+    "plugin-api-version": "2.6.0"
+}

package/generators/project-plugin/templates/composer.json.ejs

@@ -0,0 +1,52 @@
+{
+  "name": "airfleet/<%= name.slug %>",
+  "type": "wordpress-plugin",
+  "authors": [
+    {
+      "name": "Airfleet",
+      "email": "dev@airfleet.co"
+    }
+  ],
+  "require": {
+    "php": "<%- answers.pluginPhpVersion %>",
+    "composer/installers": "^2.2.0"
+  },
+  "require-dev": {
+    "airfleet/wordpress-dev": "^3.2.0",
+    "wpify/scoper": "2.5.4"
+  },
+  "autoload": {
+    "psr-4": {
+      "Airfleet\\Plugins\\<%= nameNoAirfleet.pascal %>\\": "inc/"
+    }
+  },
+  "scripts": {
+    "lint": "phpcs",
+    "fix": "phpcbf",
+    "install-codestandards": [
+      "Dealerdirect\\Composer\\Plugin\\Installers\\PHPCodeSniffer\\Plugin::run"
+    ],
+    "post-install-cmd": [
+      "@install-codestandards"
+    ]
+  },
+  "config": {
+    "allow-plugins": {
+      "composer/installers": true,
+      "dealerdirect/phpcodesniffer-composer-installer": true,
+      "wpify/scoper": true
+    }
+  },
+  "extra": {
+    "wpify-scoper": {
+      "prefix": "Airfleet\\Plugins\\<%= nameNoAirfleet.pascal %>\\Vendor",
+      "folder": "vendor-scoped",
+      "globals": [
+        "wordpress"
+      ],
+      "composerjson": "composer-scoped.json",
+      "composerlock": "composer-scoped.lock"
+    }
+  },
+  "minimum-stability": "dev"
+}

package/generators/project-plugin/templates/figma/design-tokens/manifest.json

@@ -0,0 +1,5 @@
+{
+  "name": "Design Tokens",
+  "collections": {},
+  "styles": {}
+}

package/generators/project-plugin/templates/gitignore

@@ -0,0 +1,15 @@
+node_modules
+coverage
+.npmrc
+vendor
+dist
+.parcel-cache
+.eslintcache
+.stylelintcache
+.phpcscache
+.composer-cache
+.env
+vendor-scoped
+wp-content
+.DS_Store
+.idea

package/generators/project-plugin/templates/inc/Features/Menus.php.ejs

@@ -0,0 +1,22 @@
+<?php
+
+namespace Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Features;
+
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Vendor\Airfleet\Framework\Features\Feature;
+
+class Menus implements Feature {
+	public function initialize(): void {
+		add_action(
+			'after_setup_theme',
+			function () {
+				register_nav_menus(
+					[
+						'main-menu' => __( 'Main Menu', 'airfleet' ),
+                        'footer-menu' => __( 'Footer Menu', 'airfleet' ),
+                        'privacy-menu' => __( 'Privacy Menu', 'airfleet' ),
+                    ]
+                );
+            }
+        );
+    }
+}

package/generators/project-plugin/templates/inc/Setup/AjaxVariables.php.ejs

@@ -0,0 +1,22 @@
+<?php
+
+namespace Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Setup;
+
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Vendor\Airfleet\Framework\Assets\FrontendVariables;
+
+class AjaxVariables extends FrontendVariables {
+	public function __construct() {
+		parent::__construct(
+			[
+				'slug' => \<%= name.constant %>_SLUG,
+				'name' => '_<%= name.camel %>',
+				'variables' => function (): array {
+					return [
+						'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+						'ajaxNonce' => wp_create_nonce( '<%= name.camel %>Nonce' ),
+					];
+				},
+			]
+		);
+	}
+}

package/generators/project-plugin/templates/inc/Setup/AjaxVariablesAdmin.php.ejs

@@ -0,0 +1,22 @@
+<?php
+
+namespace Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Setup;
+
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Vendor\Airfleet\Framework\Assets\AdminVariables;
+
+class AjaxVariablesAdmin extends AdminVariables {
+	public function __construct() {
+		parent::__construct(
+			[
+				'slug' => \<%= name.constant %>_SLUG,
+				'name' => '_<%= name.camel %>',
+				'variables' => function (): array {
+					return [
+						'ajaxUrl' => admin_url( 'admin-ajax.php' ),
+						'ajaxNonce' => wp_create_nonce( '<%= name.camel %>Nonce' ),
+					];
+				},
+			]
+		);
+	}
+}

package/generators/project-plugin/templates/inc/Setup/Breakpoints.php.ejs

@@ -0,0 +1,18 @@
+<?php
+
+namespace Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Setup;
+
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Vendor\Airfleet\Framework\Features\Feature;
+
+class Breakpoints implements Feature {
+	public function initialize(): void {
+		add_filter(
+			'airfleet/elements/breakpoints',
+			function ( $breakpoints ): array {
+				// ? Customize breakpoints. See https://www.notion.so/codersclan/Breakpoints-filter-40496c68b30543c3ae78bfcbe5193f4b
+				// ! If you update this, you should also update mixins/_breakpoints.scss
+				return $breakpoints;
+			}
+		);
+	}
+}

package/generators/project-plugin/templates/inc/Setup/Colors.php.ejs

@@ -0,0 +1,17 @@
+<?php
+
+namespace Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Setup;
+
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Vendor\Airfleet\Framework\Features\Feature;
+
+class Colors implements Feature {
+	public function initialize(): void {
+		add_filter(
+			'airfleet/elements/colors',
+			function ( $colors ): array {
+				// ? Customize colors. See https://www.notion.so/codersclan/Colors-filter-5f5ed8f4b8f647fdb76bd8494fe5a217
+				return $colors;
+			}
+		);
+	}
+}

package/generators/project-plugin/templates/inc/Setup/RegisterViews.php.ejs

@@ -0,0 +1,64 @@
+<?php
+
+namespace Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Setup;
+
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Vendor\Airfleet\Framework\Features\BasePluginFeature;
+
+class RegisterViews extends BasePluginFeature {
+	public function initialize(): void {
+		add_filter(
+			'airfleet/views/config',
+			function ( array $views ): array {
+			    // Views
+				$views[] = [
+					'namespace' => 'Airfleet\\Plugins\\<%= nameNoAirfleet.pascal %>\\Views',
+					'path' => \<%= name.constant %>_PATH . DIRECTORY_SEPARATOR . 'views',
+					'version' => \<%= name.constant %>_VERSION,
+					'url' => \<%= name.constant %>_URL . '/views',
+					'source' => \<%= name.constant %>_SLUG,
+					'prefix' => '',
+					'priority' => 99,
+                    'enqueue' => false,
+				];
+
+                // Register dist folder for compiled assets
+				$views[] = [
+					'namespace' => 'Airfleet\\Plugins\\<%= nameNoAirfleet.pascal %>\\Views',
+					'path' => \<%= name.constant %>_PATH . DIRECTORY_SEPARATOR . 'dist' . DIRECTORY_SEPARATOR . 'views',
+					'version' => \<%= name.constant %>_VERSION,
+					'url' => \<%= name.constant %>_URL . '/dist/views',
+					'source' => \<%= name.constant %>_SLUG,
+					'prefix' => '',
+					'priority' => 99,
+                    'enqueue_only' => true,
+				];
+
+                // Views Elements
+                $views[] = [
+                    'namespace' => 'Airfleet\\Plugins\\<%= nameNoAirfleet.pascal %>\\ViewsElements',
+                    'path' => \<%= name.constant %>_PATH . DIRECTORY_SEPARATOR . 'views-elements',
+                    'version' => \<%= name.constant %>_VERSION,
+                    'url' => \<%= name.constant %>_URL . '/views-elements',
+                    'source' => \<%= name.constant %>_SLUG,
+                    'prefix' => 'elements',
+                    'priority' => 99,
+                    'enqueue' => false,
+                ];
+
+                // Register dist folder for compiled assets
+                $views[] = [
+                    'namespace' => 'Airfleet\\Plugins\\<%= nameNoAirfleet.pascal %>\\ViewsElements',
+                    'path' => \<%= name.constant %>_PATH . DIRECTORY_SEPARATOR . 'dist' . DIRECTORY_SEPARATOR . 'views-elements',
+                    'version' => \<%= name.constant %>_VERSION,
+                    'url' => \<%= name.constant %>_URL . '/dist/views-elements',
+                    'source' => \<%= name.constant %>_SLUG,
+                    'prefix' => 'elements',
+                    'priority' => 99,
+                    'enqueue_only' => true,
+                ];
+
+				return $views;
+			}
+		);
+	}
+}

package/generators/project-plugin/templates/inc/Setup.php.ejs

@@ -0,0 +1,30 @@
+<?php
+
+namespace Airfleet\Plugins\<%= nameNoAirfleet.pascal %>;
+
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Features\Menus;
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Setup\AjaxVariables;
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Setup\AjaxVariablesAdmin;
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Setup\Breakpoints;
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Setup\Colors;
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Setup\RegisterViews;
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Vendor\Airfleet\Framework\Acf\LocalJsonCategorized;
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Vendor\Airfleet\Framework\Assets\Enqueue;
+use Airfleet\Plugins\<%= nameNoAirfleet.pascal %>\Vendor\Airfleet\Framework\Features\Features;
+
+class Setup extends Features {
+	public function __construct( array $config ) {
+		parent::__construct(
+			[
+				new LocalJsonCategorized( $config['path'] . 'acf-json' ),
+				new Enqueue( $config ),
+				new AjaxVariables(),
+				new AjaxVariablesAdmin(),
+				new RegisterViews(),
+				new Breakpoints(),
+				new Colors(),
+				new Menus(),
+			]
+		);
+	}
+}

package/generators/project-plugin/templates/index.php

@@ -0,0 +1 @@
+<?php // Silence is golden