=== Smart Notice Board ===
Contributors: rhfarukh, freemius
Tags: notice, notices, notice board, announcement, bulletin
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Publish notices as a custom post type and display them in configurable grids using shortcodes.

== Description ==

**Smart Notice Board** adds a **Notices** custom post type so you can create announcements like normal WordPress posts (title, content, excerpt, featured image). You then place a **shortcode** on any page to show a responsive grid: icons, excerpts, dates, **pagination**, or **load more**.

**Here are the Demos:**

[View live Notice Board demos](https://demos.orviansoft.com/notice-board-demos/)

**Support:**

[Get support at Orvian Soft](https://orviansoft.com/get-support/)

= What you get (free) =

* Custom post type `rzcnb_notice_board` with optional single template under `templates/`.
* Hierarchical **Notice categories** taxonomy (`rzcnb_notice_category`).
* **Shortcode builder** under the notices admin menu: create multiple saved configurations (stored in the `rzcnb_custom_shortcodes` option).
* Shortcode: `[rzcnb_notice_board id="X"]` — **X** is the id of a saved configuration listed on **All Shortcodes** (you create configs with **Create Shortcode**; nothing is auto-created on install).
* **Grid layout**: separate column counts for desktop, tablet, and mobile.
* **Style presets** plus detailed styling (colors, padding, border radius, typography for title/excerpt).
* **Pagination** or **AJAX load more** (mutually exclusive; configurable batch sizes per breakpoint).
* Optional **sort order** (orderby whitelist + ASC/DESC).

= Premium / Freemius =

Paid tiers (when licensed via Freemius) can unlock additional behaviour such as advanced layout locks, scheduling, role-based visibility, and email notifications. See your pricing page and in-plugin upgrade prompts for the current split.

= How to use (from scratch) =

1. Install and activate the plugin.
2. Open **Notice Board → Create Shortcode** (or **Add New Shortcode**), set up your board, and save. It will appear on **All Shortcodes** with a numeric **id** and the full shortcode ready to copy.
3. Create notices with **Notice Board → Add New** (or **Notices** in the menu). Use the **Excerpt** for the short text shown in the grid when excerpts are enabled.
4. Assign **Notice categories** if you want to filter this board by category (use matching slugs in the shortcode configuration).
5. Edit any page (or use a Shortcode block) and insert `[rzcnb_notice_board id="X"]`, replacing **X** with the id from **All Shortcodes**.
6. If pagination or load more misbehaves after changing permalinks, visit **Settings → Permalinks** and click **Save** once to flush rewrite rules.

== Installation ==

1. Install the plugin (upload the folder to `/wp-content/plugins/` or use **Plugins → Add New** in the admin) and activate it.
2. On activation the plugin registers the **Notices** post type and **Notice categories**; it does **not** create a default shortcode. Add at least one board under **Notice Board → Create Shortcode**, then use the id from **All Shortcodes** in `[rzcnb_notice_board id="X"]` on any page.
3. Publish notices so your board has content to show.

== Frequently Asked Questions ==

= How do I get support? =

[Get support at Orvian Soft](https://orviansoft.com/get-support/)

Open our support page and use the form to contact us.

= What should I include so you can help quickly? =

* Your **website URL**
* **Product** type (WordPress Theme / WordPress Plugin / React / NextJS Theme) and the second dropdown when it appears — choose this plugin (**Smart Notice Board**)
* **Order ID**, if you have one
* **Board / shortcode ID** from WordPress admin: **Notice Board → All Shortcodes** — the shortcode looks like `[rzcnb_notice_board id="123"]`; the number is the ID
* A clear **subject** and **description** of the issue
* **Screenshots** or a small export (the support form accepts common image types, PDF, or ZIP up to 10 MB)

= Can I show only one category? =

Set the category field when editing a shortcode configuration (comma-separated slugs if you need more than one).

= Where are shortcodes stored? =

Board configurations are saved in your WordPress database (option `rzcnb_custom_shortcodes`). Manage them under **Notice Board → All Shortcodes** and **Create Shortcode** — you do not need to edit the database directly.

== Screenshots ==

1. Notice grid on the front end.
2. Shortcode list and editor in the admin.

== Changelog ==

= 1.0.0 =
* Initial release on WordPress.org track.
