WP Manifestindependent plugin directory
manifest / ecommerce / voodoo-token-badge-woocommerce

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

0stars
0forks

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.zip

Readme

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:

  1. Open Releases
  2. Download voodoo-token-badge.zip from the latest release
  3. In WordPress go to Plugins → Add New → Upload Plugin
  4. 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

  1. Go to Settings → Voodoo Token Badge
  2. Set size, position, and edge spacing
  3. Pick a font and colors
  4. Turn on drop shadow or hover zoom if you want them (both off by default)
  5. 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

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/my-change
  3. 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


Built for the Voodoo Token community on PulseChain.

Read the full README on GitHub →