Skip to main content
ExLibris
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    Configuring App Basics

    campusM + cmLibrary Logo wh bkg sm1.png

    Configuring App Name and Icons

    The app name appears in the app store, as well as the label and in the app title bar on the end-user's device. You can change the web app icons in the App Manager. To change Android of iOS icons, contact campusM for assistance.
    To configure the app name and app icons:
    1. On the Change general settings page (App Settings > App Settings > General Settings), under App name, enter the app name.
      change_general_settings.png
      Change General Settings Page
    2. Save the changes to the page.
    3. On the Change app device icons page (App Settings > App Settings > Web App Icons), select Browse, and then select the icon for the web app from the Asset Manager (see Uploading Files). See the on-screen text for content type and file size limitations. The selected icon is displayed beside the Browse button.
      Change Web App Icons.png
      Change Web App Icons Page
    4. Save the changes to the page.

    Configuring App Language

    The app's languages are configured during installation. For help in adding or changing languages, contact Ex Libris customer support.
    To configure which language is used for a profile, see Managing Profiles.

    Configuring App OS and Platform

    OS's and platforms are configured during installation. For help in adding or changing OS's and/or platforms, contact Ex Libris customer support.
    To configure which OS's and platforms are enabled for a profile, see Managing Profiles.

    Configuring App Information Screens

    You can configure the following information panes and screens in your app:
    • Welcome Message pane - When the end-user first opens the app, the app displays this message on a screen where the end-user selects the app profile. You configure the welcome message pane in the Welcome Message field on the Change general settings page (App Settings > App Settings > General Settings). The contents of the message must be text, only.
      Welcome Message
    • Terms of Use screen - The app displays this screen after the end-user selects a profile group but before the end-user registers or logs in. The text of this screen is pre-configured by Ex Libris (North American EULA or International EULA) and should not be changed. Extra lines may be added to the EULA intro, such as hyperlinks to the organization’s own website, Privacy Policy, web use guidelines, etc. Such changes may only be requested to be implemented by Ex Libris. You can view the text in the Terms of use field on the Change general settings page (App Settings > App Settings > General Settings).
    • About screen - About screens are associated with specific profiles; see Managing Profiles.
    • iPhone / iPad splash pages - The app displays one of these pages every time the end-user launches the app on an iOS device. The splash page is an image; for an iPad, it is a pair of images, one for portrait and one for landscape. You configure these pages on the Select iPhone/iPad splash page to change page (App Settings > iOS Splash Pages > iPhone Splash Pages or App Settings > iOS Splash Pages > iPad Splash Pages). Each page presents a list of splash pages for the device. For information about working with lists, see Working with Lists.
      1. Upload the image(s) to the Asset Manager (see Uploading Files). The maximum recommended size of the image is 50K.
      2. Select the image(s) from the Asset Manager. For the iPad, you select two images, one for portrait and one for landscape. The recommended sizes are:
        • iPhone - 640x940 pixels
        • iPad (portrait) - 768x1024 pixels
        • iPad (landscape) - 1024x768 pixels
      3. Optionally configure a date and time for the image(s). If the date/time you configure is more recent than the date/time of the image(s) on the end-user's device, the app downloads the newer image(s).

    Configuring Biometric Identification

    Biometric Identification allows mobile devices to identify users by their biometric information, such as fingerprint or facial recognition. The Biometric Identification functionality is accessible to users with permissions: Customer Super User - All permissions. Alternatively, you can contact Ex Libris support for help in managing this feature.

    To configure Biometric Identification:
    • Select Biometric Identification from the App Settings page (App Manager > App Settings > App Settings):
      biometric_identification.png
      Biometric Identification
    • For the Use Biometrics field, select Enabled.
    • For the Biometrics Timeout field (optional), enter the number of seconds for which an identification remains valid. After this time, the user is required to be identified again.
      The timeout counter starts when campusM is closed and runs in the background. If campusM is reopened, the timeout counter is reset.
    • Click Save.

    Configuring App Emails

    campusM, or the campusM app, sends certain emails. The emails are (email codes are in parentheses):
    • Activation (ACTIVATION_EMAIL) - Sent to the end-user to confirm their registration.
    • Forgot password (FORGOTTEN_PASSWORD_EMAIL) - Sent to the end-user to change their password.
    • Problem (PROBLEM_EMAIL) - Sent by the app to a user (see Configuring Email Addresses to Receive Feedback) when the end-user submits a problem report.
    • Idea (IDEAS_EMAIL) - Sent by the app to a user when the end-user submits an app suggestion.
    • Feedback (FEEDBACK_EMAIL) - Sent by the app to a user when the end-user submits general feedback.
    • It is recommended to consult with Ex Libris customer support before making any changes to email templates.
    • Any emails you add to this page are ignored. To configure additional emails, contact Ex Libris customer support.
    • There must not be more than one email of each type (as indicated by the codes in the above list).
    • If an email type is missing, the relevant email will not be sent, which is probably a bad idea.
    You configure emails on the Select email template to change page (App Settings > App Settings > Email Templates). This page presents a list of emails; for information about working with lists, see Working with Lists. For each email, configure:
    • Type - Don't touch this. Must be a valid email code (see above).
    • Email header - The subject of the email.
    • Email body - The body of the email. To work with this field, see Working with the Text Editor. In addition to the usual features, you can add one of the following parameters to the body (or subject) that will be replaced when the email is sent:
      • Application name {#app_name#}
      • Email Address {#email#}
      • First Name {#first_name#}
      • Last Name {#last_name#}
      • Password {#password#}
      • Verification link tags (ACTIVATION_EMAIL only) {#link#}text text text{#link#}
      • New, temporary password (FORGOTTEN_PASSWORD_EMAIL only) {#new_password}
      • Feedback (FEEDBACK_EMAIL, PROBLEM_EMAIL, and IDEAS_EMAIL only) {#feedback#}

    Configuring App Feedback

    When the end-user submits feedback, the feedback is available to view in the App Manager and an email is sent to the default email address for the profile. To configure this email, see Configuring App Emails.
    To view app feedback, see Viewing Feedback.
    Also watch Feedback (4:26 min).

    Configuring Problem Feedback Categories

    You configure problem feedback categories on two pages: the Select problem page category page (App Settings > Feedback > Problem Page Categories) for problems about particular pages, and the Select problem app category page (App Settings > Feedback > Problem App Categories) for general problems with the app. Each page presents a list of categories; for information about working with lists, see Working with Lists.
    For each category, configure:
    • Value code - A unique code, for use in reporting.
    • Description - The category name as it appears in the app.
    • English / Dutch / English US - Enter a description of the category in English. The other language fields are not in use.

    Configuring Email Addresses to Receive Feedback

    You can configure three email addresses to receive feedback from end-users: one email address each to receive feedback for problems, ideas, and general feedback, respectively. The email addresses are configured as a set, and the set is assigned to a profile to receive feedback from end-users of that profile. 
    You configure email addresses to receive feedback on the Select contact email addresses to change page (App Settings > Feedback > Contact Email Addresses). This page presents a list of sets of email addresses; for information about working with lists, see Working with Lists.
    For each set, configure the email addresses for general feedback (Feedback email address), problems (Problem email address), and ideas (Ideas email address).

    Configuring App Social Network Sharing

    End-users can share a link to the app, or a screen from the app, by email, Twitter, or Facebook. You generally configure these features during installation, but you can also configure them later. For more information about end-user communication, see End-User Communication.

    Configuring Facebook Sharing

    You configure Facebook sharing on the Select Facebook Settings to change pages (App Settings > Sharing > Facebook Settings). This page presents a list of sharing elements; for information about working with lists, see Working with Lists. The elements are:
    • Page Name - Default text to post a message about an image in the app. Use the code APPNAME to have the app substitute the app name in the text.
    • Screenshot of - Default text to post a screenshot of a page. Use the code #page# to have the app substitute the current page name in the text.
    • Page Caption - - Default text to post a message about a page in the app. Use the code APPNAME to have the app substitute the app name in the text.
    • Page Action Name - Default text to post a "get this app" message from a page. Use the code APPNAME to have the app substitute the app name in the text.
    • App Name - Default short text to post a "get this app" message from the home page. Use the code APPNAME to have the app substitute the app name in the text.
    • App Description - Default long text to post a "get this app" message from the home page. Use the code APPNAME to have the app substitute the app name in the text.
    • App Caption - Default text to post a message about the app. Use the code APPNAME to have the app substitute the app name in the text.
    For each element, configure the
    • Description - The text, as it appears in the app.
    • English / Dutch / English US - Enter English. The other language fields are not in use.

    Configuring Twitter Sharing

    You configure Twitter sharing on the Select Twitter Settings to change pages (App Settings > Sharing > Twitter Settings). This page presents a list of sharing elements; for information about working with lists, see Working with Lists. The elements are:
    • Screenshot of - Default text to post a link to a page. Use the code #page# to have the app substitute the current page name in the text.
    • App Name - Default text to post a "get this app" message. Use the code APPNAME to have the app substitute the app name in the text.
    For each element, configure the
    • Description - The text, as it appears in the app.
    • English / Dutch / English US - Enter English. The other language fields are not in use.

    Configuring Email Sharing

    You configure email sharing on the Select Email Settings to change pages (App Settings > Sharing > Email Settings). This page presents a list of sharing elements; for information about working with lists, see Working with Lists. The elements are:
    • Page / App Email Subject Title - The subject when sending an email about a page / the app. Use the code APPNAME to have the app substitute the app name in the text.
    • Page / App Email Body - The body when sending an email about a page / the app. Enter a name for this entry (the default is Page Email Body) and the body text in English, US English, and/or Italian. Use the code APPNAME to have the app substitute the app name in the text. To edit the text, see Working with the Text Editor.
    • Was this article helpful?