=== Ascended Masters Library ===
Contributors: ascendedmasterslibrary
Tags: library, public domain, esoteric, occult, mysticism, comparative religion, embed
Requires at least: 5.8
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Put pages and volumes from the Ascended Masters Library on your site. Free, no account, no key, nothing recorded.

== Description ==

The Ascended Masters Library (https://ascendedmasterslibrary.org) is a free library of public-domain and freely licensed esoteric, mystical, occult and comparative-religion texts: thousands of volumes, every page readable, searchable and citable, with no advertising and no accounts.

This plugin lets a WordPress site show any page of any volume, frame the library's own reader, or link to a page by number.

**Shortcodes**

* `[aml_page id="182" page="12"]` prints the text of page 12 of volume 182 (The Book of Enoch, Charles's translation) on your page, with a line saying where it is from.
* `[aml_book id="182" page="1" height="640"]` frames the library's reader for the volume, so visitors can turn its pages without leaving your site.
* `[aml_link id="182" page="12"]Enoch on the Watchers[/aml_link]` makes a link to that page; leave the text empty and the volume's title is used.

**Block**

The "Library volume" block (in the Embeds group) does the same from the editor, with a live preview.

**Where the id comes from**

Every volume's address at the library ends in its id: https://ascendedmasterslibrary.org/#/b/182 is volume 182. Browse by subject at https://ascendedmasterslibrary.org/browse/ to find one.

**What the plugin does and does not do**

It fetches two small public JSON files from the library (a volume's description and the chunk holding the page) and caches each for one hour. The library asks that a volume it withdraws on rights grounds vanish within an hour, and this plugin keeps to that. Nothing about your visitors is sent anywhere. There are no settings, no keys and no accounts.

A few volumes are in copyright and released by their authors for free distribution on terms that must travel with the text; the plugin prints that notice above such a page.

== Installation ==

1. Upload the `ascended-masters-library` folder to `/wp-content/plugins/`, or install the zip from Plugins → Add New → Upload.
2. Activate it.
3. Use a shortcode or the "Library volume" block.

== Frequently Asked Questions ==

= Is the text really free to reuse? =

Yes. The library holds only public-domain texts and a small number of freely licensed ones, and it prints the licence on those. The plugin's source line, with its link, is the courtesy the library asks for.

= Can I search the library from my site? =

Not through this plugin. The search index is public JSON at the library and is described at https://ascendedmasterslibrary.org/webmasters/ for anyone who wants to build on it.

== Changelog ==

= 1.0.0 =
* First release: aml_page, aml_book and aml_link shortcodes, and the Library volume block.
