Feature: Links #

Web link directory organised by families. Automatic metadata extraction (title, description) from URLs, image upload per link, distinction between public and private links.

---

Installation and Configuration #

Via FTP: Upload the `links/` directory into `/plugins/`.

Via package manager: Select `links` from the available plugins list.

Paths:

• Main plugin: `/plugins/links/links.php`
• Configuration: `/plugins/links/conf/links.conf.inc.php`
• Locales: `/plugins/links/locale/`

Required SQL tables: `links`, `links_families`

Image storage directory: `$cfg[6]/Links/`

---

Usage #

Browsing #

• List of link families
• List of links within a family (with image, title, description, URL)

Administration #

• Families: create, edit, delete categories
• Links: create a link with automatic metadata extraction from the URL

- The plugin calls `GetURLInfo()` to retrieve the title and description from the page's `<meta>` tags

- Optional upload of a representative image/logo

- Public/private toggle

Exposed functions:

• `GetURLInfo(string $url)` — URL metadata extraction
• `uploadLinkImage()` — link image upload and resizing
• `unlinkLinkImage()` — link image deletion

---

Hooks and Entry Points #

?obj=links.php                           — Family list
?obj=links.php&family=ID                 — Links in a family
?obj=links.php&action=new                — Create a link (POST)
?obj=links.php&action=edit&id=ID         — Edit a link
?obj=links.php&action=delete&id=ID       — Delete a link
?obj=links.php&action=add_family         — Create a family

---

Dependencies #

• `Beamreactor\Database\SQL`
• `Beamreactor\Sanitizer\Parser`
• PHP cURL extension or `file_get_contents` — for URL metadata extraction
• Internal graphics library — link image thumbnails