=== WM Downloads ===
Contributors: webmasterstudios
Tags: downloads, files, documents, download manager, library
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Download manager for WordPress — files and external links, categories, search/sort list, latest widget, CSV import.

== Description ==

**WM Downloads** is a free download manager for WordPress, equivalent to the Joomla 6 WM Downloads package.

= Features =

* File uploads or external links
* Hierarchical download categories
* Secure file storage (not direct public URLs)
* Download endpoint with hit counting
* Publishing window (start / finish)
* Front-end list via shortcode with search and sort
* Subcategory filter
* Latest downloads widget
* CSV import for bulk records

= Shortcode =

`[wmdownloads category="my-category-slug"]`

Optional attributes:

* `category` — category slug or ID (include children)
* `show_author` — 1/0 (default 1)
* `show_date` — 1/0 (default 1)
* `show_size` — 1/0 (default 1)
* `show_hits` — 1/0 (default 1)
* `show_category` — 1/0 (default 1)
* `show_title` — 1/0 (default 0) show category title/description
* `limit` — max items (0 = all)

= Quick start =

1. Upload and activate the plugin.
2. Go to **WM Downloads → Categories** and create categories.
3. Add downloads under **WM Downloads → Add New** (file or link).
4. Place `[wmdownloads category="your-slug"]` on a page.
5. Optional: add the **WM Downloads — Latest** widget.
6. Optional: **WM Downloads → CSV Import** for bulk items (files must already be in `wp-content/uploads/wmdownloads/`).

After activation, visit **Settings → Permalinks** and click Save once (flushes rewrite rules for `/wmd-download/{id}/`).

== Installation ==

1. Upload the `wmdownloads` folder to `/wp-content/plugins/`
2. Activate through the Plugins screen
3. Save Permalinks once

== Frequently Asked Questions ==

= Where are files stored? =

In a protected folder: `wp-content/uploads/wmdownloads/` with deny rules for direct access. Files are served via the plugin download URL.

= Does it use normal WordPress posts? =

No. It uses a custom post type `wmd_download` and taxonomy `wmd_download_category`.

== Changelog ==

= 1.0.0 =
* Initial free release for WordPress (feature parity with WM Downloads Joomla package).

== Upgrade Notice ==

= 1.0.0 =
Initial release.
