Installing an Addon - Vanilla Success

* { padding: 0; margin: 0; box-sizing: border-box; transition: opacity .3s ease-in-out,color .3s ease-in-out; transition-delay: 0; } .footer { background: #2B2B2B; color: #909090; font-size: 14px; line-height: 1.5; padding: 28px 0; } .footer-wrap { padding-left: 18px; padding-right: 18px; max-width: 1236px; margin: 0 auto; } .footer a { color: #fff; opacity: 0.8; } .footer a:hover { color: #fff; opacity: 1; } .footer a * { color: inherit; } .footer-row { display: flex; flex-wrap: wrap; justify-content: space-between; align-items: center; margin: -3px; } .footer-col { padding: 0 3px; } .footer-col-copyright { justify-content: flex-start; flex: 1; } .footer-col-logo { justify-content: flex-start; } .footer-col-copyright, .footer-col-logo { display: flex; } .logo { width: 120px; height: 36px; color: inherit; } .social-links { display: flex; flex-wrap: wrap; align-items: center; } .social-link-item { flex: 1; list-style: none; color: white; } .social-link-item a { padding: 0 12px; display: inline-block; } .social-link-icon { height: 36px; width: 36px; } @media screen and (max-width: 768px) { .footer-row { display: block; } .footer-col { width: 100%; text-align: center; margin: 6px 0; } .footer-col:first-child { margin-top: 0; } .footer-col:last-child { margin-bottom: 0; } .footer-col-copyright { margin-top: 6px; margin-bottom: 18px; } .footer-col-copyright, .footer-col-logo { justify-content: center; } .logo { margin: 0 auto; } .social-links { justify-content: center; } .social-link-item { display: flex; align-items: center; justify-content: center; } } /*# sourceMappingURL=styles.css.map */

In Vanilla, Addons are installed by adding addons into one of the following directories:

/themes
/plugins

Installing an Addon by Symlink

Most addons have their source code managed in a VCS tool like Git. Copying a directory would make it difficult to update in the future through the VCS, so Vanilla prefers to symlink addons. Picture the following directory structure in a vanilla-docker setup.

workspace

vanilla
- plugins
- themes
vanilla-docker
repo-with-addons
- plugins/my-addon

The objective

Our goal here is to have my-addon be installed in the vanilla plugins directory.

Making a Symlink

MacOS or Linux

cd ~/workspace/vanilla/plugins
ln -s ../../repo-with-addons/plugins/my-addon

Note a relative symlink is used. This allows the symlink to continue to work when things are synced into the docker instance.

Windows

cd /D %userprofile%\workspace\vanilla\plugins
mklink \D my-addon ..\..\repo-with-addons\plugins\my-addon