wpengine · colinmurphy · Jul 3, 2025 · Jul 3, 2025 · Jul 3, 2025
@@ -0,0 +1,36 @@
+/.devcontainer
+/.git
+/.github
+/.idea
+/.log
+/.vscode
+/.wordpress-org
+/bin
+/docker
+/docker-output
+/docs
+/img
+/phpstan
+/plugin-build
+/tests
+
+.coveralls.yml
+.distignore
+.dockerignore
+.DS_Store
+.env
+.env.dist
+.gitattributes
+.gitignore
+.phpcs.xml
+.phpcs.xml.dist
+.travis.yml
+CHANGELOG.md
+codeception.dist.yml
+codeception.yml
+composer.json
+composer.lock
+docker-compose.yml
+phpstan.neon.dist
+README.md
+schema.graphql
@@ -0,0 +1,83 @@
+###############################################################################
+# Pre-configured WordPress Installation w/ WPGraphQL Velocity Plugin
+# For testing only, use in production not recommended. #
+###############################################################################
+
+# Use build args to get the right wordpress + php image
+ARG WP_VERSION
+ARG PHP_VERSION
+
+FROM wordpress:${WP_VERSION:-6.8}-php${PHP_VERSION:-8.2}
+
+# Needed to specify the build args again after the FROM command.
+ARG WP_VERSION
+ARG PHP_VERSION
+
+# Save the build args for use by the runtime environment
+ENV WP_VERSION=${WP_VERSION}
+ENV PHP_VERSION=${PHP_VERSION}
+
+SHELL [ "/bin/bash", "-c" ]
+
+# Install required packages
+RUN apt-get update && \
+    apt-get -y install \
+    git \
+    ssh \
+    tar \
+    gzip \
+    mariadb-client \
+    net-tools
+
+# Needed for Codeception WPDB test integration.
+RUN docker-php-ext-install pdo pdo_mysql
+
+# Install XDebug 3
+RUN if [[ $PHP_VERSION == 7* ]]; then pecl install xdebug-3.1.5; else pecl install xdebug; fi \
+    && mkdir -p /usr/local/etc/php/conf.d/disabled \
+    && echo "zend_extension=xdebug" > /usr/local/etc/php/conf.d/disabled/docker-php-ext-xdebug.ini \
+    && echo "xdebug.mode=develop,debug,coverage" >> /usr/local/etc/php/conf.d/disabled/docker-php-ext-xdebug.ini \
+    && echo "xdebug.start_with_request=yes" >> /usr/local/etc/php/conf.d/disabled/docker-php-ext-xdebug.ini \
+    && echo "xdebug.client_host=host.docker.internal" >> /usr/local/etc/php/conf.d/disabled/docker-php-ext-xdebug.ini \
+    && echo "xdebug.client_port=9003" >> /usr/local/etc/php/conf.d/disabled/docker-php-ext-xdebug.ini \
+    && echo "xdebug.max_nesting_level=512" >> /usr/local/etc/php/conf.d/disabled/docker-php-ext-xdebug.ini \
+    ;
+
+# Set xdebug configuration off by default. Set USING_XDEBUG=1 in the runtime environment to enable it.
+ENV USING_XDEBUG=0
+
+# Install PCOV
+# This is needed for Codeception / PHPUnit to track code coverage
+RUN apt-get install zip unzip -y \
+    && pecl install pcov
+
+# Install Dockerize
+ENV DOCKERIZE_VERSION=v0.7.0
+RUN curl -L -O https://github.com/jwilder/dockerize/releases/download/$DOCKERIZE_VERSION/dockerize-linux-amd64-$DOCKERIZE_VERSION.tar.gz \
+    && tar -C /usr/local/bin -xzvf dockerize-linux-amd64-$DOCKERIZE_VERSION.tar.gz \
+    && rm dockerize-linux-amd64-$DOCKERIZE_VERSION.tar.gz
+
+# Install composer
+COPY --from=composer:latest /usr/bin/composer /usr/local/bin/composer
+RUN chmod +x /usr/local/bin/composer
+
+# Install WP-CLI
+RUN curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar \
+    && chmod +x wp-cli.phar \
+    && mv wp-cli.phar /usr/local/bin/wp
+
+# Install nvm, Node.js, and npm
+ENV NVM_DIR=/usr/local/nvm
+ENV NODE_VERSION=20
+
+RUN mkdir -p $NVM_DIR
+RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash \
+    && . $NVM_DIR/nvm.sh \
+    && nvm install $NODE_VERSION \
+    && nvm use $NODE_VERSION \
+    && nvm alias default $NODE_VERSION \
+    && npm install -g npm
+
+# Setup the container for testing
+COPY init-docker.sh /usr/local/bin/
+RUN chmod +x /usr/local/bin/init-docker.sh
@@ -0,0 +1,26 @@
+#!/bin/bash
+
+# Exit if any command fails.
+set -e
+
+# Wait for the database
+dockerize -wait tcp://"${WORDPRESS_DB_HOST}":3306 -timeout 1m
+
+# Get the current user
+
+cd "$WORDPRESS_ROOT_DIR/wp-content/plugins/$PLUGIN_SLUG"
+
+# Load NVM
+source $NVM_DIR/nvm.sh
+nvm use $NODE_VERSION
+
+# Setup the test environment
+chmod +x ./bin/install-test-env.sh
+
+bash -c "./bin/install-test-env.sh"
+
+echo "Setting permissions"
+chmod -R 777 "$WORDPRESS_ROOT_DIR/wp-content/plugins/$PLUGIN_SLUG"
+
+# Go back to the root directory
+cd "$WORDPRESS_ROOT_DIR"
@@ -0,0 +1,18 @@
+# This file is for unifying the coding style for different editors and IDEs
+# editorconfig.org
+
+# WordPress Coding Standards
+# https://make.wordpress.org/core/handbook/coding-standards/
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = tab
+
+
+[*.md]
+trim_trailing_whitespace = false
@@ -0,0 +1,65 @@
+PLUGIN_SLUG=wpgraphql-velocity
+
+# Configure these to match your existing testing environment or the one you want to create with Docker.
+## Usually, these values should match the ones in the `wp-config.php` file.
+## If using Local by Flywheel, you can `open AdminerEvo` and find the values in the URL: `http://localhost:{DB_PORT}/?username={DB_USER}&db={DB_NAME}`
+## NOTE: Codeception may modify or the database during testing. If you want to preserve your local data, create a new database and use that for the `DB_NAME`.
+DB_NAME=wordpress
+# localhost creates issues with wp config create command
+DB_HOST=127.0.0.1
+DB_USER=root
+DB_PASSWORD=password
+DB_PORT=3306
+
+# The local path to the WordPress root directory, the one containing the wp-load.php file.
+## This can be a relative path from the directory that contains the codeception.yml file, or an absolute path.
+## If you are using Local by Flywheel, you can find the path in the Local by Flywheel app under the site's settings.
+WORDPRESS_ROOT_DIR="/tmp/wordpress"
+
+# This table prefix used by the WordPress site, and in Acceptance tests.
+WORDPRESS_TABLE_PREFIX=wp_
+
+# The URL and domain of the WordPress site, and in Acceptance tests.
+## If the port is in use, you can change it to a different port.
+WORDPRESS_URL=http://localhost
+WORDPRESS_DOMAIN=localhost
+WORDPRESS_ADMIN_PATH=/wp-admin
+
+# The username and password of the administrator user of the WordPress site, and in Acceptance tests.
+WORDPRESS_ADMIN_USER=admin
+WORDPRESS_ADMIN_PASSWORD=password
+WORDPRESS_ADMIN_EMAIL=admin@example.com
+
+# Tests will require a MySQL database to run.
+# Do not use a database that contains important data!
+WORDPRESS_DB_HOST=${DB_HOST}
+WORDPRESS_DB_USER=${DB_USER}
+WORDPRESS_DB_PASSWORD=${DB_PASSWORD}
+WORDPRESS_DB_NAME=${DB_NAME}
+WORDPRESS_DB_PORT=${DB_PORT}
+
+# WPUnit tests will use these variables instead.
+# By default this is the same as WordPress
+TEST_DB_HOST=${WORDPRESS_DB_HOST}
+TEST_DB_USER=${WORDPRESS_DB_USER}
+TEST_DB_PASSWORD=${WORDPRESS_DB_PASSWORD}
+TEST_DB_NAME=${WORDPRESS_DB_NAME}
+TEST_DB_PORT=${WORDPRESS_DB_PORT}
+# The Integration suite will use this table prefix for the WordPress tables.
+TEST_TABLE_PREFIX=test_
+
+# The DSN used by Acceptance tests.
+TEST_DB_DSN="mysql:host=${TEST_DB_HOST};port=${TEST_DB_PORT};dbname=${TEST_DB_NAME}"
+
+# The following variables are used to determine test behavior.
+
+# Include 3rd party plugins (e.g. WooCommerce) in the tests.
+INCLUDE_EXTENSIONS=true
+# Skips recreating the database before running the tests.
+SKIP_DB_CREATE=false
+# Skips configuring the WordPress installation
+SKIP_WP_SETUP=false
+# Skips cleanup after the test suite run.
+SKIP_TESTS_CLEANUP=true
+# The default Codeception suite to run.
+SUITES=wpunit
@@ -0,0 +1,57 @@
+# Hidden files
+.DS_Store
+Thumbs.db
+
+# IDE Files
+.devcontainer/*
+.devcontainer.json
+.vscode
+.idea
+
+# Environment variables for testing
+.env
+.env.*
+!.env.dist
+
+# Ruleset Overrides
+phpcs.xml
+phpunit.xml
+phpstan.neon
+
+# Directory to generate the dist zipfile
+plugin-build
+
+# Composer auth
+auth.json
+
+# Composer deps
+vendor
+
+# NPM deps
+node_modules
+
+# Generated Schema used in some tooling. Versioned Schema is uploaded as a Release artifact to Github.
+schema.graphql
+
+# WP CLI config overrides
+wp-cli.local.yml
+
+# Tests
+*.sql
+*.tar.gz
+!tests
+tests/*.suite.yml
+coverage/*
+build/
+.log/
+c3.php
+
+# Cache
+phpcs-cache.json
+tests/_support/
+tests/_output/
+tests/_generated/
+tests/_data/
+
+# Playwright outputs
+artifacts
@@ -0,0 +1,41 @@
+# Actions & Filters
+
+## Table of Contents
+
+- [PHP Actions](#php-actions)
+- [PHP Filters](#php-filters)
+- [Examples](#examples)
+  - [Actions](#actions)
+  - [Filters](#filters)
+- [Contributing](#contributing)
+
+---
+
+This document lists the available PHP actions and filters provided by the WPGraphQL Velocity plugin, along with explanations and usage examples. These hooks allow you to customize plugin behavior, settings, and integration with other plugins or your theme.
+
+---
+
+## PHP Actions
+
+| Action Name                                   | Description                                                                                   |
+|-----------------------------------------------|-----------------------------------------------------------------------------------------------|
+                                  |
+
+---
+
+## PHP Filters
+
+| Filter Name                                         | Description                                                                                                 |
+|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------|
+
+
+---
+
+## Examples
+
+
+---
+
+## Contributing
+
+If you feel like something is missing or you want to add tests or testing documentation, we encourage you to contribute! Please check out our [Contributing Guide](https://github.com/wpengine/hwptoolkit/blob/main/CONTRIBUTING.md) for more details.
@@ -0,0 +1,4 @@
+# WPGraphQL Velocity
+
+## 0.0.1-beta
+- Proof of concept. A plugin for analyzing and measuring the performance of WPGraphQL queries in your headless application.