Configure Footer Text

[ghost]

There should be an option to configure the text displayed in the site footer, without manually editing source files.

Current the only way to alter this text is to manually edit the following file - for example, if I want to control the Copyright statement, it means changing the source code. In most use cases, users will want to change this, and changing source code to do so isn't something that should be encouraged.

https://github.com/paragonie/airship/blob/master/src/Cabin/Hull/Lens/cargo/footer.twig

[paragonie-scott]

Just to clarify, you don't actually have to edit core files to change this text. Both a Motif and a Gadget can change this.

• https://github.com/paragonie/airship/blob/master/src/Cabin/Hull/Lens/base.twig#L23
• https://github.com/paragonie/airship/blob/master/src/lens_functions.php#L156-L163
• https://github.com/paragonie/airship/blob/master/src/Engine/Gadgets.php#L90-L108

Any extension that overrides the "footer" cargo will change what users see without creating conflicts with the self-updater. Both extension types can be created with barge.

Customizing an Airship Cabin From a Motif

Just add a list entry to your JSON configuration file, like so (using {$cabinDir}/lens/cargo as a basepath, e.g.).

Customizing an Airship Cabin From a Gadget

Make sure you have an autoload.php script in your project's src directory (this is provided by barge gadget) then add \\Airship\\Engine\\Gadgets::loadCargo() calls.

You can (and should) use the @project-name-here vendor prefix as the generated comment indicates. (This gets rewritten to phar:///path/to/gadget.phar/lens/ at runtime.)

---

All that aside, giving users more configuration options with the one motif we ship is a good idea. 👍

[paragonie-scott]

d56a8bb