Ambag Drive v1.0.0 · WordPress plugin

Free WordPress plugin · GPL-2.0-or-later

Show your community how close the goal is.

Ambag Drive tracks school, parish, cooperative and barangay drives in pesos or in items. Visitors see a live progress bar, funded milestones and a thank-you wall. Organizers confirm pledges in one ledger.

23/23ledger unit tests
0external requests
WP 6.5tested end to end

Try both sides of the plugin

Send a pledge as a visitor, then confirm it in wp-admin. The bar, milestones, donor wall and REST response all update from the same ledger. This preview keeps its sample data in your browser only.

sanisidro-es.example/support-our-schoolVisitor view

Community drive

Classroom Fans for San Isidro Elementary

₱0

      Thank you to

        Pledge to this drive

        A pledge is a promise, not a payment. Only the name you type (if any) and the amount are stored.

        sanisidro-es.example/wp-admin/post.php?post=4wp-admin
        DashboardAmbag DrivesPagesSettings

        Edit Drive

        Drive Settings

        Contributions Ledger

        DateNameAmountStatusActions

        GET /wp-json/ambag/v1/drives/4totals only, no names

        
              

        Shortcodes and blockcopy into any page

        [ambag id="4"]
        [ambag id="4" layout="compact"]
        [ambag id="4" wall="no" form="no" limit="5"]
        
        <!-- Block editor -->
        Add block → Widgets → "Ambag Drive" → pick the drive
        
        // Automations: fires after a pledge is stored
        add_action( 'ambag_drive_pledge_received',
          function ( $drive_id, $amount ) { /* n8n, SMS... */ }, 10, 2 );

        About this project

        The problem

        Schools, parishes, cooperatives and barangays run drives all year: classroom fans, relief packs, a chapel roof. Progress usually lives in a notebook or a Facebook post that is out of date by Friday. Donors cannot see how close the goal is, and treasurers retype totals by hand.

        Who it is for

        PTAs and school heads, parish councils, cooperative officers, barangay and LGU social-welfare desks, and the web developers who build their WordPress sites.

        Features

        • Goals in pesos or items (relief packs, books, chairs)
        • Progress bar with milestone checkpoints
        • Donor wall that hides anonymous givers and private notes
        • Pledge form: nonce, honeypot, 60-second cooldown, saved as Pending
        • Editable ledger in wp-admin with CSV export (formula-safe)
        • Shortcode, dynamic block, auto-display on the drive page
        • Read-only REST endpoint and a hook for automations
        • Translation-ready, no payment processing, no tracking

        Languages used

        PHP runs the plugin inside WordPress, JavaScript animates the bar and powers the block, CSS styles the tracker for light and dark themes. No build step, no npm, no Composer.

        Install

        1. Download ambag-drive.zip from the GitHub release.
        2. wp-admin → Plugins → Add New → Upload Plugin → Activate.
        3. Ambag Drives → Add New: goal, deadline, milestones.
        4. Publish. The tracker shows on the drive page, or place the block.

        Client pitch

        Offer it as a "transparency page" add-on for school and parish websites: set up the drive, train the treasurer to confirm pledges, and connect the pledge hook to Messenger or SMS alerts with n8n. A monthly care plan covers updates and the end-of-drive CSV report for the community.

        Source

        github.com/EfraimRay/ambag-drive
        Built by Efraim Ray, web developer in Valencia City, Bukidnon. efraimray.com