Joomla Wisecat+ extension

General Tab

The General tab of the Component is where the Wise settings are entered. They are:

• Wise server domain (include https://)
• Branch number/ID
• Library ID/Library Organisation/Instantie

These can be found in the Wise Manager.

Make sure to click the Save Settings button in the Top Toolbar.

Keycloak Settings Tab

The Keycloak settings tab of the Component is where the Keycloak settings are entered. They are:

• Keycloak domain (include https://)
• Realm name
• Client ID
• Client secret key

These will be provided for you by OCLC. Ask us for them if you haven't received them.

Make sure to click the Save Settings button in the Top Toolbar.

Additional Tab

The Additional tab of the Component is where you set a number of seemingly random settings. Let's go through them:

• Field label: H1 tag (hidden): This field is to define an H1 tag for your catalog and Mijn Menu pages without detracting from the page layout. Because the Wisecat+ headings are H2, h2, etc., this is how we can have an H1 on the Wise pages for SEO and accessibility. By default, the field will state your Site Name from Joomla Global Configuration followed by catalog. You may replace that default with your choice of text in this field.
• Debug level: leave at minimal logging unless instructed by OCLC or Zoccolo staff.
• Delete users: Setting to 'Yes' is recommended for privacy. If you choose to set this to 'No', you should delete patron Joomla accounts (Users → Manage → Filter registered users → delete) regularly.
• Cron password: Set your cron password here. You will then see the Cron job url posted below. This is what you will use for your cron job on the Joomla server.
  • Set your cron password to something that isn't 123 and click the Save settings button in the Top Toolbar.
  • Go to your Joomla server cPanel or Plesk control panel (or however you set up cron jobs on your server).

  • Set up the server to hit/trigger the URL shown below the cron password field every three hours every day. This will collect the Wisecat+ updates and bring them to the Joomla site. Since each server is different, we cannot provide an exact cronjob. This is an example:

    curl -s "domain/url"

  • If you begin to notice that the build number in Components → OCLC Wise isn't changing very regularly, do check your cron job. Sometimes servers change and cron jobs stop working.
  • The build number in the Component settings will match what Wisecat+ is running if the cron job is working properly.
  • If the Joomla site isn't receiving the updates from Wisecat+, your catalog and mijn menu may not behave properly.

Make sure to click the Save Settings button in the Top Toolbar.

.htaccess Rewrite Rules

VARIABLES:
'/catalog' - can also be something like: '/catalogus' or '/mijn-menu' etc.
'BRANCHID' - replace with the branchid which is configured in the extension for example (four digit number).
 
RewriteCond %{REQUEST_URI} ^/catalog$
RewriteCond %{QUERY_STRING} event=profset
RewriteRule .* /wise-apps/opac/BRANCHID/new-arrivals [L,R,QSD]
 
RewriteCond %{REQUEST_URI} ^/catalog$
RewriteCond %{QUERY_STRING} event=mailabbo
RewriteRule .* /wise-apps/opac/BRANCHID/my-account/notification-preferences/areas-of-interest [L,R,QSD]
 
RewriteCond %{REQUEST_URI} ^/catalog$
RewriteCond %{QUERY_STRING} event=invent
RewriteRule .* /wise-apps/opac/BRANCHID/my-account/checkouts [L,R,QSD]
 
RewriteCond %{REQUEST_URI} ^/catalog$
RewriteCond %{QUERY_STRING} event=private
RewriteRule .* /wise-apps/opac/BRANCHID/my-account [L,R,QSD]
 
RewriteCond %{REQUEST_URI} ^/catalog$
RewriteCond %{QUERY_STRING} event=tickw_uitvsel
RewriteCond %{QUERY_STRING} ^(.*)u_id=(.*)
RewriteRule .* /wise-apps/opac/BRANCHID/tickets/performance/%2 [L,R,QSD]
 
RewriteCond %{REQUEST_URI} ^/wise-apps/catalog/(.*)/detail/wise/(.*)
RewriteRule .* /wise-apps/opac/BRANCHID/catalog/title-detail/WISE/%2 [L,R,QSD]

OCLC Wise Search Module

In the Component Modules Tab, click the accordion to access the global search settings for the OCLC Wise Search module. 

• Placeholder: Choose the Placeholder text that is seen in the searchbar input field (where people type their search terms). Most common is Catalog Search, Search the Catalog, Typ hier uw zoekopdracht in..., etc.
• Scopes: Select the scopes that match the scopes configured in your Wise Manager. By default, All, Title, Author, and Subject are selected. You can select them all, but they will only work if the scopes are configured in your Wise Manager.
• Enable website search: Select Yes in order to use Joomla core Smart Search from your searchbar. You must have Smart Search enabled and indexed. You must have a Smart Search menu item created though it can be hidden. Then, when people select Website from the search drop-down on the frontend and enter a search query, they will receive search results from your website content.
• Add other search options: Click the plus button to add a search to anywhere you'd like. This might be an external Events platform. It might be a Joomla events component search like RSEvents, etc.
  • Label: Add a label for the search. This should be as short a word as possible like Google, Events, Genealogy, etc.
  • URL: This should be the domain and URL to pass the search term to the source.
  • Open in a new tab: Select Yes/No. Best practice is that if you are sending someone off your website, open in a new tab. If it's on your website, do not open in a new tab.

Make sure to click the Save Settings button in the Top Toolbar.

Once complete, go to Site Modules (via the Home Dashboard, Content → Site Modules, or System → Manage → Site Modules) and click the + New button. Select OCLC Wise Search.

1. Enter a title for your searchbar module.
2. Set the title to show or hide (probably hide).
3. Select a module position for your searchbar to display.
4. In the Menu Assignment tab, select the menu items you'd like the module to display on.
5. If you used the Component Global Settings, click Save and check out your searchbar on the frontend.
6. If you did not use the Component Global Settings or want to make changes on individual modules, tick each of the boxes that say 'Use global' so that they don't use global and enter your desired settings. Then click Save and check out your searchbar on the frontend.

On the frontend, you will see the scopes in the drop-down followed by Website search (if enabled) and then other search options.

If the Dutch language pack is installed and set as default for the Site, the module will display in Dutch.

OCLC Wise Login/My Account Module

In the Component Modules Tab, click the accordion to access the global search settings for the OCLC Wise Login module. Most likely you will only have one of these modules on your site. If you'd rather do these settings in the individual Site Module itself, navigate to System → Site Modules. Create a new OCLC Wise Login module and follow the same directions as below.

There are two sections of the login module. One displays when users are Logged out, the other when users are Logged in.

OCLC Wise Bookcarousel Module

In the Component Modules Tab, click the accordion to access the global search settings for the OCLC Wise Bookcarousel module. This is where you will set up how you want the global settings for your bookcarousels. Before we begin, you must create bookcarousels in the Wise Manager. See documentation on creating Wise Bookcarousels. Once you have at least one bookcarousel created in the Wise Manager, we can begin setting them up in Joomla. 

Since it will be challenging to know how you want to set up the bookcarousel without being able to see one, we will leave the defaults in place in the OCLC Wise Bookcarousel global settings and first create an individual Site Module to display on the frontend. Click the Save settings button in the Top Toolbar of the Component if you have made any changes you want to keep.

1. From the Joomla Home Dashboard, click the + sign in the Modules button.
   
2. Select OCLC Wise Bookcarousel from the list of installed modules.
   
3. Enter the Title, Infopoint Profile ID (from the Wise profiel in the Wise Manager), Show the title (for now), select the module Position in your template, and select the Menu Assignment so that the module displays on a page or pages of your choice. Tip: Adding the infopoint profiel number to the 'Note' field of the module helps you find it more easily when there are large numbers of bookcarousel modules on a site.
   
   
4. Click Save & Close.

Now we will have something to look at on the frontend of the site as we enter the settings of the bookcarousels in the OCLC Wise Global Settings.

Click on Components → OCLC Wise → Modules tab → OCLC Wise Bookcarousel

Infopoint Profile: Do not use this field in the Global Settings. You will fill in the Infopoint Profile number in your individual modules (since they will all be different).

Number of items: Enter the number of book covers you'd like to display in your carousel. This is largely dictated by Wise. However, if the Wise Regal and Planken are set to 100+ and you only want 50 to display on the website, you may enter 50 in this field. Leaving the default of '0' will allow Wise to decide the number based on what is configured in the infopoint profile.

Show title: If you would like to display the title below the book covers, toggle to Yes.

Show author: If you would like to display the author below the book covers, toggle to Yes.

Navigation class: You may create custom classes for navigating the bookcarousels. If you have a custom navigation class, you may enter it in this field.

Navigation item class: You may create custom classes for navigating the list items. If you have a custom navigation item class, you may enter it in this field.

Navigation link class: You may create custom classes for navigating the link items. If you have a custom navigation link class, you may enter it in this field.

Hide title on 1 tab: Choose Yes or No to hide the title of the tab on bookcarousels with one tab. This is your preference. Many prefer to use the Module Title rather than the title that shows up in the tab that comes from Wise on bookcarousels with only one tab.

Height in px (max): Enter the height of the cover images in the carousel. Width is considered in the aspect ratio. 200px is lovely.

Speed (ms): Enter the speed in milliseconds of the shifting of the covers.

Autoplay (ms): Enter the speed in milliseconds if you would like the covers to autoplay. If you do not wish the covers to autoplay, set this field to 0.

Autostop on interaction: If autoplay is enabled, hovering or interacting with the carousel will stop it from autoplaying. Select Yes or No for this option.

Show pagination: Pagination are the bullets below the bookcovers, titles, and author. Select Yes or No to show pagination below the bookcarousels.

Pagination clickable: Select Yes or No for the bullets to be clickable or not.

Pagination type: Choose from the drop-down one of three options

1. Bullets (dots)
2. Fraction (1 of 6 1/6, etc.)
3. Progressbar

Show next/previous buttons: Next/Previous buttons are the arrows to the left and right of the bookcarousels that visitors can click to forward or reverse to the next group of items.

Button position: Choose whether you'd like the next/previous buttons to display Inside the slider or Outside the slider.

Covers per slide: Choose how many covers should display in each slide. 7 works well on a full width bookcarousel.

Covers per group: When pagination or next/previous buttons are clicked, this is the number of covers that will advance forward or backwards. It's nice to have the covers per group match the covers per slide setting. That way, none of the covers are duplicated as the visitor scrolls through.

Center active cover: Setting this to Yes will make the first cover "centered" in the carousel. Setting this to No looks better.

Keyboard control: This allows the visitor to use the keyboard to control the carousel. Setting this to Yes is recommended.

Use in Articles and Modules

To use shortcodes in Articles and Modules, add any of the shortcodes into your editor of choice or via HTML.

Use in Menu Items

To use shortcodes in Menu Items, you may select them from the OCLC Wise Menu Item.

1. Go to Menus and select the menu you'd like to use.
2. Click the + button or click New in the Top Toolbar.
3. Enter the Title of the Menu Item.
4. Click the Select button for Menu Item Type, click on OCLC Wise, and then Wise angular page.
   
5. Click the drop-down for Page type and select any of the shortcode options from the list. The example below shows Mijn Menu/My account.
   
6. Click Save & Close from the Top Toolbar.
7. Test on the frontend.

If there is a different shortcode you would be interested in having, please open a ticket so we can consider adding it.

Styling for CGI Wrapped Pages

A few of the pages in Wisecat+ are CGI wrapped pages. Because these pages live on the Wise server, we are unable to override the CSS via the Joomla site. There are only a few pages where you may see either orange or blue buttons or hyperlinks. To choose between orange or blue:

1. Login to the Wise Manager
2. Go to systeemWise → Marketing → Thema kiezer.
3. Click Nieuw in the Top Toolbar.
4. Select the Instantie.
5. Select the Thema of either Koninklijk oranje or Presidentieel blauw.
6. Click Ok.
   

It will take 30-90 minutes for the change to take affect so that you can see the change in colour on your Joomla site. It may take overnight.

The rebuilding of the CGI pages is on the roadmap for after Wisecat+ has completed phase 2. Thus, choosing between oranje or blauw is a temporary limitation.

Another known limitation with the CGI wrapped pages is that they only display in the Joomla site. If you attempt to view a CGI wrapped page in Wisecat+ native, they will not display. They will only display in Joomla.