🎨 Femai-Theme - Professional WordPress Core for Real Estate

A high-performance, bespoke WordPress theme engineered specifically for Femai Empreendimentos Imobiliários, in partnership with Imobmark. This theme serves as the structural and aesthetic backbone of the digital platform, optimized for the real estate sector.

🎯 Overview

Femai-Theme is a professional production theme developed by Estevão Rolim. It is built to work in a tight ecosystem alongside the Femai Blocks plugin. While the plugin provides the JSON-driven content architecture, this theme provides the global styling, custom post type management (Empreendimentos), and the modular PHP template hierarchy needed for a scalable real estate portal.

✨ Key Features

• Custom Post Type Integration - Natively supports and manages the empreendimento (Property/Development) post type.
• Synergetic Architecture - Designed to consume and style custom blocks generated by the Femai Blocks framework.
• Modular Partial System - Uses a clean partials/ organization for headers, footers, and blog components to ensure high maintainability.
• Dynamic Real Estate Routing - Includes logic to automatically redirect property archives to designated landing pages via archive-empreendimento.php.
• Laravel Mix Integration - Utilizes an asset pipeline (verified by mix-manifest.json) for optimized SCSS and JS compilation.
• Extensible Hook System - Built around a Theme_Functions class that manages theme support, navigation menus, and custom query parameters.

🛠️ Tech Stack

• PHP 8.x - Core WordPress engine and Custom Post Type logic.
• SCSS/Sass - Modular styling compiled via Laravel Mix.
• JavaScript (ES6+) - Frontend interactivity and admin-side enhancements.
• Bootstrap 5 & Icons - Integrated for responsive grid layouts and UI elements.

📁 Project Structure

femai-theme/
├── assets/                 # Compiled production assets
│   ├── fonts/              # Local Montserrat & Bootstrap Icons
│   └── img/                # Theme-specific brand imagery
├── inc/                    # Core theme logic and extensions
│   ├── cpt/                # Custom Post Type definitions (Empreendimentos)
│   ├── customizer/         # WordPress Customizer (Kirki) integrations
│   ├── walker/             # Custom Bootstrap Nav Walker
│   └── shortcodes/         # Custom theme-specific shortcodes
├── partials/               # Reusable HTML/PHP fragments
│   ├── blog/               # Feed, single post, and archive layouts
│   └── [header/footer].php # Global layout components
├── src/                    # Source files for development
│   ├── js/                 # Raw JavaScript source
│   └── scss/               # Raw SCSS styling source
├── functions.php           # Main theme initialization & hooks
└── single-empreendimento.php # Dedicated template for property details

(Structure derived from project files and directory tree)

🚀 Getting Started

Installation

1. Clone into your WordPress themes folder:

    cd wp-content/themes/
    git clone https://github.com/ETVO/femai-theme.git

2. Activate Femai-Theme in the WordPress Admin Dashboard.

3. Ensure the Femai-Blocks plugin is installed and active to enable the full content-building experience.

🧠 Core Theme Logic

The theme utilizes a Theme_Functions class, present in WordPress' default functions.php to handle its lifecycle:

• theme_setup(): Enables support for post thumbnails, title tags, HTML5 markup, and registers the "Principal" and "Rodapé" menus.

• theme_imports(): Loads critical dependencies from the inc/ directory, including the Kirki customizer framework and CPT definitions.

• set_query_params(): Enhances the standard WordPress loop to handle custom GET parameters for property filtering.

• 🔗 Related Projects

• Femai-Blocks - Custom WordPress plugin developed from scratch to work seamlessly with this theme.

• Femai Empreendimentos - Live production website using this theme.

👤 Author

Estevão Pereira Rolim - @ETVO | LinkedIn

Developed for Femai Empreendimentos Imobiliários.

README generated in collaboration with Google Gemini.