=== maca DownList ===

Contributors: macas

Tags: downloads, files, file list, documents, secure downloads

Requires at least: 6.0

Tested up to: 7.0

Requires PHP: 7.4

Stable tag: 1.6.13

License: GPLv2 or later

License URI: https://www.gnu.org/licenses/gpl-2.0.html



File download lists with thumbnails, shortcode, and block. Grid or list layout from maca development.



== Description ==



Developed by [maca development](https://maca.se/).



maca DownList helps you publish **downloadable file lists** on your WordPress site. Organize files into lists, show them in a grid or list layout, and let visitors download files through tracked links.



Unlimited lists, Media Library files, shortcode and block, PDF view/download buttons, and an opt-in front-end credit line. More information: [maca DownList](https://maca.se/maca-downlist/).



= Features =



* **Unlimited** file lists

* Unlimited **files** with title, description, manual thumbnail, and download file (Media Library)

* **File type** label with icon on the front end

* Optional **More information** link per file

* **PDF** files: **View** (browser) and **Download** buttons

* **Download counts** in admin (Files and Lists)

* Media Library picker for download files and thumbnails in admin

* **Grid** or **list** layout (default under **maca DownList → Settings**)

* Shortcode: `[maca_downlist list="your-list-slug"]` or `[maca_downlist]` to show all lists grouped

* **maca DownList List** Gutenberg block

* List display heading and intro text per list

* Built-in multilingual **user guide** in admin (eight languages)

* Admin and front-end translations: English, Swedish, Danish, Norwegian (Bokmål), Finnish, German, French, Spanish

* Optional **Powered by maca DownList** credit on front-end lists (opt-in under Settings)



= Pro version =



This WordPress.org package is the **free, fully functional** maca DownList — unlimited lists and files, with no license check.



**maca DownList Pro** is a separate plugin (download from [maca DownList Pro](https://maca.se/maca-downlist-pro/)) with advanced delivery and admin features. License activation is not included in this WordPress.org build (WordPress.org policy).



**Included in this free plugin:**



* Unlimited file lists and unlimited files

* Shortcode and **maca DownList List** Gutenberg block

* Show all lists on one page (`[maca_downlist]` or `list="all"`)

* Grid or list layout, PDF View + Download, manual thumbnails

* Simple download counts in admin (Files and Lists)

* Media Library storage, list heading and intro text, built-in user guide (eight languages)

* **Powered by maca DownList** credit is opt-in and **off by default** (leave unchecked in Settings to hide it)



**Pro adds** (separate download — see comparison on [maca DownList Pro](https://maca.se/maca-downlist-pro/)):



* Automatic thumbnails for image and video files

* Built-in video player (stream in the list)

* Protected file storage (in addition to Media Library)

* Custom download and information link styling (colors, hover, font)

* Guest comments and CAPTCHA (reCAPTCHA / Cloudflare Turnstile)

* Access restrictions (IP / country blacklist)

* Full download log (IP, country, action) — free shows simple download counts only

* File versioning

* Configurable max upload size

* Pro support in wp-admin



= Privacy and external services =



Files are stored in the WordPress Media Library. Download links are handled on your site.



On activation, deactivation, and uninstall, the plugin may send a small lifecycle event to api.maca.se (site URL, plugin/WordPress/PHP version, locale). Optional deactivation feedback from the Plugins screen is sent the same way. No license checks and no visitor download content. maca Hub status endpoints only respond when maca Sec provides a site key (optional companion plugin).



== Installation ==



1. Upload the `maca-downlist` folder to `/wp-content/plugins/` or install via **Plugins → Add New**.

2. Activate the plugin through the **Plugins** menu.

3. Create lists under **maca DownList → Lists**.

4. Add files under **maca DownList → Add New**: title, description, thumbnail, download file, and assign at least one list.

5. Review **maca DownList → Settings** (default layout and optional front-end credit).

6. Place `[maca_downlist list="your-list-slug"]` on a page or use the **maca DownList List** block.



== Frequently Asked Questions ==



= What is included in this plugin? =



Unlimited lists, unlimited files, manual thumbnails, Media Library storage, grid/list layout, shortcode and block (single list or all lists), PDF view/download buttons, simple download counts in admin, and the built-in guide.



= How do I show a list on a page? =



Use `[maca_downlist list="brochures"]` where `brochures` is your list slug, or add the **maca DownList List** block. To show **every list** on one page, use `[maca_downlist]` or `list="all"`.



= Can a file belong to multiple lists? =



Yes. Assign multiple lists when editing a file.



= How do I change the layout? =



Add `layout="list"` or `layout="grid"` to the shortcode, or choose layout in the block. The default is under **maca DownList → Settings**.



= How do I upload or replace a download file? =



Edit a file under **maca DownList → Files** and use **Select file** or **Replace file** (WordPress Media Library).



= Does this plugin phone home? =



Lifecycle events (activate / deactivate / uninstall) and optional deactivation feedback go to api.maca.se to help improve the product. Download files and visitor traffic stay on your site. This WordPress.org build does not validate licenses.



= How do PDF files behave on the front end? =



PDF downloads show **View** and **Download** buttons. Other file types show a single download button unless customized.



= Is there a Pro version? =



Yes. **maca DownList Pro** adds video playback, download logging, guest comments, access restrictions, custom link styling, protected storage, and more. It is a **separate plugin** from [maca DownList Pro](https://maca.se/maca-downlist-pro/) — not installed from WordPress.org.



= Can I activate a Pro license in this plugin? =



No. WordPress.org does not allow paid license activation in the directory package. Install **maca DownList Pro** from maca.se after purchase; your lists and files in the database are kept when you switch.



== Screenshots ==



1. File list on the front end (list layout)

2. Edit file screen in wp-admin (Media Library file and thumbnail)

3. maca DownList Settings (default layout and optional front-end credit)

4. maca DownList Lists page with shortcode copy field

5. maca DownList guide page



== Changelog ==

= 1.6.12 =

* Admin: download counts on Files list (sortable), Lists page, and list taxonomy screen.
* PDF View vs Download: honor view (inline) and force-download (attachment) intents.
* Wire activation and deactivation telemetry hooks; document api.maca.se in Privacy and FAQ.
* Block inspector: Maximum number of files (limit) control.
* Pro product URL constant points to maca DownList Pro; credit line keeps free product page.

= 1.6.11 =

* API telemetry: resolve the public site URL from proxy headers and request host when WordPress home URL points at loopback (same as maca Njuvs and Maca Tjatt).
* Activation telemetry is deferred to shutdown so URL resolution runs after WordPress is fully loaded.

= 1.6.10 =

* Activation, deactivation, and uninstall telemetry to api.maca.se (same pattern as maca Restu and Maca Tjatt).
* Deactivation feedback modal now reports to api.maca.se instead of email.

= 1.6.9 =

* maca Hub: REST status endpoints and Hub Connector integration (uses maca Sec site key; download log and license activation remain Pro-only).

* Admin: warning on the file edit screen when the download file is missing or unreadable.

* Front end: disabled Download button with explanation when the file is unavailable.



= 1.6.8 =

* Plugins screen: deactivation feedback modal (optional reason + email to maca) before deactivate, same flow as maca Restu.



= 1.6.7 =

* Plugins screen: **GET PRO** link (bold, after Deactivate) to maca DownList Pro (https://maca.se/maca-downlist-pro/).



= 1.6.6 =

* Detect missing or unreadable download files (removed from Media Library or missing on disk).

* Admin warnings on the Files list and File Details screen; front end shows a disabled Download button with an explanation instead of a broken link.



= 1.6.5 =

* Settings: discreet link to maca DownList Pro (maca.se/maca-downlist-pro/).

* Readme: Free vs Pro comparison for WordPress.org listing (credit line is opt-in/off by default in free version).



= 1.6.4 =

* Readme: Free vs Pro comparison; product pages https://maca.se/maca-downlist/ and https://maca.se/maca-downlist-pro/

* Plugin URI and credit link point to product page.



= 1.6.3 =

* Plugin Check: remove discouraged load_plugin_textdomain(), prefix template variables, phpcs for GET redirects and tax_query, remove unused templates.



= 1.6.2 =

* Fix: load plugin translations in admin (Lists page and settings now respect site/user locale).

* Readme screenshots updated for org-only features; default file icon SVG escaped on the front end.



= 1.6.1 =

* Remove commercial section from Settings admin page (org build).



= 1.6.0 =

* WordPress.org review: remove trialware (no list limits, no license code in this package)

* Prefixed post type `maca_downlist_file` and taxonomy `maca_downlist_list`; migrate legacy `sf_*` data

* Tracked download query args use `maca_downlist_download` / `maca_downlist_nonce`

* Media Library only for files; simplified settings; readme and uninstall updated



= 1.5.3 =

* Fix shortcode [maca_downlist] not running when copied from Lists (register on init; normalize smart quotes).



= 1.5.2 =

* Fix fatal error: undefined Maca_Downlist_PLUGIN_URL (restore MACA_DOWNLIST_* constants).



= 1.5.0 =

* Renamed to maca DownList (slug maca-downlist); formerly mc-smartfiles



= 1.4.1 =

* Plugin renamed to maca DownList; directory slug mc-smartfiles (WordPress.org)



= 1.4.0 =

* WordPress.org review: org build has no license-locked features; front-end credit opt-in



= 1.3.3 =

* Plugin header: distinct Plugin URI (product page) and Author URI (developer site) for WordPress.org



= 1.3.2 =

* Plugin Check: remove proc_open, fix CAPTCHA script versions, shorter readme description, WP_Filesystem for debug log



= 1.3.1 =

* WordPress.org Plugin Check: readme tested up to 7.0, custom updater excluded from distribution zip, i18n and script enqueue fixes



= 1.3.0 =

* Lists: custom maca DownList admin page for creating lists (avoids WordPress edit-tags.php POST issues on some hosts); edit-tags overview redirects here



= 1.2.0 =

* Fix: earlier output buffering for list create; flush buffer on core redirect; admin “site check” URL to compare hosts



= 1.1.9 =

* Fix: output buffering on list create so PHP notices do not break the admin redirect (headers already sent)



= 1.1.8 =

* Fix: list add handler no longer depends on `$pagenow` (fixes blank screen on some hosts); optional list-add debug log when `WP_DEBUG` is on



= 1.1.7 =

* Fix: creating a list in admin (handles add-tag before HTML output; clean wp_insert_term args, no full $_POST)



= 1.1.6 =

* Fix: creating a list in admin no longer shows a blank page (uses WordPress default add-tag flow)



= 1.1.5 =

* Drag-and-drop upload for download files and thumbnails in admin

* File type label with icon shown under file description on the front end

* User guide updated in all eight languages



= 1.1.0 =

* List layout: thumbnail, content, and actions in one row; grid layout improvements

* Optional list display heading and intro text

* Shortcode/block: show all lists grouped (`[maca_downlist]` or `list="all"`)

* Full-width / block theme wrapper classes

* Admin user guide in eight languages (profile language)

* Front-end and admin translations: Swedish, Danish, Norwegian, Finnish, German, French, Spanish

* Powered-by footer credit on file list output (opt-in in Settings)



= 1.0.0 =

* Initial release



== Upgrade Notice ==

= 1.6.12 =

Download counts in admin, working PDF View/Download, block limit control, and clearer privacy docs.

= 1.6.11 =

Improves public site URL detection for api.maca.se telemetry on proxied or loopback hosts.

= 1.6.10 =

Activation/deactivation/uninstall telemetry via api.maca.se; deactivation feedback sent to API instead of email.

= 1.6.9 =

maca Hub integration; clearer handling when download files are missing.



= 1.6.8 =

Deactivation feedback modal on the Plugins screen.



= 1.6.7 =

Plugins screen: bold GET PRO link to maca DownList Pro.



= 1.6.6 =

Warns when download files are missing; front-end download button disabled with message instead of broken link.



= 1.6.5 =

Readme Pro comparison; optional Pro link on Settings page.



= 1.6.4 =

Readme and plugin URI updated; product page at maca.se/maca-downlist.



= 1.6.3 =

Plugin Check compliance fixes.



= 1.6.2 =

Fixes missing Swedish (and other) translations in wp-admin.



= 1.6.1 =

Settings page simplified (org build).



= 1.6.0 =

WordPress.org compliance: full feature set in this package; no trialware.



= 1.5.0 =

Renamed to maca DownList (slug maca-downlist); formerly mc-smartfiles.



= 1.4.1 =

Renamed to maca DownList (slug mc-smartfiles) for WordPress.org directory.



= 1.4.0 =

WordPress.org compliance: no trialware in directory build, opt-in front-end credit.



= 1.3.3 =

Header URIs fixed for WordPress.org plugin review.



= 1.3.2 =

Further Plugin Check fixes (FFmpeg, CAPTCHA enqueue, readme length).



= 1.3.1 =

Compatibility and Plugin Check fixes for WordPress.org submission.



= 1.3.0 =

Lists screen uses a dedicated admin page for adding lists (same pattern as Settings).



= 1.2.0 =

Further fix for list-create redirect issues; site check tool for comparing installations.



= 1.1.9 =

Fix for “headers already sent” when creating a list in admin on some hosts.



= 1.1.8 =

Fix for blank admin screen when adding a list on some server configurations.



= 1.1.7 =

Fix for blank admin screen when adding a new list.



= 1.1.6 =

Fix for blank admin screen when adding a new list.



= 1.1.5 =

Readme and user guide updates.



= 1.1.0 =

Comments, auto thumbnails, download tracking, link appearance settings, and expanded translations.



= 1.0.0 =

Initial release.

