Postal Pro is a complete PHP-based ZIP & Postal Code Search script designed for speed, accuracy, and global coverage. It allows users to search postal codes by country, state, city, or region and instantly retrieve location details. With a clean UI, powerful database support, and simple integration, it’s ideal for developers, businesses, and portals needing reliable postal lookup functionality. Fully customizable and SEO-friendly, Postal Pro is built to scale. It will be updated regularly. 

*PostalPro* lets you build a complete global postal/ZIP code directory with:
- 🚀 *Bulk CSV Importer* (progress bar, dedupe, soft delete/restore)
- 📚 *Data Enrichment* from Wikipedia, World Bank, RestCountries (summaries, population, capitals, currencies, TLDs, phone codes, fun facts)
- 🗺️ *Maps Integration* (OpenStreetMap embeds — no API key required)
- ✍️ *CMS Pages* (Terms, Privacy, About, custom pages with Summernote)
- 🔎 *SEO-Ready* (clean URLs, sitemap.xml, meta fields, custom logo & favicon)
- 🔐 *Secure Admin Panel* (roles: Admin/Viewer, slug gate, CSRF protection, logs)

---

## ✨ Highlights

- Import *millions of postal codes* with duplicate prevention.
- Enrich countries with *summaries, population, currency, calling code, TLD* and more.
- CMS-like static pages with *WYSIWYG editor*.
- *SEO-first*: clean URLs (/country/jp, /place/in/delhi, /postal/us/90210) + sitemap.
- *White-label*: upload logo, favicon, and set meta title/description/keywords.
- Built on *PHP + MySQL, styled with **Bulma CSS*.

---

## Requirements
- PHP 7.4+ (PHP 8.1+ recommended)  
- MySQL 5.7+ or MariaDB 10.2+  
- Apache/Nginx with mod_rewrite enabled  
- PHP extensions: mysqli, mbstring, json, curl  
- Writable directories: /uploads/, /storage/, /tmp/

# Installation
1. Upload all files to your server.  
2. Create a MySQL database.  
3. Visit /install/install.php in your browser.  
4. Enter database credentials, site name, support email, and admin password.  
5. Installer will run install.sql, import countries, and generate /includes/config.php.  
6. Delete the /install/ folder after installation.  
7. Login at /admin/login.php.