# Link Extension for XFN - User Documentation

Welcome to the Link Extension for XFN documentation! This plugin makes it easy to add XFN (XHTML Friends Network) relationship metadata to any link in your WordPress site.

![XFN Link Extension interface showing collapsible relationship sections with button groups for selecting friendships, professional connections, and other XFN categories, plus visual pills displaying active relationship selections](../.wordpress-org/screenshot-1.png)

*The XFN interface allows you to easily add semantic relationship metadata to any link in WordPress using organized, collapsible sections with visual feedback.*

## What is XFN?

XFN (XHTML Friends Network) is a simple way to represent human relationships using hyperlinks. By adding XFN relationships to your links, you can indicate how you're connected to the people and organizations you link to, creating a more semantic and meaningful web.

## Documentation Overview

This documentation is organized by link type:

### ⚙️ [Plugin Settings](settings.md)
Configure where XFN options appear in your editor (Inspector sidebar, floating toolbar, etc.)

### 📝 [Paragraph Links](paragraph-links.md)
Learn how to add XFN relationships to links within paragraphs, headings, lists, and other text blocks.

### 🔘 [Button Links](button-links.md)
Add XFN relationships to Button blocks for calls-to-action and navigation elements.

### 🖼️ [Image Links](image-links.md)
Apply XFN relationships to clickable images and featured images.

### 🔗 [Other Block Links](other-block-links.md)
Use XFN with Navigation blocks, Site Logo, Post Titles, and more.

## Quick Start

1. **Select or create a link** in any block
2. **Look for the XFN options** in one of two places:
   - **Link Advanced Panel** (inline links) - Always available in the link popover
   - **Inspector sidebar** (Button/Image/Navigation blocks) - Enable in Settings → Link Extension for XFN
3. **Choose your relationships** from the available categories
4. **Click Apply or Update** to save

## XFN Relationship Categories

### Friendship
- **Contact** - Someone you know how to get in touch with
- **Acquaintance** - Someone you've met but don't know well
- **Friend** - Someone you consider a friend

### Physical
- **Met** - Have you met this person in real life?

### Professional
- **Co-worker** - Someone you work with
- **Colleague** - Someone in your professional network

### Geographical
- **Co-resident** - Someone you live with
- **Neighbor** - Someone who lives near you

### Family
- **Child** - Your child
- **Parent** - Your parent
- **Sibling** - Your brother or sister
- **Spouse** - Your husband or wife
- **Kin** - Other family relation

### Romantic
- **Muse** - Someone who inspires you
- **Crush** - Someone you have a crush on
- **Date** - Someone you're dating
- **Sweetheart** - Your sweetheart or partner

### Identity
- **Me** - This link points to your own content on another site

## Common Use Cases

- Link to your portfolio sites with `rel="me"`
- Link to coworkers with `rel="colleague met"`
- Link to friends with `rel="friend met"`
- Link to family members with `rel="sibling"`
- Link to your spouse with `rel="spouse sweetheart met"`

## Need Help?

- Check the specific documentation for your link type
- Visit the [WordPress.org support forum](https://wordpress.org/support/plugin/link-extension-for-xfn/)
- Report issues on [GitHub](https://github.com/courtneyr-dev/link-extension-for-xfn/issues)

## Learn More About XFN

- [XFN 1.1 Specification](http://gmpg.org/xfn/)
- [Microformats Wiki](http://microformats.org/wiki/xfn)