Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 28 additions & 5 deletions .distignore
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
# Files excluded from the distributed plugin zip (wordpress.org).
#
# Note: `/vendor` is excluded while the plugin has no runtime Composer
# dependencies. Once runtime dependencies are added, ship a scoped build
# (PHP-Scoper/Mozart) of `vendor/` instead of excluding it.
# Runtime dependencies are installed with `composer install --no-dev` and the
# Verifycate PHP SDK lives in vendor/. `bin/build-plugin.sh` uses this file with
# rsync and then zips the result.

.git
.github
.wordpress-org
bin
build
node_modules
tests
vendor
composer.json
composer.lock
package.json
Expand All @@ -19,12 +19,35 @@ pnpm-lock.yaml
phpcs.xml.dist
phpstan.neon.dist
phpunit.xml.dist
wp-env.json
.wp-env.json
.distignore
.svnignore
.gitignore
.gitattributes
.editorconfig
.phpunit.result.cache
.phpunit.cache
CHANGELOG.md
languages/.gitkeep
CODE_OF_CONDUCT.md
CONTRIBUTING.md
README.md
SECURITY.md

# Trim the bundled SDK to its runtime files.
vendor/verifycate/php-sdk/tests
vendor/verifycate/php-sdk/openapi
vendor/verifycate/php-sdk/scripts
vendor/verifycate/php-sdk/vendor
vendor/verifycate/php-sdk/.git
vendor/verifycate/php-sdk/.github
vendor/verifycate/php-sdk/.editorconfig
vendor/verifycate/php-sdk/.gitignore
vendor/verifycate/php-sdk/phpcs.xml.dist
vendor/verifycate/php-sdk/phpstan.neon.dist
vendor/verifycate/php-sdk/phpunit.xml.dist
vendor/verifycate/php-sdk/README.md
vendor/verifycate/php-sdk/CHANGELOG.md
vendor/verifycate/php-sdk/CONTRIBUTING.md
vendor/verifycate/php-sdk/SECURITY.md
vendor/verifycate/php-sdk/composer.json
87 changes: 83 additions & 4 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ jobs:
- '8.1'
- '8.2'
- '8.3'
- '8.4'
steps:
- name: Checkout
uses: actions/checkout@v4
Expand All @@ -30,6 +31,24 @@ jobs:
coverage: none
tools: composer

- name: Check out the private PHP SDK
env:
SDK_DEPLOY_KEY: ${{ secrets.VERIFYCATE_SDK_DEPLOY_KEY }}
run: |
if [ -z "$SDK_DEPLOY_KEY" ]; then
echo "::error::VERIFYCATE_SDK_DEPLOY_KEY is not set. Add the read-only deploy key for verifycate/php-sdk."
exit 1
fi
install -m 700 -d "$HOME/.ssh"
printf '%s\n' "$SDK_DEPLOY_KEY" > "$HOME/.ssh/verifycate_sdk"
chmod 600 "$HOME/.ssh/verifycate_sdk"
ssh-keyscan -t ed25519 github.com >> "$HOME/.ssh/known_hosts"
GIT_SSH_COMMAND="ssh -i $HOME/.ssh/verifycate_sdk -o IdentitiesOnly=yes" \
git clone --depth=1 git@github.com:verifycate/php-sdk.git ../php-sdk

- name: Validate Composer metadata
run: composer validate --strict

- name: Install Composer dependencies
run: composer install --prefer-dist --no-progress

Expand All @@ -56,12 +75,72 @@ jobs:
coverage: none
tools: composer

- name: Install production autoloader
run: composer install --prefer-dist --no-progress --no-dev
- name: Check out the private PHP SDK
env:
SDK_DEPLOY_KEY: ${{ secrets.VERIFYCATE_SDK_DEPLOY_KEY }}
run: |
if [ -z "$SDK_DEPLOY_KEY" ]; then
echo "::error::VERIFYCATE_SDK_DEPLOY_KEY is not set. Add the read-only deploy key for verifycate/php-sdk."
exit 1
fi
install -m 700 -d "$HOME/.ssh"
printf '%s\n' "$SDK_DEPLOY_KEY" > "$HOME/.ssh/verifycate_sdk"
chmod 600 "$HOME/.ssh/verifycate_sdk"
ssh-keyscan -t ed25519 github.com >> "$HOME/.ssh/known_hosts"
GIT_SSH_COMMAND="ssh -i $HOME/.ssh/verifycate_sdk -o IdentitiesOnly=yes" \
git clone --depth=1 git@github.com:verifycate/php-sdk.git ../php-sdk

- name: Build the distributable plugin
run: composer build

- name: Extract the plugin
run: |
rm -rf build/check
mkdir -p build/check
unzip -q build/verifycate.zip -d build/check

- name: Run Plugin Check
uses: wordpress/plugin-check-action@v1
with:
slug: verifycate
build-directory: '.'
exclude-directories: 'vendor,node_modules,tests,.github,bin,build'
build-dir: build/check/verifycate
exclude-directories: 'vendor'

package:
name: Package
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4

- name: Set up PHP
uses: shivammathur/setup-php@v2
with:
php-version: '7.4'
coverage: none
tools: composer

- name: Check out the private PHP SDK
env:
SDK_DEPLOY_KEY: ${{ secrets.VERIFYCATE_SDK_DEPLOY_KEY }}
run: |
if [ -z "$SDK_DEPLOY_KEY" ]; then
echo "::error::VERIFYCATE_SDK_DEPLOY_KEY is not set. Add the read-only deploy key for verifycate/php-sdk."
exit 1
fi
install -m 700 -d "$HOME/.ssh"
printf '%s\n' "$SDK_DEPLOY_KEY" > "$HOME/.ssh/verifycate_sdk"
chmod 600 "$HOME/.ssh/verifycate_sdk"
ssh-keyscan -t ed25519 github.com >> "$HOME/.ssh/known_hosts"
GIT_SSH_COMMAND="ssh -i $HOME/.ssh/verifycate_sdk -o IdentitiesOnly=yes" \
git clone --depth=1 git@github.com:verifycate/php-sdk.git ../php-sdk

- name: Build the distributable plugin zip
run: composer build

- name: Upload the plugin zip
uses: actions/upload-artifact@v4
with:
name: verifycate-plugin
path: build/verifycate.zip
if-no-files-found: error
71 changes: 71 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
name: Release

on:
push:
tags:
- 'v*'
workflow_dispatch:
inputs:
tag:
description: Existing tag to release, for example v0.1.0
required: true
type: string

permissions:
contents: write

jobs:
package:
name: Build and publish plugin zip
runs-on: ubuntu-latest

steps:
- name: Checkout
uses: actions/checkout@v4
with:
ref: ${{ github.event.inputs.tag || github.ref }}

- name: Set up PHP
uses: shivammathur/setup-php@v2
with:
php-version: '7.4'
coverage: none
tools: composer

- name: Check out the private PHP SDK
env:
SDK_DEPLOY_KEY: ${{ secrets.VERIFYCATE_SDK_DEPLOY_KEY }}
run: |
if [ -z "$SDK_DEPLOY_KEY" ]; then
echo "::error::VERIFYCATE_SDK_DEPLOY_KEY is not set. Add the read-only deploy key for verifycate/php-sdk."
exit 1
fi
install -m 700 -d "$HOME/.ssh"
printf '%s\n' "$SDK_DEPLOY_KEY" > "$HOME/.ssh/verifycate_sdk"
chmod 600 "$HOME/.ssh/verifycate_sdk"
ssh-keyscan -t ed25519 github.com >> "$HOME/.ssh/known_hosts"
GIT_SSH_COMMAND="ssh -i $HOME/.ssh/verifycate_sdk -o IdentitiesOnly=yes" \
git clone --depth=1 git@github.com:verifycate/php-sdk.git ../php-sdk

- name: Build the distributable plugin zip
run: composer build

- name: Verify the zip
run: |
test -s build/verifycate.zip
unzip -l build/verifycate.zip | grep -q 'verifycate/verifycate.php'

- name: Create GitHub release
env:
GH_TOKEN: ${{ github.token }}
RELEASE_TAG: ${{ github.event.inputs.tag || github.ref_name }}
run: |
if gh release view "$RELEASE_TAG" >/dev/null 2>&1; then
gh release upload "$RELEASE_TAG" "build/verifycate.zip#verifycate.zip" --clobber
else
gh release create "$RELEASE_TAG" \
"build/verifycate.zip#verifycate.zip" \
--title "Verifycate ${RELEASE_TAG#v}" \
--generate-notes \
--latest
fi
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# Dependencies
/vendor/
/node_modules/
/composer.lock

# Build output
/build/
Expand Down
Binary file added .wordpress-org/screenshot-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshot-10.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshot-11.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshot-12.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshot-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshot-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshot-4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshot-5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshot-6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshot-7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshot-8.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshot-9.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
77 changes: 77 additions & 0 deletions .wordpress-org/screenshots/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
# Verifycate screenshots

iPad Pro 13 landscape capture set at **2752 × 2064** (1376 × 1032 CSS at 2×).

## WordPress.org set

Curated files in `.wordpress-org/screenshot-1.png` through `screenshot-12.png`:

1. Get started — connection state, shortcode guide, and LMS status.
2. Configure — workspace connection and API key.
3. Mappings — all native LMS mappings and the custom hook.
4. Tutor LMS — quiz mapping with a minimum score.
5. LifterLMS — certificate picker with the workspace catalogue.
6. LearnPress — quiz picker grouped by course.
7. Sensei — quiz mapping.
8. Custom hook — event and course scope.
9. Logs — queue health and recent certificate jobs.
10. My Certificates — learner wallet with four issued certificates.
11. Verify a certificate — successful public verification.
12. Sample certificate — embedded certificate card.

Suggested readme captions:

```text
== Screenshots ==

1. Connect your Verifycate workspace and see which LMS plugins are active.
2. Store the workspace API key without exposing it in the admin.
3. Map any course, quiz or lesson to a Verifycate certificate.
4. Add a minimum score for quiz-based completions.
5. Pick certificates directly from the Verifycate catalogue.
6. Search quiz and lesson options grouped by course.
7. Use the same flow for Sensei LMS.
8. Map custom completion hooks when an LMS is not covered.
9. Monitor queued and issued certificates from the logs screen.
10. Give learners a wallet with every certificate they have earned.
11. Let anyone verify a certificate with its public ID.
12. Embed a certificate card anywhere with a shortcode.
```

## Full guide set

All 24 captures live in `screenshots/full-set/`:

| File | Scenario |
| --- | --- |
| `01-get-started.png` | Get started, connected workspace |
| `02-configure.png` | Configure connection |
| `03-mappings-overview.png` | Mappings overview |
| `04-new-mapping.png` | New mapping |
| `05-tutor-lesson-mapping.png` | Tutor lesson mapping |
| `06-tutor-quiz-mapping.png` | Tutor quiz mapping with score |
| `07-trigger-combobox.png` | Trigger picker open |
| `08-learnpress-lesson-mapping.png` | LearnPress lesson mapping |
| `09-learnpress-quiz-mapping.png` | LearnPress quiz mapping |
| `10-learnpress-object-combobox.png` | LearnPress quiz picker open |
| `11-lifter-lesson-mapping.png` | LifterLMS lesson mapping |
| `12-lifter-quiz-mapping.png` | LifterLMS quiz mapping |
| `13-lifter-certificate-combobox.png` | Certificate picker open |
| `14-sensei-lesson-mapping.png` | Sensei lesson mapping |
| `15-sensei-quiz-mapping.png` | Sensei quiz mapping |
| `16-sensei-object-combobox.png` | Sensei quiz picker open |
| `17-custom-hook-mapping.png` | Custom hook mapping |
| `18-any-course-mapping.png` | Any-course mapping |
| `19-mapping-attributes.png` | Certificate attribute mapping |
| `20-logs.png` | Queue and issuance logs |
| `21-verify-certificate.png` | Public verification form |
| `22-verify-certificate-result.png` | Successful verification |
| `23-sample-certificate.png` | Embedded certificate card |
| `24-my-certificates.png` | Learner certificate wallet |

## Demo data

- Site: Acme Academy
- Learner: Jordan Lee
- Certificates: Inclusive Leadership, Coaching Excellence, Data Storytelling, Customer Discovery
- LMS: Tutor LMS, LearnPress, LifterLMS, Sensei
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .wordpress-org/screenshots/full-set/20-logs.png
2 changes: 1 addition & 1 deletion wp-env.json → .wp-env.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$schema": "https://schemas.wp.org/trunk/wp-env.json",
"core": null,
"phpVersion": "7.4",
"phpVersion": "8.3",
"plugins": [ "." ],
"config": {
"WP_DEBUG": true,
Expand Down
30 changes: 30 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

### Added

- Connection setup with a single API key: the plugin resolves the workspace,
checks the key scopes and plan, and enables issuance in one action.
- Certificate catalogue cache and mapping editor with any-course and
course-specific mappings, searchable course and certificate comboboxes,
attribute templates and a token reference.
- LMS adapters for LearnDash, Tutor LMS, LearnPress, LifterLMS and Sensei, plus
a documented `verifycate_course_completed` custom hook.
- Durable issuance queue on custom tables with exponential backoff, retry
classification, stale-lock recovery and a retry action.
- Duplicate suppression and recertification (reissue) policies.
- Admin setup, mappings, queue and activity log screens.
- Certificate wallet shortcode and server-rendered block.
- WP-CLI commands for status, mappings, direct issuance, queue processing,
retries and logs.
- PHPUnit coverage for encryption, settings, mappings, completion events,
attribute templates, retry policy and the integration registry.
- Opt-in uninstall cleanup for settings, mappings, queue history and logs.

### Changed

- The plugin now consumes the `verifycate/php-sdk` package through a Composer
path repository during development and ships the SDK in release zips.
- The Verifycate API client is the SDK's WordPress transport, backed by
`wp_remote_request`; the plugin no longer hand-writes API paths.

## [0.1.0] - 2026-10-21

### Added

- Initial plugin skeleton: bootstrap, PSR-4 autoloader with Composer fallback,
requirement checks, and text domain loading.
- Tooling: PHPCS (WordPress + PHPCompatibility), PHPStan, PHPUnit, wp-env, and
Expand All @@ -17,3 +46,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
policy, issue and pull request templates.

[Unreleased]: https://github.com/verifycate/wp-plugin/commits/main
[0.1.0]: https://github.com/verifycate/wp-plugin/releases/tag/v0.1.0
Loading
Loading