History: Packages

• «
• »

            !  {icon name="gift"} Packages

!! Overview
{DIV(class="lead")}Also called the Composer Web Installer, and introduced in ((Tiki18)), this feature is for the installation and management of external software packages using ((Composer)).{DIV}Composer is used in the Tiki code development process to import and manage external software such as jQuery and Bootstrap. But some software cannot be packaged with Tiki due to an incompatible license, or shouldn't necessarily be packaged with Tiki by default because of the software's specialized nature or niche application. So it is a natural step for Tiki site administrators to be able to use Composer to install and manage external software specifically for their site after the site is installed.

!! Use
The interface for Packages is located at the site's tiki-admin.php?page=packages page. The Packages admin page has four sections, displayed in tabs {HTML()}—{HTML}  __Packages Installed__, __Install Other Packages__, __Packages Bundled__, and __Diagnose__. These sections are described below:

!!! Packages Installed
This list shows packages that have been installed via this feature. The details for each package include package name, version required, status, and version installed, plus a remove button for each. The version required is the minimum version required by Tiki, so the version installed must be that version or a newer one. If the Packages feature hasn't been used yet, then of course the list will be empty.

{DIV(class=row bottom-margin-md)}{DIV(class=col-sm-10 col-sm-offset-1 thumbnail)}{img src=dl1355 title="Packages Installed"}{DIV}{DIV}

The status column shows a success icon ({icon name="success"}) if the package is installed, or a warning icon ({icon name="exclamation-triangle"}) if it is missing. If the package is missing, you can click the "Fix Missing Packages" button that is displayed and Tiki will try to install the package again.

!!! Install Other Packages
This section shows packages that are available to be selected and installed.

Some examples include:
* ((PhantomJS and CasperJS))
* ((mPDF))
* ((Expose))
* ((SAML))

{DIV(class=row margin-bottom-md)}{DIV(class=col-sm-10 col-sm-offset-1 thumbnail)}{img src=dl1357}%%%::Install Other Packages::{DIV}{DIV}
Currently those that are available are listed in the local composer.json file and fetched from [https://packagist.org].  ~tc~I'm not sure of these details. Is this right? Is there more to say about this? Can an individual Tiki site add package information to the file? ~/tc~

!!! Packages Bundled
This section lists the external software packages that are bundled with the core Tiki files, so are available for use in a fresh Tiki site. This list is for information purposes only and there's no interface here to make changes.

{DIV(class=row margin-bottom-md)}{DIV(class=col-sm-10 col-sm-offset-1 thumbnail)}{img src=dl1360}%%%::Packages Bundled::{DIV}{DIV}

!!! Diagnose
The "Diagnose Composer" button can be clicked to run composer and test the output. If composer isn't found for some reason, there will be a message to that effect.

{DIV(class=row margin-bottom-md)}{DIV(class=col-sm-11 col-sm-offset-1 thumbnail)}{img src=dl1359}%%%::Diagnose Composer - Composer Not Found::{DIV}{DIV}

Normally, composer will be found and run, and so some information will be shown here.

{DIV(class=row margin-bottom-md)}{DIV(class=col-sm-10 col-sm-offset-1 thumbnail)}{img src=dl1358}%%%::Diagnose Composer - OK::{DIV}{DIV}
!! Future development
Initially, the focus will be files at https://packagist.org/, but later this feature is intended to be expanded to include importing themes, libraries formerly hosted at mods.tiki.org, language files, and more.

!!! References
See also https://dev.tiki.org/Composer+Web+Installer.

!!! Page alias
(alias(Composer Web Installer))
(alias(Package))