Skip to content

CalderaWP/Caldera-Forms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Dec 18, 2020
60b5ac9 Β· Dec 18, 2020
Dec 18, 2020
Dec 18, 2020
Dec 18, 2020
May 25, 2020
Dec 17, 2020
Dec 17, 2020
Jan 16, 2020
Mar 30, 2020
Dec 18, 2020
Dec 16, 2019
Jan 31, 2020
Jan 22, 2020
Jun 9, 2020
Jul 9, 2020
Jun 11, 2020
Dec 17, 2020
May 29, 2019
Oct 12, 2017
May 22, 2018
Jun 11, 2020
Dec 18, 2018
Jul 22, 2020
Oct 12, 2017
Oct 12, 2017
Mar 20, 2020
Dec 17, 2020
Jul 6, 2020
Dec 17, 2020
Oct 19, 2018
Jul 6, 2020
Dec 18, 2020
Oct 24, 2018
Oct 18, 2018
Feb 20, 2019
Dec 17, 2020
Jan 3, 2020
Apr 15, 2020
Jul 20, 2020

Repository files navigation

Caldera-Forms

Drag & Drop WordPress Responsive Form Builder

πŸŒ‹πŸ‘€ Docs, Add-ons & More Information:

πŸŒ‹πŸ‘€ Development

Install for development

Requires: git, yarn, Grunt.

Build For Release

To create a build to ship to WordPress.org: yarn package

This creates /build/<version> where <version> is the current version set in package.json. This creates a directory you can ZIP up for testing or whatever.

See "Release To WordPress.org" section below for more details on pushing this build to WordPress.org.

JavaScript Development

See automated testing docs for more information on directory structure, in regards to JavaScript test files

Run watcher for development to auto-compile JavaScript and CSS.

/clients/

This is the new stuff, built with webpack. Eventually everything UI will be here.

  • Clients:
    • pro - The Caldera Forms Pro admin page and tab in the editor.
    • blocks - The Gutenberg block(s).
    • admin - The main admin page. Work in progress, not used in plugin.
    • viewer - The entry viewer. Work not in progress, not used in plugin.
    • editor - Theoretical.

/assets/

This is the old stuff, built with grunt.

  • Build for development and start watcher.
    • yarn dev:grunt
  • Build for production
    • yarn build:legacy

CLI Commands

Composer
  • composer test:php - Run PHP tests -- isolated unit tests and the WordPress integration tests.
  • composer dev:install - Installs dependencies, Docker-based test environment and sets up test forms.
  • composer dev:destroy - Deletes dependencies and the Docker-based test environment.
  • composer wp:install - Installs Docker-based test environment.
  • composer wp:start - Starts Docker-based test environment and echos the server's url.
  • composer wp:server-start - Starts Docker-based test environment.
  • composer wp:server-url - Echos the Docker-based test environment's server url.
  • composer wp:activate - Activate plugins in Docker-based environment.
  • composer wp:tests - Runs the PHP integration tests using phpunit inside Docker-based environment.
  • composer wp:stop - Stops Docker-based test environment, without destroying containers.
  • composer wp:destroy - Removes (including the database) the test environment and destroys containers.
  • composer test:unit - Run php unit tests.
  • composer test:setup - Adds test forms and puts them on pages.
  • composer test:delete - Delete test forms and pages the are on.
  • composer nuke - Deletes dependencies, including lock files --yarn and Composer.
yarn
  • yarn test - Run JavaScript test watcher
  • yarn build - Build all JavaScript and CSS for production
  • yarn build:blocks - Build blocks JavaScript and CSS for production
  • yarn build:clients - Build other JavaScript and CSS for production.
  • yarn start - Start dev server for clients that are not blocks and run watcher.
  • yarn start:blocks - Start dev server for blocks and run watcher.
  • yarn start:clients - Start dev server for other clients and run watcher.
  • yarn test:once - Run JavaScript unit tests once
  • yarn test:e2e - Start Cypress e2e test runner.
  • yarn test:e2e:ci - Trigger Cypress.io test record.
wp-cli

Probably don't use these directly. They will change. Must be prefaced with docker-compose run --rm cli

  • wp cf import-test-forms - Import test forms
  • wp cf delete-test-forms - Delete test forms
  • wp cf create-test-pages - Import test pages
  • wp cf delete-test-pages - Delete test pages

Release To WordPress.org

Requires

Steps

  • Build release file
    • yarn package
  • Push Tag to WordPress.org
    • cd bin
    • bash deploy-wp-org-tag.sh 12345 christiechirinos
  • Install tag using WP Rollback on QA site and re-run Ghost Inspector tests.
  • Copy tag to trunk
    • bash deploy-wp-org-trunk.sh 12345 christiechirinos

Notes

  • This assumes your WordPress.org username is christiechirinos, and your password is 12345.
  • The first argument is password, which is required. The second argument is username, which defaults to Shelob9, which is Josh's username.