Merge pull request #84 from markcheret/fix-php-ci

fix: get PHP Composer GitHub Actions to pass
This commit is contained in:
Mark Cheret 2021-04-15 00:45:54 +02:00 committed by GitHub
commit efb9567374
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
4 changed files with 126 additions and 63 deletions

View file

@ -27,10 +27,11 @@ jobs:
${{ runner.os }}-php- ${{ runner.os }}-php-
- name: Install dependencies - name: Install dependencies
run: composer install --prefer-dist --no-progress run: composer install --prefer-dist --no-progress --ignore-platform-reqs
# Add a test script to composer.json, for instance: "test": "vendor/bin/phpunit" - name: Lint PHP code
# Docs: https://getcomposer.org/doc/articles/scripts.md run: composer run lint:php
# TODO: Add tests
# - name: Run test suite # - name: Run test suite
# run: composer run-script test # run: composer run-script test

156
README.md
View file

@ -2,76 +2,138 @@
# footnotes # footnotes
## Description Featured on [wpmudev][wpmudev] — cheers for the review, folks!
Featured on [wpmudev](http://premium.wpmudev.org/blog/12-surprisingly-useful-wordpress-plugins-you-dont-know-about/) — cheers for the review, folks! **footnotes** aims to be the all-in-one solution for displaying an
automatically-generated list of references on your Page or Post. The Plugin
ships with a set of defaults while also empowering you to control how your
footnotes will be displayed.
**footnotes** aims to be the all-in-one solution for displaying an automatically generated list of references on your Page or Post. The Plugin ships with a set of defaults while also empowering you to control how your footnotes are being displayed. **footnotes** gives you the ability to display well-formatted footnotes on your
WordPress Pages and Posts — those footnotes we know from offline publishing.
**footnotes** gives you the ability to display well-formatted footnotes on your WordPress Pages and Posts — those footnotes we know from offline publishing. ## Table of Contents
* [Features](#features)
* [Getting Started](#getting-started)
* [Deploying](#deploying)
* [Testing](#testing)
* [Code Formatting](#code-formatting)
* [Documentation](#documentation)
* [Acknowledgments](#acknowledgements)
* [License](#license)
* [Contact Information](#contact-information)
## Features
This Plugin provides:
- fully customizable footnote start and end shortcodes;
- stylable tooltips supporting hyperlinks and dedicated text;
- a responsive 'reference container', with customisable positioning;
- a wide choice of different numbering styles;
- a freely-configurable and optional backlink symbol;
- footnote appearance customisation via dashboard settings and custom CSS style
rules; and
- editor buttons for easily adding shortcode tags.
## Getting Started ## Getting Started
1. Read the contributing guidelines 1. Read the [contributing guidelines][contributing];
1. Clone this repository (`git clone git@github.com:markcheret/footnotes.git`) 1. clone this repository (`git clone git@github.com:markcheret/footnotes.git`):
- We recommend that you use [VVV](https://varyingvagrantvagrants.org/) for your local testing environment - we recommend that you use [VVV][vvv] for your local testing environment.
1. Install [Composer](https://getcomposer.org/download/), if you don't have it already 1. install [Composer][composer], if you don't have it already; and
1. Install dependencies (`composer install`) 1. install all dependencies (`composer install`):
- You will have to install `php-mbstring` manually if you do not already have it. - you will have to install `php-mbstring` manually if you do not already
have it.
## Code Formatting ## Deploying
1. Run `composer run lint-php` to lint all PHP files Automated release deployments will be introduced soon.
1. Run `composer run lint-php:fix` to attempt to automatically fix errors and warnings
## Releasing ### Building
1. Run `composer run release` 1. Run `_tools/build-stylesheets.sh -c` to concatenate stylesheets;
1. manually minify the output files in `css/tmp/`, saving them as `.min.css` files:
## Building - the intention is to replace this with automated minification, meaning that
1. Run `_tools/build-stylesheets.sh -c` to concatenate stylesheets
1. Manually minify the output files in `css/tmp/`, saving them as `.min.css` files
- The intention is to replace this with automated minification, meaning that
all of these steps can be rolled into a single `build` command. all of these steps can be rolled into a single `build` command.
1. Run `_tools/build-stylesheets.sh -d` to deploy the minified files to `dist/` 1. run `_tools/build-stylesheets.sh -d` to deploy the minified files to `dist/`:
- **this will delete any existing `dist/` folder** - **this will delete any existing `dist/` folder!**
1. Run `composer run build` to move over the remaining files to `dist/` 1. run `composer run build` to move over the remaining files to `dist/`:
- Currently, the files to include in a distribution are hard-coded in `_tools/build.sh` - currently, the files to include in a distribution are hard-coded in
- The intention is to replace this with a proper parsing of the `.distignore` file `_tools/build.sh`; but
- the intention is to replace this with a proper parsing of the `.distignore`
file
## Updating Documentation ### Releasing
1. Run `composer run docs` 1. Ensure that you have configured your Git config. with SVN credentials;
1. run the above [build](#building) commands; and
1. run `composer run release` and follow the prompts.
## Testing ## Testing
Unit tests are TODO. Automated testing will be introduced soon.
## Main Features ## Code Formatting
- Fully customizable **footnotes** start and end shortcodes; This repo. uses pre-commit code formatting and linting on all staged files.
- Styled tooltips supporting hyperlinks display **footnotes** or a dedicated text; This ensures that only style-conformant code can be committed.
- Responsive *Reference Container* at the end or positioned by shortcode;
- Display the **footnotes** *Reference Container* inside a Widget;
- Wide choice of numbering styles;
- Freely configurable and optional backlink symbol;
- Configure the **footnotes'** appearance by dashboard settings and Custom CSS style rules;
- Button in both the Visual and the Text editor to add shortcodes around selection.
## Example Usage The individual commands used by the pre-commit hook can also be called manually:
These are a few examples of possible ways to delimit footnotes: ### PHP Code
1. Your awesome text`((`with an awesome footnote`))` PHP code must follow the [WordPress PHP Coding Standards][wpcs-php].
2. Your awesome text`[ref]`with an awesome footnote`[/ref]`
3. Your awesome text`<fn>`with an awesome footnote`</fn>`
4. Your awesome text`custom-shortcode`with an awesome footnote`custom-shortcode`
## Where to get footnotes? 1. Run `composer run lint:php` to lint all JS/TS files with [PHP CodeSniffer][phpcs]
1. Run `composer run lint:php:fix` to attempt to automatically fix warnings and
errors with the PHP Code Beautifier and Formatter.
The current version is available on the [WordPress.org Plugin Directory](https://wordpress.org/plugins/footnotes/). ### JavaScript Code
JavaScript code must follow the [WordPress JavaScript Coding Standards][wpcs-js].
Automated linting and formatting will be introduced soon.
### CSS Stylesheets
JavaScript code must follow the [WordPress CSS Coding Standards][wpcs-css].
Automated linting and formatting will be introduced soon.
## Documentation
Run `composer run docs` to automatically generate HTML documentation with
[phpDocumentor][phpdocumentor].
View the current docs [here][footnotes-docs].
## Acknowledgements ## Acknowledgements
Huge thanks to every **footnotes user**, contributor, bug reporter, feature requester and fan! Huge thanks to every **footnotes user**, contributor, bug reporter, feature
requester and fan!
## License
This project is licensed under the [GNU GPL v3][gpl-v3].
## Contact Information
| Name | Link(s) |
|---------------|-----------------------|
|Mark Cheret | [Email][mcheret] |
[wpmudev]: http://premium.wpmudev.org/blog/12-surprisingly-useful-wordpress-plugins-you-dont-know-about/
[php]: https://www.php.net/
[contributing]: https://github.com/markcheret/footnotes/blob/main/CONTRIBUTING.md
[vvv]: https://varyingvagrantvagrants.org/
[composer]: https://getcomposer.org/download/
[wpcs-php]: https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/
[phpcs]: https://github.com/squizlabs/PHP_CodeSniffer
[wpcs-js]: https://developer.wordpress.org/coding-standards/wordpress-coding-standards/javascript/
[wpcs-css]: https://developer.wordpress.org/coding-standards/wordpress-coding-standards/css/
[phpdocumentor]: https://phpdoc.org/
[footnotes-docs]: https://markcheret.github.io/footnotes/
[gpl-v3]: https://www.gnu.org/licenses/gpl-3.0.en.html
[mcheret]: mailto:mark@cheret.de

View file

@ -1,15 +1,15 @@
{ {
"name": "markcheret/footnotes", "name": "markcheret/footnotes",
"description": "footnotes aims to be the all-in-one solution for displaying an automatically-generated list of references on your WordPress Page or Post.", "description": "footnotes aims to be the all-in-one solution for displaying an automatically-generated list of references on your WordPress Page or Post.",
"license": "GPL-3.0-or-later", "license": "GPL-3.0-only",
"scripts": { "scripts": {
"release": "./_tools/release.sh", "release": "./_tools/release.sh",
"release:commit": "composer run release -- -c", "release:commit": "composer run release -- -c",
"build": "./_tools/build.sh", "build": "./_tools/build.sh",
"lint-php": "./vendor/bin/phpcs --standard='WordPress' --colors --encoding=utf-8 -n -p --ignore=*/vendor/* ./*.php ./*/*.php ./*/*/*.php", "lint:php": "./vendor/bin/phpcs --standard='WordPress' --colors --encoding=utf-8 -n -p --ignore=*/vendor/* ./*.php ./*/*.php ./*/*/*.php",
"lint-php:fix": "./vendor/bin/phpcbf --standard='WordPress' --encoding=utf-8 -p --ignore=*/vendor/* ./*.php ./*/*.php ./*/*/*.php", "lint:php:fix": "./vendor/bin/phpcbf --standard='WordPress' --encoding=utf-8 -p --ignore=*/vendor/* ./*.php ./*/*.php ./*/*/*.php",
"lint-css": "echo TODO", "lint:css": "echo TODO",
"lint-js": "echo TODO", "lint:js": "echo TODO",
"docs": "./vendor/bin/phpdoc -d . -t ./docs --ignore vendor/", "docs": "./vendor/bin/phpdoc -d . -t ./docs --ignore vendor/",
"commit": "./vendor/bin/php-commitizen commit -- ./.php-commitizen.php", "commit": "./vendor/bin/php-commitizen commit -- ./.php-commitizen.php",
"post-install-cmd": "./_tools/setup.sh" "post-install-cmd": "./_tools/setup.sh"

10
composer.lock generated
View file

@ -482,16 +482,16 @@
}, },
{ {
"name": "laminas/laminas-code", "name": "laminas/laminas-code",
"version": "4.1.0", "version": "4.2.0",
"source": { "source": {
"type": "git", "type": "git",
"url": "https://github.com/laminas/laminas-code.git", "url": "https://github.com/laminas/laminas-code.git",
"reference": "5b553c274b94af3f880cbaaf8fbab047f279a31c" "reference": "e7e8f8a9c267520051d8026ff1da74823a3d8b97"
}, },
"dist": { "dist": {
"type": "zip", "type": "zip",
"url": "https://api.github.com/repos/laminas/laminas-code/zipball/5b553c274b94af3f880cbaaf8fbab047f279a31c", "url": "https://api.github.com/repos/laminas/laminas-code/zipball/e7e8f8a9c267520051d8026ff1da74823a3d8b97",
"reference": "5b553c274b94af3f880cbaaf8fbab047f279a31c", "reference": "e7e8f8a9c267520051d8026ff1da74823a3d8b97",
"shasum": "" "shasum": ""
}, },
"require": { "require": {
@ -549,7 +549,7 @@
"type": "community_bridge" "type": "community_bridge"
} }
], ],
"time": "2021-03-27T13:55:31+00:00" "time": "2021-04-14T22:05:06+00:00"
}, },
{ {
"name": "laminas/laminas-eventmanager", "name": "laminas/laminas-eventmanager",