=== Really Simple XML and HTML Sitemap ===
Contributors: sumon086
Tags: sitemap, xml sitemap, html sitemap, seo, custom post type
Requires at least: 5.0
Tested up to: 7.1
Stable tag: 1.0.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate HTML and XML sitemaps using a shortcode or Gutenberg Block. Supports WooCommerce, custom post types, multilingual websites, and XML sitemap indexes.

== Description ==

Really Simple XML and HTML Sitemap makes it easy to generate SEO-friendly HTML and XML sitemaps for your WordPress website.

Display a customizable HTML sitemap anywhere on your website using a shortcode or the built-in Gutenberg Block. The plugin also automatically generates XML sitemaps to help search engines such as Google and Bing discover your website content.

It supports Posts, Pages, WooCommerce products, Public Custom Post Types (CPTs), and multilingual websites using WPML and Polylang. It also provides REST API endpoints for headless WordPress applications and external integrations.

Display an HTML sitemap using either:

Shortcode:

`[rsxh_sitemap]`

Or insert the **RSXH Sitemap** Gutenberg Block directly from the Block Inserter.

You can also use the shortcode in your theme templates:

`<?php echo do_shortcode( '[rsxh_sitemap]' ); ?>`

XML sitemap files are generated automatically and can be submitted to search engines to help them discover your website content.

== Free Features ==

* Generate HTML Sitemap using a Shortcode.
* Generate HTML Sitemap using a Gutenberg Block.
* Native PHP-only Gutenberg Block (no JavaScript build required).
* Customize search form spacing (margin and padding).
* Generate XML Sitemap.
* Generate XML Sitemap Index.
* Built-in REST API endpoints for sitemap data.
* Support for Posts.
* Support for Pages.
* Support for Public Custom Post Types.
* WooCommerce compatibility.
* Hierarchical content display.
* Display specific post types using shortcode or block attributes.
* Display multiple post types using shortcode or block attributes.
* Exclude specific pages from HTML sitemap.
* Exclude specific posts and custom post type entries.
* Exclude specific post types from sitemap output.
* Optional search form in HTML sitemap.
* Support for large websites through sitemap splitting.
* WPML multilingual support.
* Polylang multilingual support.
* Generate hreflang alternate language links in XML sitemaps.
* Translation ready.
* Lightweight and easy to use.

== Premium Sitemap Features ==

* Generate Image Sitemaps.
* Generate Video Sitemaps.
* Generate Category Sitemaps.
* Generate Tag Sitemaps.
* Generate Custom Taxonomy Sitemaps.
* Automatically exclude content marked as noindex by supported SEO plugins.
* Exclude non-canonical URLs from XML and HTML sitemaps.
* Yoast SEO, Rank Math SEO, and All in One SEO integration for noindex and canonical URL handling.
* Automatic Robots.txt Sitemap Integration.
* Choose sitemap storage location (Website Root Directory or Uploads Directory).

* Premium Gutenberg Block Controls:
** Display featured images.
** Display post count.
** Display last modified date.
** Sort by title, date, or modified date.
** Ascending and descending ordering.
** Collapsible content sections.
** Display search form.
** Customize block columns and responsive mobile columns.
** Customize column spacing.

* Additional XML sitemap types and advanced SEO controls for improved search engine discovery.

== Shortcode Examples ==

Display all enabled content types:

`[rsxh_sitemap]`

Display pages and posts only:

`[rsxh_sitemap post_types="page,post"]`

Display pages only:

`[rsxh_sitemap post_types="page"]`

Display posts only:

`[rsxh_sitemap post_types="post"]`

Display a specific custom post type:

`[rsxh_sitemap post_types="books"]`

Display pages and posts while excluding specific pages:

`[rsxh_sitemap post_types="page,post" exclude_pages="3,10"]`

Display all content while excluding specific pages:

`[rsxh_sitemap exclude_pages="3,10"]`

Exclude specific posts or custom post type entries:

`[rsxh_sitemap exclude_post_and_custom_post_type_posts="15,18"]`

Display a specific custom post type while excluding selected entries:

`[rsxh_sitemap post_types="facilities" exclude_post_and_custom_post_type_posts="15,18"]`

== REST API Endpoints ==

The plugin provides REST API endpoints for integrating sitemap functionality with headless WordPress applications, external services, and custom front-end frameworks.

Available endpoints:

* `/wp-json/rsxh/v1/sitemap-index` — Retrieve sitemap index information.
* `/wp-json/rsxh/v1/sitemaps` — List generated sitemap files.
* `/wp-json/rsxh/v1/html-sitemap` — Retrieve HTML sitemap data in JSON format.
* `/wp-json/rsxh/v1/generate` — Regenerate sitemap files (Administrator permission required).

== Installation ==

1. Upload the `really-simple-xml-and-html-sitemap` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Configure the plugin from the **RSXH Sitemap Settings** page in your WordPress admin area.
4. Display the HTML sitemap using one of the following methods:
   * Add the `[rsxh_sitemap]` shortcode to a page or post.
   * Insert the **RSXH Sitemap** Gutenberg Block from the Block Inserter.
   * Add `<?php echo do_shortcode( '[rsxh_sitemap]' ); ?>` to your theme template.

== Frequently Asked Questions ==

= Does the plugin generate an XML sitemap? =

Yes. The plugin automatically generates XML sitemap files and an XML Sitemap Index. Depending on your settings, sitemap files can be stored in the Website Root Directory or the WordPress Uploads Directory.

= Does it work with Custom Post Types (CPTs)? =

Yes. The plugin supports public custom post types, allowing you to include their content in your XML and HTML sitemaps.

= Can I display only pages, posts, or a specific Custom Post Type? =

Yes. You can use the `post_types` shortcode attribute to choose which content types to display.

Examples:

* `[rsxh_sitemap post_types="page,post"]` — Display pages and posts.
* `[rsxh_sitemap post_types="page"]` — Display pages only.
* `[rsxh_sitemap post_types="post"]` — Display posts only.
* `[rsxh_sitemap post_types="facilities"]` — Display a specific custom post type.

= Can I exclude specific pages, posts, or Custom Post Type entries? =

Yes. You can exclude specific content using the following shortcode attributes:

* `[rsxh_sitemap post_types="page,post" exclude_pages="3,10"]` — Display pages and posts while excluding selected pages.
* `[rsxh_sitemap post_types="page" exclude_pages="3,10"]` — Display pages while excluding selected pages.
* `[rsxh_sitemap exclude_pages="3,10"]` — Display all enabled content types while excluding selected pages.
* `[rsxh_sitemap exclude_post_and_custom_post_type_posts="15,18"]` — Exclude selected posts and custom post type entries.
* `[rsxh_sitemap post_types="post" exclude_post_and_custom_post_type_posts="15,18"]` — Display posts while excluding selected posts.
* `[rsxh_sitemap post_types="facilities" exclude_post_and_custom_post_type_posts="15,18"]` — Display a custom post type while excluding selected entries.

= Does the plugin support Gutenberg? =

Yes. The free version includes a native PHP-only Gutenberg Block that lets you insert an HTML sitemap directly from the WordPress Block Editor.

The Premium version adds additional block display options, including:

* Featured Images.
* Post Count.
* Last Modified Date.
* Sorting.
* Collapsible Sections.
* Responsive Columns and Column Spacing.

= Can the plugin exclude noindex content from XML and HTML sitemaps? =

Yes. The Premium version can automatically exclude published posts, pages, and custom post type content marked as noindex by supported SEO plugins, including Yoast SEO, Rank Math SEO, and All in One SEO.

= Can the plugin exclude non-canonical URLs from XML and HTML sitemaps? =

Yes. The Premium version provides an option to exclude content with a custom canonical URL pointing to another URL. It supports Yoast SEO, Rank Math SEO, and All in One SEO.

= Does the plugin generate Image Sitemaps? =

Yes. Image Sitemap generation is available in the Premium version.

= Does the plugin generate Video Sitemaps? =

Yes. Video Sitemap generation is available in the Premium version.

= Does the plugin generate Category, Tag, and Custom Taxonomy Sitemaps? =

Yes. Taxonomy Sitemap generation is available in the Premium version.

= Does the plugin support Robots.txt integration? =

Yes. The Premium version can automatically add sitemap information to your website's robots.txt output.

= Does the plugin provide a REST API? =

Yes. The plugin includes REST API endpoints for headless WordPress applications and external integrations.

Available endpoints include:

* Sitemap Index.
* Sitemap Files.
* HTML Sitemap Data.
* Generate Sitemap (Administrator only).

== Screenshots ==

1. Plugin settings page.
2. HTML Sitemap using the Gutenberg Block.
3. Gutenberg Block settings.
4. Gutenberg Block additional settings.
5. HTML Sitemap using the Shortcode.
6. HTML Sitemap displayed on a website.
7. XML Sitemap Index.
8. REST API – Sitemap Index endpoint output (JSON).
9. REST API – HTML Sitemap endpoint output (JSON).

== Changelog ==

= 1.0.7 =
* Added Premium option to exclude noindex content from XML and HTML sitemaps.
* Added support for noindex detection in Yoast SEO, Rank Math SEO, and All in One SEO.
* Added Premium option to exclude non-canonical URLs from XML sand HTML itemaps.
* Added support for custom canonical URL detection in Yoast SEO, Rank Math SEO, and All in One SEO.
* Minor bug fixes and code improvements.
* Updated Freemius SDK to the latest version.
* Compatibility testing with the latest WordPress version.

= 1.0.6 =
* Added REST API endpoint for Sitemap Index.
* Added REST API endpoint for listing available sitemap files.
* Added REST API endpoint for HTML Sitemap data (JSON).
* Added REST API endpoint to regenerate sitemaps.
* Added Gutenberg Block styling controls:
** Columns.
** Mobile Columns.
** Column Gap.
** Search Form Margin Top.
** Search Form Margin Bottom.
** Search Form Padding.
* Improved Gutenberg Block customization options.
* Improved HTML Sitemap post type labels.
* Minor UI improvements.
* Performance improvements.
* Code cleanup.
* Compatibility check with the latest WordPress version.

= 1.0.5 =
* Added native PHP-only Gutenberg Block for HTML Sitemap.
* Added support for inserting HTML Sitemap directly from the Block Editor.
* Added block attributes matching shortcode options.
* Added Premium Gutenberg Block controls:
** Display featured images.
** Display post count.
** Display last modified date.
** Sort by title, date, or modified date.
** Ascending and descending ordering.
** Collapsible sections.
* Improved HTML Sitemap rendering.
* Improved compatibility with WordPress Block Editor.
* Minor performance improvements and code cleanup.
* Compatibility check with the latest WordPress version.

= 1.0.4 =
* Added XML Sitemap Index generation.
* Added Image Sitemap support (Premium).
* Added Taxonomy Sitemap support for categories, tags, and custom taxonomies (Premium).
* Added Video Sitemap support (Premium).
* Added Robots.txt sitemap integration (Premium).
* Added option to choose sitemap storage location (Website Root Directory or Uploads Directory).
* Added support for large websites through sitemap splitting.
* Improved multilingual sitemap support for WPML and Polylang.
* Improved sitemap generation for custom post types and custom taxonomies.
* Enhanced plugin settings page with clearer descriptions and sitemap information.
* Fixed excluded pages and posts issue.
* Improved XML sitemap generation performance and reliability.
* Compatibility check with the latest WordPress version.

= 1.0.3 =
* Added support for multilingual plugins such as WPML and Polylang.
* Added an option to include a search form.
* Improved escaping and sanitization.

= 1.0.2 =
* Fixed an issue with an empty `exclude_post_type` parameter.
* Improved translation readiness.

= 1.0.1 =
* Added scheduled XML sitemap generation using `wp_schedule_event`.

= 1.0.0 =
* Initial release of Really Simple XML and HTML Sitemap.