README

Aikeedo Composer plugin to register custom installer for Aikeedo plugins/themes.

https://aikeedo.com/

@heyaikeedo

Installation

composer require heyaikeedo/composer

Features

• Custom installer for aikeedo-plugin and aikeedo-theme package types
• Automatic copying of public assets to the webroot
• Automatic cleanup of public assets on uninstall
• Support for glob patterns

Public Files Configuration

Aikeedo plugins can define public files/directories that should be copied to the webroot during installation. This is configured in the package's composer.json under extra.public.

Basic Syntax

{ "extra": { "public": [ "path/to/file.js", "path/to/directory", { "source": "source/path", "target": "target/path" } ] } }

Target Path Resolution (Model A)

The target path follows "Model A" where target is ALWAYS the final destination path:

Examples

1. Legacy String Format (preserves full path)

{ "extra": { "public": ["widget/dist/index.html", "widget/dist/styles.css"] } }

Result:

• widget/dist/index.html → public/e/{vendor}/{pkg}/widget/dist/index.html
• widget/dist/styles.css → public/e/{vendor}/{pkg}/widget/dist/styles.css

2. Copy to Package Directory (no leading /)

{ "extra": { "public": [ { "source": "widget/dist/sdk.js", "target": "sdk.js" }, { "source": "assets", "target": "static" } ] } }

Result:

• widget/dist/sdk.js → public/e/{vendor}/{pkg}/sdk.js
• assets/ → public/e/{vendor}/{pkg}/static/

3. Copy to Webroot (leading /)

{ "extra": { "public": [ { "source": "widget/dist/sdk.js", "target": "/sdk.js" }, { "source": "assets", "target": "/static/assets" } ] } }

Result:

• widget/dist/sdk.js → public/sdk.js
• assets/ → public/static/assets/

4. Using Basename Shortcuts (. and /.)

{ "extra": { "public": [ { "source": "widget/dist", "target": "." }, { "source": "widget/dist", "target": "/." }, { "source": "widget/dist" } ] } }

Result:

• "." → public/e/{vendor}/{pkg}/dist/ (package dir + basename)
• "/." → public/dist/ (webroot + basename)
• No target → public/e/{vendor}/{pkg}/dist/ (same as ".")

5. Glob Patterns (copy contents)

{ "extra": { "public": [ { "source": "widget/dist/*", "target": "/assets" } ] } }

Result:

• Contents of widget/dist/ (e.g., index.html, css/, js/) → public/assets/
• Files become public/assets/index.html, public/assets/css/..., etc.

Environment Variables

Package Types

This plugin handles the following package types:

• aikeedo-plugin - Installed to extra/extensions/{vendor}/{package}
• aikeedo-theme - Installed to extra/extensions/{vendor}/{package}

License

See LICENSE file.