patrikbjork / oppna-program-reklistan-theme

VGR, Theme for reklistan.vgregion.se

oppna-program-reklistan-theme

This is a WIP readme.

This theme is used by reklistan.vgregion.se. However, it's a little bit more than your average theme. The site is a "headless website", meaning that Liferay serves all data as JSON and the actual rendering is done client side.

Currently "JSON" is served by placing a few Asset Publishers on the page, set to display the entries with an ADT which outputs <script>var data = { ... }</script>. This will be changed to be fetched from an actual portlet (which outputs JSON).

Permissions

Add access to Site administration

Every user who's going to be logged in assigned workflow tasks needs to get access to the Site Administration. Enable that by:

1. Go to Control Panel > Users > Roles.
2. On User click Actions > Define Permissions.
3. Expand Site Administration > Content > Web Content.
4. Tick Access in Site Administration
5. Save

Building

Javascript

The Javascript files in /lib and /custom-lib are all minified and merged into /js/libs.min.js. This is done with a gulp script.

First time - install build dependencies. Make sure you have node.js installed (run node -v to get version number), then run:

cd core-bc/modules/theme/src/main/webapp
npm install

To rebuild the libs.min.js from the source files:

cd core-bc/modules/theme/src/main/webapp
gulp buildjs

Settings

For now, the settings are hardcoded in the js/main.js file.

properties: {
	companyId: 11111
	groupName: 'Guest',
	drugsStructureId: 22222
	adviceStructureId: 33333
	resourcesStructureId: 44444
}

The structure IDs you get by navigating to the control panel > content > articles > structures.

To get the companyId and groupName, go to a page on the public front end of the site which has the default theme (as oposed to the REK-theme). All environments should have a /admin page set up.

To get the companyId, open your browser console and run

themeDisplay.getCompanyId()

The groupName you'll get by running:

Liferay.Service(
  '/group/get-group',
  {
    groupId: Liferay.ThemeDisplay.getSiteGroupId()
  },
  function(obj) {
    console.log(obj.name);
  }
);