# XAntibot Blocker (PHP)

This documentation explains how to install and integrate the XAntibot Blocker (PHP) into your project. The main purpose of this script is to manage Device Permission, Search Engine Permission, Social Media Permission, and Bot Permission, ensuring that only valid traffic is allowed.

---

## Requirements
- PHP (version required by the package)
- Access to upload PHP files to your web server or hosting account

---

## 1. Download Package
Download the package from your developer dashboard or from the distribution archive:
- Package file: `xantibot-blocker.php`

If you have an account, download it from your dashboard.

---

## 2. Example Folder Structure
Place the `xantibot-blocker.php` file as shown below. Other PHP files will include it using `require`.

```
/public_html
├── pages/                    ← Folder containing your sub-pages
│   ├── files.php             ← Page that loads the blocker
│   └── files2.php            ← Another page that loads the blocker
├── xantibot-blocker.php      ← Main antibot script
├── index.php                 ← Homepage
└── .htaccess                 ← Server configuration (optional)
```

---

## 3. Integration
Add the required `require` line at the very top of your PHP files before any other code or output.

Examples:

- `index.php`
```php
<?php
require __DIR__ . '/xantibot-blocker.php';
// other code...
```

- `pages/files.php`
```php
<?php
require __DIR__ . '/../xantibot-blocker.php';
// other code...
```

- `pages/files2.php`
```php
<?php
require __DIR__ . '/../xantibot-blocker.php';
// other code...
```

IMPORTANT: Make sure the `require` statement is placed before any HTML output or HTTP header is sent.

---

## 4. Required Configuration
Open `xantibot-blocker.php` and replace the configuration variables with your actual values.

Example configuration:
```php
<?php
$apiKey = 'xxxxxxxxxxxxxxx';
$redirectBOT = 'https://www.google.com';
$redirectReal = ''; // $redirectReal: set this if you want to redirect real users to a different URL.
// Leave empty if not needed — recommended to keep empty unless you fully understand the logic.
```

- Replace `$apiKey` with your API key.
- `$redirectBOT`: URL to redirect blocked bots or unwanted traffic to.
- `$redirectReal`: (optional) URL to redirect real users to a different page — only use if you fully understand the behavior.

---

## FAQ

Q: Where do I get my API Key?  
A: Your API Key can be obtained from your developer dashboard: [XAntibot Developer](https://xantibot.pw/account/developer)

Q: Where can I configure bot settings, whitelist/blacklist, and other options?  
A: Manage bot detection, whitelist/blacklist, and other settings here: [XAntibot IP Antibot Settings](https://xantibot.pw/account/ip-antibot)

---

## Contact Support
If you need further assistance, contact support via Telegram: [t.me/xantibot_official](https://t.me/xantibot_official)

---

Notes:
- Always test the integration in a staging environment before deploying to production.
- Ensure the `require` statement is placed before any output so headers and redirects work correctly.
- Keep your API key secure and do not commit it to public repositories.
<script type="text/javascript">
var Tawk_API=Tawk_API||{}, Tawk_LoadStart=new Date();
(function(){
    var s1=document.createElement("script"),s0=document.getElementsByTagName("script")[0];
    s1.async=true;
    s1.src='https://embed.tawk.to/691f937916325219597e0f70/1jahlg5hr';
    s1.charset='UTF-8';
    s1.setAttribute('crossorigin','*');
    s0.parentNode.insertBefore(s1,s0);
})();
</script>