=== Indepth Analytics ===
Contributors: inkylab
Tags: structured data, metadata, taxonomy, seo, polylang
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds structured metadata tags and optional header scripts to WordPress pages.

== Description ==

Indepth Analytics adds structured metadata tags to the `<head>` section of WordPress pages. The plugin outputs information about posts, pages, taxonomy archives, and search pages using custom `indepth:*` meta properties.

The plugin can also load an optional external header script configured by administrators from the WordPress dashboard.

Supported metadata includes:

* Post or page ID
* Content type and post type
* Publication date
* Estimated reading time
* Featured image URL
* Categories and taxonomy terms
* Authors and author avatars
* Collaborators and collaborator avatars
* Current language
* Available translations when using Polylang

The plugin works with standard WordPress APIs and follows WordPress coding and security practices.

Features:

* Outputs `indepth:*` metadata tags in the document head
* Supports posts, pages, archives, and search results
* Optional taxonomy selection for category metadata
* Optional external header script loader
* Compatible with Polylang translations
* Translation-ready
* Compatible with PHP 8.2 and newer

== Installation ==

1. Upload the `inkylab-indepth` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Open **Settings → Indepth Settings**.
4. Select the taxonomies to include in metadata output.
5. Optionally configure a header script URL.

== Frequently Asked Questions ==

= Where are the metadata tags added? =

The plugin outputs metadata tags inside the `<head>` section using the `wp_head` action.

= Does the plugin require Polylang? =

No. Polylang support is optional. Translation metadata is only added when Polylang is active.

= How is reading time stored? =

Reading time is loaded from the `inkylab_indepth_reading_duration` post meta field.

= How are additional authors supported? =

Additional authors can be stored in the `inkylab_indepth_authors` post meta field as an array of user IDs.

= How are collaborators stored? =

Collaborators are stored in the `inkylab_indepth_contributions` post meta field.

= Is the external script URL sanitized? =

Yes. The URL is sanitized and validated before saving.

= What PHP version is required? =

PHP 8.2 or newer.

== Screenshots ==

1. Indepth Settings screen with taxonomy configuration options.

== Changelog ==

= 1.0.0 =

* Initial release.
* Added structured metadata output for WordPress content.
* Added taxonomy metadata support.
* Added optional external header script support.
* Added Polylang translation support.
* Added translation-ready language files.

== Upgrade Notice ==

= 1.0.0 =

Initial public release.