=== Animata ===
Contributors: ramsthemes
Tags: anime, manga, database, api, content types
Requires at least: 6.5
Tested up to: 6.8
Stable tag: 1.0
Requires PHP: 8.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://ramsthe.me/getanimata
Plugin URI: https://ramsthemes.com/animata

The free version of the Anime Data fetcher plugin for WordPress.

== Description ==

Animata is a cutting-edge WordPress plugin designed to simplify anime data management. Seamlessly fetch and display detailed anime information using the AniList API (unofficial). Perfect for anime enthusiasts, bloggers, and database creators, Animata offers a user-friendly solution to enrich your website with accurate and up-to-date anime details effortlessly.

This free version includes poster, banner, description, status, score, and release date for anime only.  
Get the Pro version to unlock live search, more fields and taxonomies — not just for anime, but also for manga, manhwa, and novels.

== Installation ==

= Admin Installer via zip =
1. Visit the Add New plugin screen and click the "Upload Plugin" button.
2. Click the "Browse..." button and select `animata.zip` from your computer.
3. Click the "Install Now" button.
4. Once installed, activate Animata.

= Manual Installation =
1. Upload the `animata` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin via the "Plugins" screen.

== Usage ==

1. Create a new Anime post and enter the anime title or ID into the "Media Name or ID" field.
2. Press the "Go" button to fetch data from AniList. Fields like banner, poster, status, score, and description will be filled automatically.
3. When you save the post, poster and banner images are automatically downloaded and assigned as featured images.

= Using in Regular Posts =
If you'd like to insert an anime card into a regular WordPress post, use the shortcode like this:  
`[animata_mediacontent id="19"]`  
(Where `19` is the post ID of an anime post previously created.)

== Frequently Asked Questions ==

= Can I fetch manga or novels? =
The free version supports only anime. The Pro version adds manga, manhwa, and novels, live search by name, and more fields and taxonomies.

= Can I customize the layout of the anime content? =
Yes! You can override the CSS styles of the rendered content.

= Where do I find the anime name or ID? =
You can either look it up on anilist.co

== Screenshots ==

1. Admin panel on Anime post type where you search for anime data.
2. Auto-filled anime info after search.
3. Frontend view of the rendered anime card.
4. Frontend view of the rendered anime card on a common post using shortcode.

== Changelog ==

= 1.0 - MAY 2025 =
* Initial release of Animata Free Version.
* Fetches anime data from AniList API.
* Saves and renders poster, banner, description, status, score, and release date.
* Includes shortcode to embed anime cards in regular posts.

== Upgrade Notice ==

= 1.0 =
First release of Animata. Includes anime data fetching and shortcode rendering.

== External Services ==

This plugin integrates with the AniList GraphQL API to fetch anime metadata. This integration is required to automatically populate anime information when creating/updating posts.

= AniList API Integration =

* **Service Provider**: AniList (https://anilist.co)
* **What's Sent**:
  - User-provided anime title or ID
  - GraphQL query requesting specific anime metadata fields
* **When Data is Sent**:
  - When admin users manually search for anime
  - When saving/updating anime posts using AniList data
* **Data Usage**:
  - Retrieves anime metadata (titles, descriptions, images, status, scores, dates)
  - Used to populate content fields in WordPress
* **Required By Features**:
  - Anime metadata auto-population
  - Banner/poster image sourcing
  - Score/status tracking
* **Service Links**:
  - Terms of Service and Privacy Policy: https://anilist.co/terms
  - API Documentation: https://anilist.gitbook.io/anilist-apiv2-docs/

This integration only sends the minimum required data to retrieve anime information. No user or site data is stored by AniList through these API requests.