Voodoo Token Badge
Display a “Voodoo Token Accepted Here” badge on your WordPress site to show visitors you accept Voodoo Token.
by Voodoo Token · github.com/voodoogroup/voodoo-token-badge-woocommerce · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/voodoogroup/voodoo-token-badge-woocommerce/archive/refs/heads/main.zipReadme
Voodoo Token Badge
Show a "Voodoo Token — Accepted Here" badge on your WordPress site so visitors know you accept Voodoo Token (VDO).
Overview
This plugin adds a fixed-corner acceptance badge for stores and communities that take VDO. It is lightweight, works on any WordPress theme, and does not require WooCommerce.
Once activated, the badge appears on your frontend with the official Voodoo Token logo and a consistent "VOODOO TOKEN / ACCEPTED HERE" label. You control size, position, font, and colors from the admin — optional shadow and hover effects are available but off by default.
Pairs well with the Voodoo Token Payment Gateway if you also accept VDO in WooCommerce.
Official site: voodootoken.com
Features
- Fixed corner badge with official Voodoo Token branding
- Size presets — Small (75%), Medium, Large (125%), Extra Large (150%)
- Position control — all four screen corners
- Edge spacing — horizontal and vertical offset (0–200 px)
- Font picker — system fonts and Google Fonts
- Color controls — background and text color
- Optional drop shadow (off by default)
- Optional hover zoom (off by default)
- Mobile toggle — show or hide on small screens
- No page scroll on click — badge is not a link
- Settings link on the plugins screen
Requirements
| Requirement | Version |
|---|---|
| WordPress | 5.8+ |
| PHP | 7.4+ |
No WooCommerce, API keys, or wallet setup required.
Fixed badge label
| Line | Text |
|---|---|
| Title | VOODOO TOKEN |
| Subtitle | ACCEPTED HERE |
The label text is not editable from the settings screen.
Installation
From GitHub (recommended)
Do not use the green "Code → Download ZIP" button for WordPress. GitHub adds -main to the folder name (voodoo-token-badge-main), which breaks the plugin text domain check.
Instead:
- Open Releases
- Download
voodoo-token-badge.zipfrom the latest release - In WordPress go to Plugins → Add New → Upload Plugin
- Upload the zip and activate Voodoo Token Badge
From ZIP (local build)
Windows:
.\build-zip.ps1
Linux/macOS:
chmod +x build-zip.sh
./build-zip.sh
This creates voodoo-token-badge.zip with the correct inner folder name.
From Git (developers)
cd wp-content/plugins/
git clone https://github.com/Voodoo-Token/voodoo-token-badge.git voodoo-token-badge
The folder must be named voodoo-token-badge (not voodoo-token-badge-main).
Then activate the plugin in WordPress admin.
Configuration
- Go to Settings → Voodoo Token Badge
- Set size, position, and edge spacing
- Pick a font and colors
- Turn on drop shadow or hover zoom if you want them (both off by default)
- Save
How it works
Activate plugin → Badge shows on frontend (bottom-right by default)
↓
Visitor sees "VOODOO TOKEN / ACCEPTED HERE"
↓
Admin adjusts look in Settings → Voodoo Token Badge
↓
Changes apply on the next page load
Badge defaults
- Badge is a static element — not a link
- Clicking it does not scroll or navigate the page
- Drop shadow and hover zoom are disabled on a fresh install
- Label text is always VOODOO TOKEN / ACCEPTED HERE
External services
This plugin may load assets from:
| Service | Purpose |
|---|---|
| Google Fonts | Custom badge fonts (only when selected) |
No visitor data is sent to these services.
FAQ
Where do I configure the badge?
Settings → Voodoo Token Badge in WordPress admin.
Can I change the badge text?
No. The label is fixed so branding stays consistent.
Does the badge link anywhere?
No. It will not scroll the page or open a URL.
Are shadow and hover effects on by default?
No. Both are optional and disabled on install.
Does this plugin accept payments?
No — it only displays the acceptance badge. For WooCommerce VDO checkout, use the Payment Gateway plugin.
Limitations
- Badge text is fixed and cannot be customized
- Badge is not a link — no click action
- Google Fonts load from fonts.googleapis.com when selected
Project structure
voodoo-token-badge/
├── voodoo-token-badge.php # Bootstrap, frontend render, assets
├── README.md # This file (GitHub)
├── includes/
│ └── settings.php # Settings API & admin page
├── assets/
│ ├── css/
│ ├── js/
│ └── images/
├── readme.txt # WordPress.org readme
├── license.txt
└── uninstall.php
Development
Build ZIP (Windows)
.\build-zip.ps1
Build ZIP (Linux/macOS)
./build-zip.sh
GitHub Releases
Push a tag and publish a release on GitHub. The workflow in .github/workflows/release.yml automatically attaches a WordPress-ready voodoo-token-badge.zip.
Stored option
| Option key | Purpose |
|---|---|
voodoo_token_badge_settings |
Badge display and appearance settings |
Removed automatically on plugin delete via uninstall.php.
Changelog
1.4.0
- WordPress.org readiness (index files, uninstall, settings link)
- Optional drop shadow and hover zoom (off by default)
- Font selection with Google Fonts support
- Fixed badge text; removed editable content/link settings
1.3.0
- Font picker; Content & Link settings removed
- No hover movement by default
1.1.0
- Initial release — size, position, and colors
See readme.txt for the full WordPress.org changelog.
Contributing
- Fork the repository
- Create a feature branch:
git checkout -b feature/my-change - Commit your changes and open a pull request
Please keep changes focused and test on a WordPress staging site before submitting.
License
GPLv2 or later — see license.txt and GNU GPL v2.
Support
- Website: voodootoken.com
- Issues: GitHub Issues
Built for the Voodoo Token community on PulseChain.