=== Publiton – Auto Publication Updater ===
Contributors: zen0nl
Tags: publications, academic, orcid, openalex, researcher
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Auto-updating academic publication lists. Enter your ORCID iD once — your list keeps itself current, powered by OpenAlex.

== Description ==

Stop copy-pasting your publication list. Publiton builds it for you and keeps it up to date, automatically.

Enter your ORCID iD (or OpenAlex author ID, or just your name) once. The plugin fetches your publications from [OpenAlex](https://openalex.org/) — the open catalog of the global research ecosystem — and renders a clean, collapsible, year-grouped list anywhere on your site via a shortcode or block. New papers appear by themselves.

**Features**

* **Zero maintenance** — the list refreshes itself (cached for 24 hours, with a resilient fallback if the API is ever unreachable).
* **Shortcode and block** — use `[publiton_publications]` or the “Publication List” block.
* **Clean, theme-friendly output** — collapsible year sections, your name highlighted, publication counts.
* **You choose what to show** — authors, journal/venue, publication date; full names or compact initials; “et al.” after as many authors as you like.
* **Real-world curation tools** — hide noise (datasets, peer reviews, errata…), hide specific titles, correct publication years for online-first papers, and add publications OpenAlex doesn’t index yet. Manual entries deduplicate automatically once OpenAlex catches up.
* **No account, no API key** — OpenAlex is free and open.

**Publiton Pro**

Upgrade to Pro for research groups and citation-conscious academics:

* **Research-group mode** — merge several OpenAlex profiles into one de-duplicated list (also handy when your own work is split across multiple OpenAlex IDs).
* **Citation stats** — a summary of total publications, citations, and your h-index, a “Cited by N” badge per paper, and a citations-per-year chart.
* **Export** — one-click BibTeX and CSV download links for your visitors.

**Why OpenAlex?**

Google Scholar has no API and blocks scrapers. ORCID only shows what authors maintain by hand. OpenAlex indexes the same literature as the commercial databases, is fully open, and stays current — the best available source for an always-up-to-date list.

== Installation ==

1. Install and activate the plugin.
2. Go to **Settings → Publications**, enter your ORCID iD (or name) and pick your author profile.
3. Add the `[publiton_publications]` shortcode or the **Publication List** block to any page.

== External services ==

This plugin relies on the **OpenAlex API** (api.openalex.org) to build the publication list. OpenAlex is a free, open catalog of scholarly works operated by OurResearch. Without this service the plugin cannot fetch publication data.

What data is sent, and when:

* When you look up your author profile on the settings page, the search input you typed (a name, ORCID iD, or OpenAlex author ID) is sent to OpenAlex to find matching author profiles.
* When the public publication list is (re)built — at most once per 24 hours, thanks to caching — the configured OpenAlex author ID is sent to fetch that author's list of works.
* Every API request also includes the contact email address configured on the settings page (it defaults to the site admin email). OpenAlex recommends this ("polite pool") to identify API users and provide faster, more reliable service. It is only shared with OpenAlex and never displayed on your site.
* All requests are made server-side. No data about your site's visitors is ever sent to OpenAlex.

Service provider: OpenAlex / OurResearch — [Terms of Service](https://openalex.org/OpenAlex_termsofservice.pdf), [Privacy Policy](https://openalex.org/OpenAlex_privacy_policy.pdf), [legal overview](https://openalex.org/legal).

== Frequently Asked Questions ==

= Where does the data come from? =

From the free and open [OpenAlex](https://openalex.org/) API. No account or API key is needed.

= A publication is missing. What can I do? =

Add it under **Settings → Publications → Manual entries**. If OpenAlex indexes it later, the plugin automatically keeps your manual version and skips the duplicate.

= A publication shows the wrong year. =

Online-first papers are sometimes filed under the year of first online appearance. Add a line under **Year corrections** like `2026 | Exact title of the paper`.

= Does it slow my site down? =

No. Results are cached for 24 hours, and if OpenAlex is ever unreachable the last successful list is shown.

== Screenshots ==

1. The rendered publication list — collapsible year sections with counts.
2. Settings: look up your author profile by ORCID iD or name.
3. Curation tools: hide work types and titles, correct years, add manual entries.

== Changelog ==

= 1.2.0 =
* New Pro tier via Freemius.
* Pro: research-group mode — merge multiple OpenAlex author profiles into one de-duplicated list.
* Pro: citation stats — publications/citations/h-index summary, per-paper “Cited by N” badge, and a citations-per-year chart.
* Pro: BibTeX and CSV export links.
* All existing features remain free.

= 1.1.0 =
* New display options: show or hide authors, journal/venue, and publication date per item.
* New author-name format option: full names or compact initials (R. Brankaert), with Dutch/German/romance name particles handled correctly.
* Configurable “et al.” cutoff for long author lists (was fixed at 12).
* The details line under each title now degrades gracefully if the stylesheet cannot load.

= 1.0.0 =
* Initial release.
