=== BASCO UAE ===
Contributors: (custom build)
Tags: medical, conference, healthcare, oncology, custom-logo, custom-menu, featured-images, full-width-template, threaded-comments, translation-ready
Requires at least: 6.0
Tested up to: 6.5
Stable tag: 1.0.0
Requires PHP: 7.4
License: GNU General Public License v2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A modern, professional WordPress theme for the Best of ASCO UAE oncology conference.

== Description ==

BASCO UAE is a classic (non-FSE) WordPress theme designed for the Best of ASCO UAE conference and similar medical / academic events. It is **fully Elementor-compatible** (both free and Pro). It ships with:

* A conference-focused front page (hero, about, faculty grid, 2-day program with tabs, sponsors, CTA strip) that can be replaced with an Elementor-built page
* Custom post types for Faculty (speakers), Agenda sessions, and Sponsors
* Full WordPress Customizer support for hero content, about section, contact info, and social links
* Five page templates: Faculty, Program / Agenda, Contact, Full Width (Elementor), Blank Canvas
* Elementor Pro Theme Builder location support for header, footer, single, archive, search, and 404
* Theme color palette exposed to the WordPress editor and Elementor (8 colors, 5 font sizes)
* `theme.json` for modern WordPress global styles
* Responsive design with a clean medical aesthetic (navy + teal)
* Inter font from Google Fonts
* Translation-ready (text domain: basco-uae)

== Elementor usage ==

The theme works out of the box with both **Elementor** (free) and **Elementor Pro**.

**To replace the homepage with an Elementor page:**

1. Install and activate the Elementor plugin.
2. Pages → Add New → title it (e.g. "Home"), then click "Edit with Elementor" and build your page.
3. (Optional) Under Page Attributes → Template, choose **Full Width (Elementor)** if you want no theme padding, or **Blank Canvas** if you also want to hide the theme header and footer.
4. Settings → Reading → set "Your homepage displays" to "A static page" and choose the page you just built.
5. The theme will detect that the homepage was built with Elementor and render it instead of the default hardcoded sections.

**Theme color palette in Elementor:**

The theme exposes its 8 colors (Primary Navy, Accent Teal, etc.) to the WordPress editor automatically. To wire them into Elementor's Global Colors, go to Elementor → Site Settings → Global Colors and add them, or simply use the hex values:

* Primary Navy: `#0a2540`
* Accent Teal: `#00a896`
* Primary Dark: `#051a2e`
* Accent Dark: `#028090`
* Light Background: `#f5f7fa`
* Body Text: `#1a1a2e`
* Muted Text: `#5a6478`

**Elementor Pro Theme Builder:**

If you use Elementor Pro, you can build the header, footer, single post template, archive layout, search results, and 404 page entirely with Elementor:

1. Elementor Pro → Templates → Theme Builder.
2. Add New → choose the type (Header / Footer / Single / Archive / Search / 404).
3. Build it, then publish with display conditions (e.g. "Entire site" for header/footer).
4. The theme automatically yields its default header/footer/template when an Elementor Pro version exists.

== Installation ==

1. In your WordPress admin, go to Appearance → Themes → Add New → Upload Theme.
2. Upload `basco-uae.zip` and click "Install Now", then "Activate".
3. After activating, go to Settings → Permalinks and click "Save Changes" to flush rewrite rules (this enables /faculty/ and /session/ URLs).
4. Go to Appearance → Customize to set the hero text, conference date, location, contact info, and social URLs.
5. Optionally create your menu in Appearance → Menus and assign it to the "Primary Menu" location.

== Adding content ==

* **Faculty / Speakers** — In the admin sidebar, click "Faculty" → "Add New". Each speaker has fields for Role/Title, Affiliation, and Country (sidebar meta box). Add a Featured Image for the photo; otherwise initials are shown.
* **Agenda / Sessions** — Click "Agenda" → "Add New". Each session has Day (Day 1 or Day 2), Time (e.g. "09:00 – 10:30"), Speaker(s), and Topic/Category.
* **Sponsors** — Click "Sponsors" → "Add New" and upload the sponsor logo as the Featured Image.

== Page setup ==

To use the included page templates:

1. Pages → Add New → title it "Faculty", "Program", and "Contact" (or similar).
2. In the right sidebar under "Page Attributes", set the Template to "Faculty Page", "Program / Agenda", or "Contact Page".
3. Publish and add them to your menu.
4. In Settings → Reading, set the homepage to "A static page" and choose any page you like (the homepage will still render `front-page.php` regardless of which page is selected).

== Customizer sections ==

* **Homepage Hero** — eyebrow text, title, subtitle, date, location, host, and the two CTA buttons.
* **About Section** — title, body text, and image.
* **Contact & Footer** — email, phone, address, footer text, and social URLs (Twitter/X, LinkedIn, Facebook, YouTube).

== Notes ==

* The contact form on the Contact Page template is a non-functional placeholder. For a working form, install Contact Form 7 or WPForms and replace the form block in `page-templates/template-contact.php` with the plugin's shortcode (e.g. `<?php echo do_shortcode('[contact-form-7 id="123"]'); ?>`).
* The theme works with the WordPress block editor. Custom post types support Featured Images and the block editor.
* CSS lives at `assets/css/main.css`. Theme variables are at the top of that file under `:root` — change the navy/teal palette there.

== Changelog ==

= 1.1.0 =
* Added full Elementor and Elementor Pro compatibility.
* Added Elementor Pro Theme Builder location support (header, footer, single, archive, search, 404).
* Added "Full Width (Elementor)" page template (no theme banner, full bleed).
* Added "Blank Canvas" page template (no header/footer at all).
* Front page auto-detects Elementor-built homepage and renders its content.
* Added theme color palette and font sizes to the WordPress editor.
* Added theme.json for modern global styles.

= 1.0.0 =
* Initial release.
