# wow_item

Provides WoW item data for the Drupal WoW suite.

## Overview

This module manages two complementary data layers:

- **Item classes** (`wow_item_class` taxonomy): ~20 top-level categories
  (Weapon, Armor, Consumable, etc.) with named subclasses. Synced from the
  Blizzard static API index on demand.
- **Individual items** (`wow_item` entity): Hundreds of thousands of items
  identified by Blizzard ID. No index endpoint exists — items are fetched
  one at a time, on-demand, when referenced by achievements or other data.

## Quick Start

1. Enable the module: `drush en wow_item`
2. Sync item classes: `drush wow:sync-item-classes`
3. Individual items are looked up automatically when needed, or manually
   via: `drush wow:item-lookup <id>`

## Drush Commands

| Command | Alias | Description |
|---------|-------|-------------|
| `wow:sync-item-classes [region]` | `wsic` | Sync item class taxonomy from Blizzard API |
| `wow:item-lookup <id> [region]` | `wil` | Look up a single item by Blizzard ID |

Pass `--force` to `wow:sync-item-classes` to bypass the 304 cache check.

## Data Source

All data originates from the Blizzard Game Data API (static namespace).
The 30-day TTL requirement applies: `last_fetched` timestamps are stored
on every item entity to support future staleness detection.
