Skip to content
Custom application to add label printing capabilities to OCLC's WMS system.
PHP CSS HTML JavaScript Hack
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea basic skeleton UI Jun 10, 2014
config
css
form
img changed example image to reflect barcode output better Apr 23, 2015
inc
js Updated DYMO Label Framework. Requires DYMO Label Software v. 8.7.2 o… Aug 27, 2018
tests/productivity
.gitignore Moved to using composer to install dependencies. Apr 28, 2017
.gitignore~
LICENSE
README.md Merge branch 'master' into master Aug 27, 2019
composer.json Added more error detailed handling Jun 19, 2017
composer.lock Moved to using composer to install dependencies. Apr 28, 2017
index.php

README.md

WMS-Labeling

Custom application to add label printing capabilities to OCLC's WMS system. This application is powered by PHP, HTML, and JavaScript. It is entirely self-contained in one folder and can be installed on an existing web server or a new one.

Some core functionality provided in the quicklabels.php file was provided by David Cunningham, University of New Brunswick Libraries

Screenshot

Request a WSKey

This web application uses a WSKey from OCLC in order to authenticate your connection. Read about how to request a WSKey here.

On the "Request a WSKey" page, here are the settings you need to utilize this application:

  • Environment: Production
  • Services: Check "WMS Collection Management API" and "WorldCat Search API"
  • What is the reason for this request? To use the University of New Mexico's custom labeling application
  • Redirect URI: Leave blank
  • Usage: Don't check anything

Installation

NOTE: The latest version of the code requires PHP 5.6. Older versions of PHP are no longer support per [http://php.net/supported-versions.php]

Clone this repository into your web directory ("git clone {url} labeling") or download directly from GitHub.

Change into the labeling directory

Run composer install from the command line

Copy config/config.php.template to config/config.php. Open config/config.php and add your OCLC WSKey credentials. Set your base_url to match your folder or leave blank if your site will be the root folder.

Copy config/crosswalks.php.example to config/crosswalks.php. Open config/crosswalks.php to map shelving locations to desired call number prefixes (e.g., Reference should print as REF on your label).

Copy scripts/laser.config.sample.php to any scripts/{name}.config.php (Default: laser.config.php). Edit desired margins/spacing and settings for your label printer stock. Note: If you add label style files aside from laser.config.php, you will need to add extra radio inputs in inc/fetch_labels.php. Search for <div class="print-area"> and add to the inputs below it.

Setup

config.php

After you get your WSKey, you'll need to go back to WSKey Management, browse to "WsKey" on the left sidebar, and click on your listed WSKey to display all your information. This page will contain all the information you need for config.php.

crosswalks.php

The crosswalks array is utilized in order to take various codes/wording from WMS and translate them to building locations and other specifics.

laser.config.php

Edit this file to create the layout of your label stock. We used a ruler with millimeters to measure the layout of our label sheets. This config file will most likely need many test prints and tweaks before you get it right.

Printing

Print/edit a single label

Launch yoursite.com/labeling and scan in a barcode and indicate whether a pocket label is desired. Click the "Make Labels" button.

In the preview screen, click anywhere on the call number to edit it if needed. Make your changes and click OK.

Editing

Select "Laser Printer" or any other config that you've added. Click "Print Labels". A PDF will be generated. Press Ctrl + P to send the PDF to your printer.

Print labels in a batch

After scanning a barcode, hit Enter on your keyboard, or press "Add More" button at the bottom of the screen to add multiple barcodes. The maximum labels per page is set in the config/{name}.config.php file.

You can’t perform that action at this time.