The Private App Store Package is a jar file containing modules and templates than can be deployed on a Digital Factory instance to create a browsable repository of modules.
A Private App Store establish a bridge between developers and running instances of Digital Factory, enabling seamless and secure distribution of new or updated modules, reducing risks, time spent on maintenance an TCO.
Developers can publish their modules directly from the Digital Factory Studio. Users with enough privileges (site administrators, webmasters) can use the App Store to
Each module stored can receive a description and can be categorized, commented, rated, illustrated with screenshots or videos. For each version of a module there can be specific release notes.
You can find more information on maven repositories here
https://maven.apache.org/guides/introduction/introduction-to-repositories.html
If you don't have any Maven repositories manager yet, we suggest you to have a look at Nexus http://www.sonatype.org/nexus/.
The repository stores the artifacts uploaded on the Private App Store.
The Private App Store will proxify all the access to the maven repository. It means that Digital Factory users will only be aware of the Private App Store, but not of the Maven repository itself.
Get the store package from Jahia Public App Store: http://store.jahia.com/home.html
From your server modules administration page, upload the package.
This will install the Private App Store module and its template-set, then create a new Private App Store web site ready to be configured.
Once your store is installed, log as root to configure it
Url of nexus repository
: Complete url to your repositoryRepository identifier
: Identifier for the repositoryUser and password
: user on the Nexus repository with write accessAdministrator
: the user is allowed to moderate modules and perform any operation on any modulesDeveloper
: the user can add new modules, edit them and add new version to his own modulesReader
: if you want to forbid the access to your App Store, you can specify which user can read the store. Note that you will need to specify it in Digital Factory administration to access the store.The store uses a flat list of categories.
You need to choose the root of the store categories in your category tree.
You can also add or edit categories
Your store is now ready to be used.
Developers can upload any Digital Factory released module using the web form
This operation creates a new store entry.
With the developer panel, you can see the unfilled fields of the module, and perform actions:
View as
: allow to view your module page as a guest userPublish
: when all mandatory fields are set, publish the module make it available for the store readersDelete
: delete your module.By default, after an upload, only the category is mandatory.
You can add information on your module, clicking on the specific tab. We encourage you to populate it as much as possible.
When all mandatory fields are set, you can publish your module by clicking on the publish button on the developer panel. By publishing the module the first time, you allow to download the latest version of the module if none is already published.
Note that until the module itself is published, it will not be available to download even if a version is published.
Once published, you can click on unpublish to remove the module to visitors, completely or a specific version.
From the version panel of a module you can upload a new version of the module, the module artifact ID and group ID must match, if not, the operation will create a new module.
Once a new version is uploaded, you can make it available by clicking on the publish button
If the version 1.4 is the one currently published, this version will be available for download
Only one version can be published at a time.
From this panel, it is possible to control who can see (read) the module, by choosing individual users or groups.
.
You can define the settings of the store.
You can do all the same operations as an owner of a module on all modules of the store.
For each module, you have the possibility to flag them as reviewed or supported.
If your organization does not use those concepts, just don’t use those fields.
Enabled, this will display icons on modules list
The Digital factory studio integrates a release process based on maven to ease the releasing of modules. This allows releasing and deploying on a maven repository and/or on app store. On the first release you have to choose your release process, this can be changed later by clicking on Edit repository information
in the same menu.
According to your maven settings, you have to define the maven repository ID and its URL before clicking on save.
Selecting Jahia Private App Store let you define the store url that you can find on the homepage of the store you’ve previously installed.
You have to use credentials with developer permissions, then click on save.
If you skip this step, the jar will be released but store locally.
Once the repository type is chosen, you can release the module, depending of your configuration you will be able to send it to a store or deploy it on a maven repository.
You can select a major or minor release type, then click on release
to perform the release
Note: if you have a scm set on your module, the maven plugin used to do the release will tag your module.
After releasing, if you didn't set store information, you will be able to download a copy of the released jar of the module.
You can edit within the digital factory studio, the store information of the module as if you were on the App Store web site.
Once a module is pushed to a store, you can access to its store page by clicking on Go to the private App Store page
A Digital Factory instance can register an unlimited number of stores. The URL of a store, used to establish a direct connection between a Digital Factory instance and the Private App Store, is displayed on the home page of the web version of the Store. Click on the icon to copy this URL.
Go to the Digital Factory Administration > Server Settings > System components > Private App Stores
The main panel displays the stores already declared and a form to register new ones.
You can set multiple store locations, for instance an internal store and several ones from your contractors.
Use the Private App Store reader credentials if they needed to access the store (the administrator of the store should give you that information). Leave those fields empty if the App Store has a public access.
Once you’ve added one or several Private App Stores, the modules registered in those Stores will be accessible directly in the "Modules" page of the settings panel. You can then download and install those modules in one click, directly from Digital Factory GUI.
The list of modules coming from app stores is refreshed once a day
.
Refresh can be forced by clicking on
When a new version of an already installed module is available, the download button becomes enabled again so you can install it.