primo-explore-appointment-scheduler

Adds a widget in Primo account overview screen to allow patrons to manage their appointments made with the Alma Appointment Scheduler Cloud App.

Features

• View/cancel existing appointments
• Create new appointmen
• Cancel existing appointment
• Works with configuration from the Appointment Scheduler Cloud App
  • List of locations
  • Lists appointment slots based on start and end hours
  • Lists appointment slots dependent on location capacity
• Supports overriding display strings and localizations based on Primo interface language

Screenshots

Account home page

Widget in new appointment state

Install

1. Make sure you've installed and configured primo-explore-devenv.
2. Navigate to your template/central package root directory. For example:

   cd primo-explore/custom/MY_VIEW_ID

3. If you do not already have a package.json file in this directory, create one:

   npm init -y

4. Install this package:

   npm install primo-explore-appointment-scheduler --save-dev

Usage

Once this package is installed, add appointmentScheduler as a dependency for your custom module definition.

const app = angular.module('viewCustom', ['appointmentScheduler']);

Note: If you're using the --browserify build option, you will need to first import the module with:

import 'primo-explore-appointment-scheduler';

Then add the appointment-scheduler component to the prmAccountOverviewAfter placeholder as follows:

/** Appointment Scheduler in Library Card */
app.component('prmAccountOverviewAfter', {
  bindings: {parentCtrl: '<'},
  template: `<appointment-scheduler 
    parent-ctrl="$ctrl.parentCtrl"
    apikey="l8xx..."
  ></appointment-scheduler>`
});
/** END Appointment Scheduler in Library Card */

Configuration

The following configuration parameters are available: | Parameter | Description | | --- | --- | | apikey | An API key which is configured for read-only on the Primo Public Key API only. (This is important as the key will be exposed in the HTML). The key is used to validate the authorization token. | | i18n | Overrides for the strings used in the display. The list of string is available here. Any string not provided will fall-back to the default. Strings can be provided in different Primo locales (i.e. en, fr). Example:i18n='{ en: { appointments: "Library Appointments" }, fr: { appointments: "Rendez-vous à la bibliothèque" }}'|

Development

To build this add-on, use:

npm run build

To publish:

npm publish

Contributions

We welcome contributions to this community-supported add-on. We're also happy to add additional default translations to the string file.