=====================================================================
  ahFaucet v4.0  -  FaucetPay Crypto Faucet Script
  Developed by Abdul Haseeb  (HaseebScripts.com)
=====================================================================

REQUIREMENTS
------------
- PHP 8.2 or higher (PDO MySQL, cURL, JSON, mbstring)
- MySQL 5.7+ / MariaDB 10.3+
- Apache or LiteSpeed with .htaccess (mod_rewrite)
- Works on Hostinger, cPanel, Hestia, aaPanel and any VPS

INSTALLATION
------------
1. Create a MySQL database and user in your hosting panel.
2. Upload the zip to your domain root (public_html) and extract it.
3. Open https://yourdomain.com  -> the installer (/install) opens.
4. Fill in: database host, name, username, password, website name,
   website URL, admin PIN, reward (USD), FaucetPay API key, currency.
5. Click "Install Now". The website is live.
   Admin panel: https://yourdomain.com/admin  (login with your PIN)

Folders that must be writable: /includes (during install), /uploads, /cache

AFTER INSTALL (Admin panel)
---------------------------
Settings   : site name, description, URL, LOGO (navbar), FAVICON,
             FaucetPay API key, currency, reward in USD (live rate),
             claim limit, claim time, timer, referral %, Google
             Analytics ID, head / body code.
             Payment safety: max payout per payment, daily budget,
             emergency stop. Press "Save" once so the trusted price
             of your coin is loaded.
Secure     : AhProxy API Key (pg_...) + Secret (sk_...), then turn on
             - Proxy Shield  : server-side check, VPN/proxy users see only
                               a block card with their details
             - Adblock Shield: built-in, the website stops until the
                               ad blocker is disabled
             - AH Captcha    : captcha on the claim box
Ads Setup  : 728x90 Top, 728x90 Footer, 300x250 Left, 300x250 Right,
             468x60 in the claim box, Popup / Popunder / any script.
             Several banners per position rotate on every page reload.
OfferZono  : enable / disable, API key, secret key, whitelist IP.
             /offerzono page shows the claim timer + offerwall, no ads.
Users      : IP, country, claims, trust score, ban / unban.
Logs       : all events, clear logs, clear cache.
Connect    : FaucetPay, AhProxy, OfferZono, Poplix (sign up links).

PAYMENT SAFETY (why a claim can never pay more than the reward)
---------------------------------------------------------------
Every FaucetPay payment (claim, referral, offerwall) is checked:
 1. Emergency stop switch
 2. USD value must be <= "Max payout per payment"
 3. Coin amount is checked against a trusted price (3 price sources,
    median). If a price jumps more than 40%, payments stop by
    themselves.
 4. Daily budget for all payments together
Blocked payments are never sent and are listed in Logs -> Security.

SEO
---
Automatic: meta tags, Open Graph, canonical, JSON-LD (schema.org),
/sitemap.xml and /robots.txt.

REINSTALL
---------
Delete includes/install.lock and includes/config.php, then open the site.

UPDATE FROM v3
--------------
v4 has a new ads table layout (ad positions). Use a fresh install with
a new database, or ask the developer for the upgrade SQL.

SUPPORT
-------
Developed by Abdul Haseeb  -  HaseebScripts.com
