# LinkMaker Plugin

[![Version](https://img.shields.io/github/v/release/fishdan/linkmaker?label=Version&display_name=tag&sort=semver)](https://github.com/fishdan/linkmaker/releases/latest)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![WordPress](https://img.shields.io/badge/WordPress-%5E6.0-blue)](https://wordpress.org/)
[![Download](https://img.shields.io/github/v/release/fishdan/linkmaker?display_name=tag&sort=semver)](https://github.com/fishdan/linkmaker/releases/latest/download/linkmaker.zip)

<!-- ↑ Update the repo owner/name in the Download badge if this lives in a different repo. -->

One-step Wikipedia linking for WordPress: highlight text, set the link URL to `linkmaker`, publish.

---

## ✨ Features

* **Gutenberg-friendly**: link any text with the URL `linkmaker` and it becomes a Wikipedia link based on the visible text
* **Zero config**: no settings required
* **Lightweight**: tiny JS + CSS, no external calls until a user clicks
* **Theme-friendly styles** via `.wiki-search`
* Skips links that contain `github` in their `href`

---

## 🎥 Demo

[![LinkMaker demo](https://cdn.loom.com/sessions/thumbnails/12c90919d9bb4e2c84255c69624da187-a0e3e82ed5f25cee-full-play.gif)](https://www.loom.com/share/12c90919d9bb4e2c84255c69624da187)

---

## 📦 Installation

1. Copy the `linkmaker` folder into your WordPress `wp-content/plugins` directory **or** upload the ZIP via **Plugins → Add New → Upload Plugin**.
2. Activate **LinkMaker** under **Plugins → Installed Plugins**.

*(If zipping on Windows, prefer `git archive` or `tar -a -c -f linkmaker.zip linkmaker` so archive paths use forward slashes.)*

---

## 🚀 Usage

### Easiest (Gutenberg)

1. Highlight the text you want to link (e.g., `Albert Einstein`).
2. Click the **Link** button in the block toolbar.
3. Type `linkmaker` as the URL (no `http://`).
4. Publish. On the front-end, the link will go to `https://en.wikipedia.org/wiki/Albert_Einstein`.

### Classic editor / raw HTML

```html
<a href="linkmaker">Marie Curie</a>
```

This will point to:

```
https://en.wikipedia.org/wiki/Marie_Curie
```

### Multiple on a page

```html
<p>Read about <a href="linkmaker">Alan Turing</a> and <a href="linkmaker">Ada Lovelace</a>.</p>
```

---

## ⚙️ Customization (developer tips)

* **Styling**: override the `.wiki-search` rules in your theme or child theme.
* **Language**: swap `en.wikipedia.org` for another language subdomain in the JS (future admin setting planned).
* **Open in new tab**: set `target="_blank" rel="noopener"` when converting links (see roadmap).

---

## 🛣️ Roadmap / Planned improvements

* Keep **anchor semantics** (convert placeholders to real `<a href>` instead of replacing with `<span>`) for better accessibility and no-JS fallback
* **Safer selector** (opt-in via class `a.linkmaker` or attribute `[data-linkmaker]`)
* **Admin setting** for Wikipedia language and target behavior
* **Shortcode + Gutenberg block** for explicit inserts
* Conditional asset enqueue and basic tests/linting

---

## ❓ FAQ

**Why isn’t my GitHub link changing?**

Links whose `href` contains `github` are intentionally skipped so developer docs aren’t altered.

**Can I force a different article slug than the visible text?**

For now the plugin uses the visible text. A shortcode and/or attribute‑based selector is planned for custom slugs.

---

## 📬 Contact

Questions or partnership inquiries? Email [dan@fishdan.com](mailto:dan@fishdan.com).

---

## 🧾 Changelog

* **0.1.11** – Restored the Freemius menu slug to prevent admin crashes and ensure the SDK stays connected.
* **0.1.10** – Refreshed the Freemius app credentials and admin menu wiring so analytics start flowing again.
* **0.1.9** – Removed HTML from the plugin author metadata to comply with WordPress.org validation.
* **0.1.8** – Recorded the fishdan.com ownership contact and refreshed release packaging for WordPress.org review.
* **0.1.7** – Enabled the Freemius WordPress.org compatibility mode and fixed release packaging names.
* **0.1.6** – Bundled the Freemius SDK and wired it into the plugin bootstrap.
* **0.1.5** – Renamed the plugin to LinkMaker and updated release automation.
* **0.1.4** – Prepared the plugin for the WordPress.org directory and removed the custom update checker.
* **0.1.0** – Initial release.

---

## 📝 License

MIT. See `LICENSE` for details.