## Quick Start
1. Add the "Weekly Calendar Scheduler" element to your page
2. Set the Events JSON field with your events array:

[
 {
   "id": "1",
   "title": "Team Meeting",
   "start": "2026-08-21T09:00:00",
   "end": "2026-08-21T10:30:00",
   "type": "reuniao",
   "color": "#2980b9",
   "location": "Room A",
   "description": "Weekly sync"
 }
]

Supported date formats: ISO 8601, Unix timestamp (seconds or milliseconds).

---

## Event Type Colors

Define custom colors for your event types via the "Event Type Styles (JSON)" field:

[
 { "type": "reuniao",   "color": "#2980b9" },
 { "type": "casamento", "color": "#8e44ad" },
 { "type": "feriado",   "color": "#27ae60" }
]

The plugin automatically generates pastel backgrounds, border colors and readable text from each hex color.

---

## Language / Multilanguage

The plugin supports multiple languages out of the box.

Set the **Language** property in the Property Editor:

| Value    | Language   |
|----------|------------|
| pt       | Portuguese |
| en       | English    |
| fr       | French     |
| custom   | Your own   |

### Custom Language

Set Language to **custom** and fill the **Custom Language JSON** field with the following structure:

{
 "days":   ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"],
 "months": ["January", "February", "March", "April", "May", "June",
            "July", "August", "September", "October", "November", "December"],
 "ui": {
   "today": "Today",
   "week":  "Week",
   "day":   "Day",
   "2days": "2 Days",
   "3days": "3 Days",
   "4days": "4 Days",
   "5days": "5 Days"
 }
}

**Notes:**
- `days` must have exactly 7 entries (starting Sunday)
- `months` must have exactly 12 entries
- Any missing `ui` key falls back to English automatically
- Language can be changed at runtime via a Bubble workflow

---

## Exposed States

| State              | Type    | Description                        |
|--------------------|---------|-------------------------------------|
| current_date       | date    | Currently visible date             |
| current_view       | text    | Active view (week/day/2days/etc.)  |
| current_month      | number  | Current month (1–12)               |
| current_year       | number  | Current year                       |
| clicked_date       | date    | Date of last slot click            |
| clicked_hour       | number  | Hour of last slot click            |
| selected_event_id  | text    | ID of last clicked event           |
| selected_event     | text    | Full event JSON of last click      |
| total_events       | number  | Total events loaded                |

---

## Workflow Actions

- **Refresh** — Force re-render (use after updating events)
- **Navigate** — previous / next / today
- **Change View** — week / day / 2days / 3days / 4days / 5days
- **Go to Date** — jump to any specific date

---

## Tooltip Configuration

Enable/disable individual tooltip fields in the Property Editor:
- Tooltip: Show Time
- Tooltip: Show Type
- Tooltip: Show Location
- Tooltip: Show Description

On mobile, hold the event for 500ms to show the tooltip.

---

## Debug Mode

Enable "Debug Mode" in the Property Editor to activate:
- Visual debug panel (draggable, minimizable)
- Live log feed with timestamps
- Stats: total events, this week, today
- Export logs as .txt file


**Demo Page**
https://nobubble-48765.bubbleapps.io/version-test/calendar_scheduler?debug_mode=true

**Editor Page**
https://bubble.io/page?id=nobubble-48765&tab=Workflow&name=calendar_scheduler&type=page

## Owner Name
**Gilsénio Ferreira**