WP Manifestindependent plugin directory
manifest / integrations / lottery-display

Lottery Display Plugin

WordPress plugin that renders lottery results and search from a secure Django REST API.

by Ginz · github.com/gnznovus/lottery-display

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/gnznovus/lottery-display/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/gnznovus/lottery-display ↗

A production-ready WordPress plugin that renders lottery results from a Django backend with secure API access, rich layouts, and a built-in search experience.

Highlights

  • Django REST integration with API key security.
  • Two shortcodes: latest results + number search.
  • Thai-friendly UI with configurable labels.
  • Admin display settings with live CSS generation.
  • wp-env ready for local development.

What It Does

  • [lottery_display] renders the latest results for a lottery source.
  • [lottery_search] lets users verify a 6-digit number against a draw date.
  • All data is fetched from the lottery-platform API.

Tech Stack

  • WordPress (PHP)
  • Django REST API
  • PostgreSQL
  • Docker + wp-env

Requirements

  • WordPress environment (local or production)
  • Django API running and reachable
  • API key configured

Configuration

Edit config.php:

  • LOTTERY_API_BASE_URL (example: http://localhost:8000)
  • LOTTERY_API_KEY (must match API_AUTH_KEY in Django .env)

If WordPress runs in WSL, localhost points to WSL. Use the Windows host IP for the API base URL.

Shortcodes

  • [lottery_display type="huayrat_display"]
    • Uses source -> Thai display name mapping from assets/json/column_mapping.json.
  • [lottery_search]
    • Pulls draw dates from the API and searches with correct front/back/last digit rules.

API Endpoints Used

  • GET /api/sources/<code>/results/latest/
  • GET /api/draw-events/?source=huayrat&status=completed&page_size=10
  • GET /api/search/?source=huayrat&draw_date=YYYY-MM-DD&number=123456

All requests require X-API-KEY: <key>.

Display Settings

Admin: Settings -> Lottery Display

  • Layout colors, borders, and typography
  • Generates:
    • assets/css/core-style.css
    • assets/css/layout-huayrat.css
    • assets/css/layout-default.css

Reset to default removes generated files and recreates them.

Local Testing (wp-env)

From plugin root:

npx @wordpress/env start

Stop:

npx @wordpress/env stop

Project Structure

  • config.php - API base URL + key
  • includes/api.php - REST client
  • includes/display.php - rendering logic + source label map
  • shortcode/main-lottery.php - latest results
  • shortcode/search.php - search UI + AJAX
  • assets/json/column_mapping.json - reward labels + source display names
  • .wp-env.json - local WordPress container

Flow

flowchart LR
    A[WordPress Shortcode] --> B[Lottery Display Plugin]
    B --> C[WP REST Client]
    C -->|X-API-KEY| D[Django API]
    D --> E[(PostgreSQL)]
    B --> F[Render HTML/CSS]

    subgraph Shortcodes
        S1[[lottery_display]]
        S2[[lottery_search]]
    end

    S1 --> B
    S2 --> B

    D -->|/api/sources/code/results/latest/| B
    D -->|/api/search/| B

Status

Stable for local testing with Docker + wp-env. Ready for production once API URL and key are set.

Changelog

See CHANGELOG.md.