## At a glance

Portfolio projects with categories and tags, ready for the block editor or your preferred page builder. Your theme controls presentation. No custom front-end scripts, gallery engine or required field plugin.

- Quick start under Settings → Portfolio Content and Portfolio → Quick start.
- Featured-image previews and a category filter in the project list.
- Optional editable project starter: challenge, approach, result and gallery.
- Two native block patterns: project story and responsive project overview with pagination.
- Bundled deckerweb GitHub Release Updater 2.2.1 and deckerweb Plugin Library 1.1.0.
- English, German and formal German interfaces and localized update banners.
- Setup check, manual starter insertion into empty drafts, clickable native category filters, filter reset and helpful empty states.

## Installation and first steps

1. Upload portfolio-content-1.3.2.zip under Plugins → Add New → Upload Plugin; activate it.
2. Open Settings → Portfolio Content. Optionally enable the project starter.
3. Add a project with title, featured image and excerpt; publish it.
4. Create a page. In the block inserter's Patterns tab choose Portfolio Content → Portfolio: project overview.
5. Publish the page and add it to your navigation.

The overview uses a native Query Loop: six projects, newest first, three columns and pagination. Adjust these in the editor. Theme styles control appearance. The built-in archive at /portfolio/ uses your theme's archive template and can look different from the overview page.

For page builders, select portfolio-content as the post grid content source and configure image, title and excerpt. Custom fields remain the responsibility of your chosen field plugin. No specific commercial builder integration is included or claimed as tested.

## Project starter

Disabled by default. Enable it in settings to populate new empty auto-drafts only. Existing projects and non-empty defaults remain untouched. It is ordinary editable content, not a locked template. The classic WordPress editor receives headings and paragraphs instead of block markup. The project editor also offers Insert project template for empty drafts, independently of the automatic setting. Current unsaved content is protected; insertion only changes the editor until you save.

## Updates and Library

Updates from public stable GitHub releases appear in the regular WordPress plugin update system. Automatic updates remain your choice. The bundled deckerweb Updater 2.2.1 and plugin validate package identity, offered version and actual WordPress/PHP requirements. Icons and banners are served locally.

The deckerweb Library 1.1.0 adds a catalog under Plugins → Add New. Installation and activation are separate decisions. WordPress.org remains the default. Online catalog retrieval is optional and off by default. 

## Multisite and data

Projects, categories, tags, images and preferences belong to each website. Network activation registers portfolio content on all sites in the network, including newly created sites. The starter and deletion preference are configured separately per website; there is no shared portfolio network setting.

Deactivation preserves all data. Uninstall clears plugin-owned temporary update data. Projects, terms and images always remain. Plugin preferences also remain unless that website explicitly enabled the deletion option. Shared Library data remains while another Library host is installed, including inactive hosts. The final host clears temporary Library data; the Library’s separate, default-off deletion preference applies only to Library settings.

## Privacy and connections

No telemetry. WordPress update checks request public release metadata from api.github.com. Updates download packages from GitHub. The optional online catalog requests JSON from raw.githubusercontent.com/deckerweb; package actions recheck approval. These services receive the IP address and standard HTTP request data, not portfolio content or personal preferences. Documentation, support and donation links are contacted only when opened. For native WordPress package downloads, the default User-Agent may include the WordPress version and site address.

## Existing integrations

Internal identifiers stay portfolio-content, portfolio-category, portfolio-tag. Project URLs and archive remain /portfolio/; REST support and post capabilities stay unchanged. Existing filters:

- pfc/post-type/params
- pfc/taxonomy/params-category
- pfc/taxonomy/params-tag
- pfc/plugins-page/cpt-links
- pfc/plugins-page/meta-links

The meta-links filter is now scoped to this plugin's row. Custom translations under wp-content/languages/portfolio-content/ remain supported; normal WordPress plugin translations and bundled fallbacks are supported as well.

## FAQ

Do I need a page builder? No. The native block patterns work with the WordPress block editor. A builder can use the portfolio post type as a grid source.

Will it change my website design? Your theme or builder controls the appearance. The plugin registers content and provides editable native patterns.

Does the starter change existing projects? No. It is optional and only fills new empty automatic drafts.

How do I show my projects? Create a page and insert Portfolio: project overview from the Patterns tab, or use the theme archive at /portfolio/.

Do I need a custom field plugin? No. Title, content, excerpt, featured image, categories and tags are included. Additional fields are optional.

How do updates work? Public stable GitHub releases appear in the regular WordPress plugin update system. No separate updater plugin is needed.

What remains when I deactivate or uninstall? Projects, categories, tags and images always remain. Preferences remain by default; the deletion option affects only that website’s settings.

FAQ by topic (https://github.com/deckerweb/portfolio-content/wiki/FAQ-English)
