=== Memora Board ===
Contributors:      alhussam
Tags:              memory wall, drawing canvas, event, wedding, guest book
Requires at least: 6.5
Tested up to:      7.0
Requires PHP:      8.0
Stable tag:        2.0.0
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Let your guests draw heartfelt messages at weddings, graduations & events — displayed in a beautiful interactive slider.

== Description ==

**Memora Board** turns any WordPress page into a live memory wall. Guests freely draw messages with their finger or mouse — no account needed — and see everyone's contributions displayed in a smooth, real-time slider.

Perfect for **weddings**, **graduation parties**, **corporate events**, **birthdays**, and any occasion where you want guests to leave a lasting mark.

Memora Board is fully functional, free and open source — no trial, no time limit, no locked features.

**Drawing canvas**
* Freehand drawing with mouse and touch (mobile & tablet ready)
* Eraser, undo (up to 40 steps), and clear tools
* Choose which toolbar buttons are shown: colour swatches, size, eraser, undo, clear
* Optional name field so guests can sign their drawing

**Display**
* Horizontal slider — a smooth left-to-right strip showing drawings side by side
* Configurable items-per-view, or a true Infinite / Marquee continuous loop
* Toggle navigation arrows on the slider and inside the lightbox
* Click any drawing to open it full-screen in the lightbox, with swipe and keyboard navigation (arrow keys, Escape) and an author name/counter display

**Boards & moderation**
* Unlimited memory boards
* Per-board moderation: **Auto-approve**, **Manual review**, or **Disabled**
* Approve, reject, or delete individual entries with thumbnail preview
* New approved submissions appear live on the display without a page refresh

**Editors & languages**
* Native **Gutenberg blocks** and **Elementor widgets**
* Full **Arabic (RTL)** and **English** support built-in, ready for community translation via translate.wordpress.org

= Demo & Pro Version =
View the demo here and explore professional features:
* [Live Demo](https://shop.alhussam.net/memora-board/) - Test the plugin live.
* [Upgrade to Pro](https://shop.alhussam.net/product/memora-board-pro/) - Get advanced features.

== Installation ==

= Automatic Installation =
1. Go to **WordPress Admin → Plugins → Add New**
2. Search for "Memora Board"
3. Click **Install Now**, then **Activate**

= Manual Installation =
1. Download the plugin ZIP from this page
2. Go to **WordPress Admin → Plugins → Add New → Upload Plugin**
3. Upload the ZIP and activate

= First Steps =
1. Go to **Memora Board → Boards → Create New Board**
2. Choose your moderation setting (Auto-approve recommended for live events)
3. Add the **Memora – Drawing Canvas** block/widget to your event check-in page
4. Add the **Memora – Display Board** block/widget to your presentation/display screen
5. Publish both pages and you're live!

= For Events =
* Open the drawing page on a tablet at the venue entrance
* Open the display page on your presentation screen or TV
* Set moderation to **Auto-approve** for instant live display
* Turn on the **Infinite / Marquee Loop** for a continuous, news-ticker-style display
* Sit back and watch the wall fill up

== Frequently Asked Questions ==

= Do guests need to create an account? =
No. Submissions are completely anonymous. There is an optional name field, but no registration or login is required at any point.

= Can I moderate entries before they go live? =
Yes. Each board has its own moderation setting. Choose **Manual review** to approve each drawing before it appears on the display. Use **Auto-approve** for live events where you want instant display.

= Does it work with Elementor? =
Yes. Both the Drawing Canvas and Display Board are available as native Elementor widgets in the General category.

= Does it work with the Gutenberg Block Editor? =
Yes. Both widgets are available as native Gutenberg blocks. Search for "Memora" in the block inserter.

= How do I display the wall on a big screen at my event? =
1. Create a page with the Display Board widget
2. Choose Horizontal Slider mode
3. Turn on the Infinite / Marquee Loop for a continuous ticker, or set autoplay for a paged slider
4. Open that page in full-screen mode on your event display or TV (press F11)

= Does it work on mobile? =
Yes. The drawing canvas is fully touch-enabled with pressure-sensitive drawing. It works on iOS Safari, Android Chrome, and all major mobile browsers.

= How many boards can I create? =
As many as you like — there is no limit on the number of memory boards.

= What browsers are supported? =
All modern browsers: Chrome, Firefox, Safari, Edge. IE is not supported.

= Is the plugin translation-ready? =
Yes. All text in the plugin is fully translatable, with proper RTL support for right-to-left languages like Arabic. Once the plugin is live on WordPress.org, translations are contributed and managed through translate.wordpress.org and delivered automatically — no files to install.

== Screenshots ==

1. **Drawing Canvas** — Guests draw freely with pen size controls and eraser
2. **Horizontal Slider** — Slider with navigation arrows and autoplay
3. **Infinite / Marquee Loop** — Continuous news-ticker-style display
4. **Lightbox** — Full-screen viewer with navigation
5. **Admin Boards** — Manage boards with statistics
6. **Admin Entries** — Approve, reject or delete submissions with previews
7. **Elementor Widget** — Native Elementor integration
8. **Gutenberg Block** — Native Block Editor integration

== Changelog ==

= 2.0.0 =
* First public release

== Upgrade Notice ==

= 2.0.0 =
First public release.

== Privacy Policy ==

Memora Board stores the following data in your WordPress database:
* **Drawings** — stored as base64-encoded PNG data in the `wp_memora_entries` table
* **Author names** — optional, stored if the guest chooses to enter one
* **IP addresses** — stored for spam prevention, never transmitted externally

Guest submissions are never sent off your site. Memora Board does not connect to any external service.

Users may request deletion of their submissions by contacting the site administrator.
