From 5e9c76f50213624c54524dc29b270afa75c54d15 Mon Sep 17 00:00:00 2001 From: Chris Cormack Date: Sun, 13 Nov 2016 18:21:34 +1300 Subject: [PATCH] Finishing splitting up the manual License has its own file so doesn't need to be translated --- en/source/14_plugins.rst | 95 + en/source/15_implementation_checklist.rst | 1207 ++++ en/source/16_sopac.rst | 357 ++ en/source/17_cron_jobs.rst | 1554 ++++++ en/source/18_miscellaneous.rst | 4530 +++++++++++++++ en/source/19_license.rst | 683 +++ en/source/index.rst | 7 +- en/source/manual.rst | 8500 ----------------------------- 8 files changed, 8432 insertions(+), 8501 deletions(-) create mode 100644 en/source/14_plugins.rst create mode 100644 en/source/15_implementation_checklist.rst create mode 100644 en/source/16_sopac.rst create mode 100644 en/source/17_cron_jobs.rst create mode 100644 en/source/18_miscellaneous.rst create mode 100644 en/source/19_license.rst delete mode 100644 en/source/manual.rst diff --git a/en/source/14_plugins.rst b/en/source/14_plugins.rst new file mode 100644 index 0000000..308709a --- /dev/null +++ b/en/source/14_plugins.rst @@ -0,0 +1,95 @@ +.. include:: images.rst + +Plugin System +============= + +Koha's Plugin System allows for you to add additional tools and reports +to Koha that are specific to your library. Plugins are installed by +uploading KPZ ( Koha Plugin Zip ) packages. A KPZ file is just a zip +file containing the perl files, template files, and any other files +necessary to make the plugin work. + +The plugin system needs to be turned on by a system administrator. + +`Set up <#pluginsetup>`__ +------------------------- + +To set up the Koha plugin system you must first make some changes to +your install. + +- Change 0 to + 1 in your koha-conf.xml file + +- Restart your webserver + +Once set up is complete you will need to alter your +`UseKohaPlugins <#UseKohaPlugins>`__ system preference. On the Tools +page you will see the Tools Plugins and on the Reports page you will see +the Reports Plugins. + +Search History +============== + +If you have your `EnableSearchHistory <#EnableSearchHistory>`__ +preference set to keep your search history then you can access this +information by clicking on your username in the top right of the staff +client and choosing 'Search history'. + +Search history +|image1062| + +From this page you will see your bibliographic search history + +Bibliographic search history +|image1063| + +And your authority search history. + +Authority search history +|image1064| + +About Koha +========== + +The 'About Koha' area will give you important server information as well +as general information about Koha. + +- *Get there:* More > About Koha + +`Server Information <#aboutserver>`__ +------------------------------------- + +Under the 'Server Information' tab you will find information about the +Koha version and the machine you have installed Koha on. This +information is very important for debugging problems. When reporting +issues to your support provider or to the various other support avenues +(mailing lists, chat room, etc), it's always good to give the +information from this screen. + +Server Information on Koha +|image1065| + +`Perl Modules <#aboutserverperl>`__ +----------------------------------- + +In order to take advantage of all of the functionalities of Koha, you +will need to keep your Perl modules up to date. The 'Perl Modules' tab +will show you all of the modules required by Koha, the version you have +installed and whether you need to upgrade certain modules. + +Perl Modules +|image1066| + +Items listed in bold are required by Koha, items highlighed in red are +missing completely and items highlighted in yellow simply need to be +upgraded. + +`System Information <#aboutsystem>`__ +------------------------------------- + +This tab will provide you with warnings if you are using system +preferences that have since been deprecated or system preferences that +you have set without other required preferences + +System Information +|image1067| diff --git a/en/source/15_implementation_checklist.rst b/en/source/15_implementation_checklist.rst new file mode 100644 index 0000000..67378d9 --- /dev/null +++ b/en/source/15_implementation_checklist.rst @@ -0,0 +1,1207 @@ +.. include:: images.rst + + +Implementation Checklist +======================== + +The following guide will walk you through the areas of Koha you need to +look at in order to prepare to start using the system. + +`Data Migration <#imp-migration>`__ +----------------------------------- + +Before you can start using Koha you'll need to have some data. This can +be done by entering it all by hand, but most people already have their +data in electronic format of some sort and just need to reformat it a +bit for importing into Koha. + +- Create a list of libraries and enter their info and codes into + `Libraries & Groups <#libsgroups>`__ + +- Define your list of `Item Types <#itemtypeadmin>`__ + +- Define your patron categories and enter the categories and their + codes into `Patron Categories <#patcats>`__ + +- Enter any additional patron information fields you use in your + library in the `Patron Attributes <#patronattributetypes>`__ + + - Requires that you first set the + `ExtendedPatronAttributes <#ExtendedPatronAttributes>`__ system + preference if you have custom fields + +- Define all of your `Authorized Values <#authorizedvalues>`__ + + - `Collection codes <#ccode>`__ + + - `Shelving locations <#shelvelocvals>`__ + + - Item statuses (`lost <#lost>`__, `not for loan <#notforloan>`__, + `damaged <#damageauth>`__, `withdrawn <#withdrawnauth>`__) + + - Plus any others that are needed in your library + +- Optionally define `City/State/Postal Code <#citytowns>`__ combos + +- `Map your bibliographic data <#kohamarcmapping>`__ from your legacy + system to Koha fields and migrate (remembering to use the collection, + shelving, item type and library codes you entered in the above + setting areas) + +- `Map your patron data <#patronimport>`__ from your legacy system to + the Koha fields and migrate (remembering to use the patron and + library codes you defined above) + +- Test your migrated data to be sure that everything is as you expect + it to be, some things to test include: + + - Check some of your titles with diacritics and make sure that they + migrated properly. + + - Check titles in a series and make sure that series information + migrated properly. + + - Make sure that your patrons have their contact information in the + right fields. + + - If your serials data was migrated search for these records in the + catalog and confirm that they look right. + + - If your serials data was migrated search for these records in the + serials module and confirm that they look right. + + - Check marc records to verify a variety of items are cataloged + correctly + + - Check cataloging process to see if all necessary fields are + available + + - If fines are migrated, check to see that they are applied + correctly + + - If holds are migrated, check to see they are accurate in catalog + and patron record + +`Admin Configuration <#impadmin>`__ +----------------------------------- + +Most of these preferences won't need to be changed to use your Koha +system, but there are a few that you might want to customize. + +- If your library uses CAS Authentication, you'll want to set the + various `CAS system preferences <#casauthentication>`__ + +- Administration System Preferences + + - `KohaAdminEmailAddress <#KohaAdminEmailAddress>`__ : This is the + email address that will be used by the system in 'from' lines and + to send errors to if there is no email set for the branch + + - `noItemTypeImages <#noItemTypeImages>`__ : Decide if you want to + show item type icons in the staff client and opac + + - `delimiter <#delimiter>`__ : This value will be put in between + fields when exporting data from Koha + + - `virtualshelves <#virtualshelves>`__ : Decide if you want the + staff and/or patrons to use lists in Koha + + - `AutoLocation <#AutoLocation>`__ : Require staff to log in to the + staff client from a specific IP range + + - `IndependentBranches <#IndependentBranches>`__ : Prevent + librarians from editing content that belongs to other branches + +- Go through the `Log System Preferences <#logs>`__ and decide which + actions you want to keep track of in the logs + +- Decide if you'd like to share your library's information with the + Koha community by setting the `Sharing system + preferences <#heaprefs>`__. + +- Decide what `cron jobs <#cronjobsch>`__ you need to run and when. + + - If you're using the long overdue cron job be sure to set your + `DefaultLongOverdueChargeValue <#DefaultLongOverdueChargeValue>`__, + `DefaultLongOverdueLostValue <#DefaultLongOverdueLostValue>`__ & + `DefaultLongOverdueDays <#DefaultLongOverdueLostValue>`__ + preferences. + +`Localization Configuration <#implocal>`__ +------------------------------------------ + +Koha is used worldwide and so you need to make sure you set your +localization preferences so that options throughout Koha appear properly +for your location/language. + +- Localization/Internationalization System Preferences + + - `dateformat <#dateformat>`__ : Decide how dates are displayed + throughout Koha + + - `opaclanguagesdisplay <#opaclanguagesdisplay>`__ : Decide if + patrons can choose what language the OPAC appears in + + - `opaclanguages <#opaclanguages>`__ : Decide which languages the + patrons can choose from + + - `language <#languagepref>`__ : Decide which languages appear in + the staff client + + - `CalendarFirstDayOfWeek <#CalendarFirstDayOfWeek>`__ : Define your + first day of the week + +`Circulation Configuration <#impcirc>`__ +---------------------------------------- + +Before you start circulating your collection you'll need to set up your +rules and preferences for circulation. + +- Define your `Circulation/Fine rules <#circfinerules>`__ + +- Enter the `days your library is closed <#calholidays>`__ for fines + and due date calculations + +- Circulation System Preferences + + - `CircControl <#CircControl>`__ : Define whether circ rules are + based on item's location, patron's location or transaction + location + + - `useDaysMode <#useDaysMode>`__ : Define how due dates are + calculated + + - `finesCalendar <#finesCalendar>`__ : Define how fines are + calculated (for every late date or only for days the library is + open) + + - `SpecifyDueDate <#SpecifyDueDate>`__ : Decide if staff are allowed + to override due dates on checkout + + - `SpecifyReturnDate <#SpecifyReturnDate>`__ : Decide if you want to + let the staff specify an arbitrary return date on checkin + + - `itemBarcodeFallbackSearch <#itemBarcodeFallbackSearch>`__ : + Decide if you want staff to be able to checkout using a keyword + search (title, call number, etc) + + - `AutomaticItemReturn <#AutomaticItemReturn>`__ : Decide if items + are sent back to the owning branch when checked in + + - `todaysIssuesDefaultSortOrder <#todaysIssuesDefaultSortOrder>`__ : + Decide how items checked out today display on the patron record + + - `previousIssuesDefaultSortOrder <#previousIssuesDefaultSortOrder>`__ + : Decide how items checked out prior to today display on the + patron record + + - `noissuescharge <#noissuescharge>`__ : Define the maximum amount a + patron can owe before checkouts are blocked + + - `ReturnBeforeExpiry <#ReturnBeforeExpiry>`__ : Decide if patrons + need to return items before their accounts expire + + - `AllowHoldsOnDamagedItems <#AllowHoldsOnDamagedItems>`__ : Decide + if patrons can place holds on items that are marked as damaged + + - `AllowHoldPolicyOverride <#AllowHoldPolicyOverride>`__ : Decide + if you want the staff to be able to override the setting for + the above at checkout + + - `maxreserves <#maxreserves>`__ : Decide how many items a patron + can have on hold at once + + - `AllowHoldPolicyOverride <#AllowHoldPolicyOverride>`__ : Decide + if you want the staff to be able to override the setting for + the above at checkout + + - `maxoutstanding <#maxoutstanding>`__ : Define the maximum amount a + patron can owe before holds are blocked + + - `AllowHoldPolicyOverride <#AllowHoldPolicyOverride>`__ : Decide + if you want the staff to be able to override the setting for + the above at checkout + + - `ReservesMaxPickUpDelay <#ReservesMaxPickUpDelay>`__ : Define the + number of days before a hold expires + + - `WebBasedSelfCheck <#WebBasedSelfCheck>`__ : Decide if you want to + use the built in web-based self-checkout system + + - `AutoSelfCheckAllowed <#AutoSelfCheckAllowed>`__ : Decide if + the self-checkout system requires login + + - `ShowPatronImageInWebBasedSelfCheck <#ShowPatronImageInWebBasedSelfCheck>`__ + : Decide if you want patron images to show on the self checkout + screen + + - `AllowNotForLoanOverride <#AllowNotForLoanOverride>`__ : Decide if + you want the staff to be able to checkout items marked as 'not for + loan' + + - `AllowRenewalLimitOverride <#AllowRenewalLimitOverride>`__ : + Decide if you want staff to override the limit put on renewals + + - `AllowFineOverride <#AllowFineOverride>`__ : Decide if you want + staff to be able to override fine limits + + - `AllowTooManyOverride <#AllowTooManyOverride>`__ : Descide if you + want staff to be able to check out more than the limit to a patron + + - `RenewalPeriodBase <#RenewalPeriodBase>`__ : Decide what date + renewals are based on + + - `finesMode <#finesMode>`__ : Switch to 'Calculate and Charge' + before go live if you charge fines + + - `OverdueNoticeBcc <#OverdueNoticeBcc>`__ : If you want to receive + a copy of every overdue notice sent out, enter your email address + here + + - `emailLibrarianWhenHoldIsPlaced <#emailLibrarianWhenHoldIsPlaced>`__ + : Decide if you want an email every time a hold is placed + + - `ReservesControlBranch <#ReservesControlBranch>`__ : Decide which + branch's hold rules are considered first + + - `soundon <#AudioAlerts>`__ : Decide if you want to have sounds on + for circulation actions + + - `FilterBeforeOverdueReport <#FilterBeforeOverdueReport>`__ : If + you have a large amount of overdues, you might want to turn this + preference on so as to allow you to filter before results appear + + - `DisplayClearScreenButton <#DisplayClearScreenButton>`__ : If you + have a lot of staff members sharing one circ computer you might + want to enable this so that staff can clear the screen in between + checkouts to protect patron's privacy + + - `CircAutoPrintQuickSlip <#CircAutoPrintQuickSlip>`__ : Decide how + you want Koha to react if you scan in a blank barcode on the + checkout screen + + - `SuspendHoldsIntranet <#SuspendHoldsIntranet>`__ and/or + `SuspendHoldsOpac <#SuspendHoldsOpac>`__ : Decide if you want + patrons and/or staff to be able to suspend holds + + - `AutoResumeSuspendedHolds <#AutoResumeSuspendedHolds>`__ : If + you allow holds to be suspended decide if you want them to + automatically resume on the date entered by the staff and/or + patron + + - `OnSiteCheckouts <#OnSiteCheckouts>`__ : Decide if you want to + allow items to be checked out for use within the library + + - `RecordLocalUseOnReturn <#RecordLocalUseOnReturn>`__ : Set this to + record local use of items when you check them in + +- Customize your `Notices & Slips <#notices>`__ + +- Define your `Overdue Notice Triggers <#noticetriggers>`__ + +- Set up your `cron jobs <#cronjobs>`__ + + - Populate `your holds queue <#buildholdscron>`__ (every 1-4 hours) + + - Decide `when holds expire <#expiredholdscron>`__ (daily) + + - `Calculate fines due <#finescronjob>`__ (daily) + + - Fines on hourly loans will calculate when you check the items + in + + - `Mark long overdue items as lost <#longoverduecron>`__ (daily) + + - Decide when the system `sends out messages <#msgqueuecron>`__ (1-4 + hours) + + - Decide when the system `queues overdue + notices <#overduenoticecron>`__ (daily) + + - Set up `hold notices that didn't send for + printing <#printholdcron>`__ (daily after overdues and message + queue) + + - Decide when the system `queues the advanced notice of items + due <#advnoticecron>`__ (daily) + + - Find holds that need to be `resumed and remove + suspension <#unsuspendholdcron>`__ (daily) + + - If you're allowing automatic renewal of items `set them to + renew <#autorenewcron>`__ (nightly) + +`Patron Configuration <#imppratrons>`__ +--------------------------------------- + +You have already imported patron data from your old system, but there +are plenty of options available to you regarding patrons and their +accounts. + +- Enter your `staff members as patrons <#addstaffpatron>`__ + + - Define `staff members access permissions <#patronpermissions>`__ + +- Patron System Preferences + + - `autoMemberNum <#autoMemberNum>`__ : Decide if the patrons + barcodes are auto-generated or if you enter them yourself + + - `MaxFine <#MaxFine>`__ : Determine the maximum amount that people + can owe in fines + + - `NotifyBorrowerDeparture <#NotifyBorrowerDeparture>`__ : Decide + when to warn staff that the patron account is about to expire + + - `intranetreadinghistory <#intranetreadinghistory>`__ : Decide if + the staff can see the patron's reading/checkout history + + - `BorrowerMandatoryField <#BorrowerMandatoryField>`__ : List fields + that you want to appear as mandatory on the patron add/edit form + + - `BorrowersTitles <#BorrowersTitles>`__ : Add or change the titles + for your patrons + + - `borrowerRelationship <#borrowerRelationship>`__ : Add or change + borrower relationships (child to adult and professional to + organization) + + - `AutoEmailPrimaryAddress <#AutoEmailPrimaryAddress>`__ : Determine + if the patrons get an email confirming the creation of their + account + + - `EnhancedMessagingPreferences <#EnhancedMessagingPreferences>`__ : + Decide if staff can choose from a series of notices (other than + overdues) for patrons + + - `EnhancedMessagingPreferencesOPAC <#EnhancedMessagingPreferencesOPAC>`__: + Decide if patrons can choose from a series of notices (other than + ovedues) for themselves + + - `patronimages <#patronimages>`__ : Decide if you want to save + patron images in your system + + - `ExtendedPatronAttributes <#ExtendedPatronAttributes>`__ : Decide + if you want to enable custom patron fields + + - `minPasswordLength <#minPasswordLength>`__ : Enter the minimum + number of characters you want passwords to have + + - `BorrowerUnwantedField <#BorrowerUnwantedField>`__ : Decide what + fields your library doesn't need to see on the patron entry form + +- Set up your `cron jobs <#cronjobs>`__ + + - Decide if you would like `children to automatically be come + adults <#j2acron>`__ + +`Cataloging Configuration <#impcatalog>`__ +------------------------------------------ + +Before you start cataloging in Koha you'll want to set up your +preferences and other rules. + +- Define your cataloging templates aka `MARC Bibliographic + Frameworks <#marcbibframeworks>`__ + + - Run the `MARC Bibliographic Framework + Test <#marcbibframeworkstest>`__ to be sure your changes are valid + +- Define any `authorized values <#authorizedvalues>`__ you might want + to use in cataloging + +- Set up `custom classification sources <#classificationsources>`__ (if + you use something other than the defaults) + +- Set up `MARC matching rules <#recordmatchingrules>`__ for importing + records from mrc files or Z39.50 + +- Set up `Koha to Keyword mapping <#keywordmapping>`__ for deciding how + to display marc fields to the screen (still in beta - only one field) + +- Set up the `Z39.50 targets <#z3950admin>`__ you want to search for + cataloging (and acquisitions) + +- Cataloging System Preferences + + - `URLLinkText <#URLLinkText>`__ : Enter text to display when 856 + fields do not have pre-defined labels + + - `hide\_marc <#hide_marc>`__ : If you are unfamiliar with MARC you + can have the MARC fields number hidden + + - `LabelMARCView <#LabelMARCView>`__ : Choose how you want duplicate + fields to appear on the editor + + - `DefaultClassificationSource <#DefaultClassificationSource>`__ : + Choose which classification source is the default in your library + + - `advancedMARCeditor <#advancedMARCeditor>`__ : Decide if you need + labels to appear on your MARC editor + + - `marcflavour <#marcflavour>`__ : Choose your MARC format + + - `itemcallnumber <#itemcallnumber>`__ : Enter which field and + subfields to look into for the call number + + - `MARCOrgCode <#MARCOrgCode>`__ : Enter your MARC Organizational + Code (not the same as your OCLC number) + + - `autoBarcode <#autoBarcode>`__ : Decide if Koha generates item + barcodes for you + + - `OpacSuppression <#OpacSuppression>`__ : Decide if you want to + hide items marked as suppressed from the OPAC search results + +- Set up your `cron jobs <#cronjobs>`__ + + - Decide when the system `checks URLs in catalog + records <#checkurlcron>`__ to see if they are still valid + +`Authorities Configuration <#impauthorities>`__ +----------------------------------------------- + +Koha has the ability to keep track of your authority records and how +they're linked to your bibliographic records. Before using authorities +you should configure several preferences. + +- Set `Authority Frameworks <#authoritiesadmin>`__ aka templates + +- Authority System Preferences + + - `BiblioAddsAuthorities <#BiblioAddsAuthorities>`__ : Decide if + Koha creates authorities when cataloging + + - `dontmerge <#dontmerge>`__ : Decide if updates to authorities + trigger updates to the bibliographic records that link to them + + - `AutoCreateAuthorities <#AutoCreateAuthorities>`__ : Decide when + authorities are created + + - `LinkerModule <#LinkerModule>`__ : Decide which match the + authority linker should use + + - `LinkerOptions <#LinkerOptions>`__ : Decide if you want authority + linking to be broader or more specific + + - `CatalogModuleRelink <#CatalogModuleRelink>`__ : Decide if you + want to enable authority linking while cataloging + +- Set up your `cron jobs <#cronjobs>`__ + + - Choose when the system looks for authorities updates to `merge + changes into bibliographic records <#mergeauthcron>`__ + +`Searching Configuration <#impsearching>`__ +------------------------------------------- + +There are several system preferences related to searching, it is not +always recommended to make too many changes to these preferences since +they are set to get you the most relevant results. If you would like to +change the default way that Koha handles searching, view the `Searching +system preferences <#searchingprefs>`__ tab. + +- Set up your `cron jobs <#cronjobs>`__ + + - Decide how often your `system rebuilds the search + index <#rebuildsearchcron>`__ (4-10 min) + +- Searching System Preferences + + - `AdvancedSearchTypes <#AdvancedSearchTypes>`__ : Decide which + authorized value fields you want patrons and staff to be able to + limit their advanced searches by + + - `AdvancedSearchLanguages <#AdvancedSearchLanguages>`__ : Decide + which languages you want people to be able to limit to via the + search engine + + - `UseAuthoritiesForTracings <#UseAuthoritiesForTracings>`__ : + Decide how you want Koha to handle subject searches in the OPAC + + - `TraceCompleteSubfields <#TraceCompleteSubfields>`__ : Decide + how you want Koha to handle subject searches in the OPAC + + - `TraceSubjectSubdivisions <#TraceSubjectSubdivisions>`__ : + Decide how you want Koha to handle subject searches in the OPAC + + - `displayFacetCount <#displayFacetCount>`__ : Decide whether to + show facet counts on search results + +`OPAC Configuration <#impopac>`__ +--------------------------------- + +There are a lot of ways you can customize your OPAC in Koha. + +- Decide how you want your OPAC to look & what content you want on the + main page + +- Create a library branded stylesheet using CSS + + - **Important** + + Do not edit the default CSS files, instead create a new one, + that way the system can always fall back on the original CSS. + +- Create a custom XSLT stylesheet to change the way search results and + bib records appear in the OPAC + +- OPAC System preferences + + - `OPACBaseURL <#OPACBaseURL>`__ : Enter your library's url + + - `opacuserlogin <#opacuserlogin>`__ : Decide if you want to allow + patrons to login to the OPAC to access customized functionality + (searching will be allowed without logging in) + + - `RequestOnOpac <#RequestOnOpac>`__ : Decide if patrons can + place holds via the OPAC + + - `OpacPasswordChange <#OpacPasswordChange>`__ : Decide if + patrons can change their password (don't allow this if you're + using LDAP) + + - `OpacRenewalAllowed <#OpacRenewalAllowed>`__ : Decide if + patrons can renew their checked out items via the OPAC + + - `opacreadinghistory <#opacreadinghistory>`__ : Decide if + patrons can view their reading/checkout history via the OPAC + + - `reviewson <#reviewson>`__ : Decide if you want to allow + patrons to comment on bib records via the OPAC + + - `OpacStarRatings <#OpacStarRatings>`__ : Decide if patrons can + leave star ratings + + - `virtualshelves <#virtualshelves>`__ : Decide if you want + patrons to be able to create Lists + + - `OpacAllowPublicListCreation <#OpacAllowPublicListCreation>`__ + : If patrons can create lists then decide if they are allowed + to create public lists + + - `suggestion <#suggestionspref>`__ : Decide if you want patrons + to be able to submit purchase suggestions + + - `OPACViewOthersSuggestions <#OPACViewOthersSuggestions>`__ : + Decide if you want patrons to be able to see purchase + suggestions made by other patrons + + - `opacbookbag <#opacbookbag>`__ : Decide if patrons can save items + into their cart + + - `AnonSuggestions <#AnonSuggestions>`__ : Decide if you want non + logged in users to be able to make purchase suggestions + + - `LibraryName <#LibraryName>`__ : Enter your library name for + display in the tag and on the top of the OPAC + + - `opaccredits <#opaccredits>`__ : Enter HTML to appear at the + bottom of every page in the OPAC + + - `OpacMainUserBlock <#OpacMainUserBlock>`__ : Enter HTML that will + appear in the center of the main OPAC page + + - `OpacNav <#OpacNav>`__ : Enter HTML that will appear to the left + on the main OPAC page + + - `OpacNavBottom <#OpacNavBottom>`__ : Enter HTML that will appear + below OpacNav + + - `OpacNavRight <#OpacNavRight>`__ : Enter HTML that will appear + below the login box on the right + + - `opacheader <#opacheader>`__ : Enter the HTML that will appear + above the search box on the OPAC + + - `OPACNoResultsFound <#OPACNoResultsFound>`__ : Enter the HTML that + will appear when no results are found + + - `OPACResultsSidebar <#OPACResultsSidebar>`__ : Enter the HTML that + will appear below the facets on your search results + + - `OPACMySummaryHTML <#OPACMySummaryHTML>`__ : Enter the HTML that + will appear in the far right of the circulation summary in the + OPAC + + - Customize your stylesheets: + + - `OPACUserCSS <#OPACUserCSS>`__ : Enter any additional fields + you want to define styles for + + - `opaclayoutstylesheet <#opaclayoutstylesheet>`__ : Point to a + CSS file on your Koha server + + - `OpacHighlightedWords <#OpacHighlightedWords>`__ : Decide if you + want search terms to be highlighted on the search results + + - `hidelostitems <#hidelostitems>`__ : Decide if you want to show + patrons items you have marked as lost + + - `BiblioDefaultView <#BiblioDefaultView>`__ : Decide what view is + the default for bib records on the OPAC + + - `OPACShelfBrowser <#OPACShelfBrowser>`__ : Decide if you want to + enable the shelf browse functionality + + - `OPACURLOpenInNewWindow <#OPACURLOpenInNewWindow>`__ : Decide if + URLs clicked in the OPAC are opened in a new window + + - `SearchMyLibraryFirst <#SearchMyLibraryFirst>`__ : If you have a + multi-branch system decide if you want patrons to search their + library first + + - `OpacAuthorities <#OpacAuthorities>`__ : Decide if you want + patrons to be able to search your authority file + + - `OpacBrowser <#OpacBrowser>`__ : Decide if you want patrons to + browse your authority file (French libraries only) + + - `OPACSearchForTitleIn <#OPACSearchForTitleIn>`__ : Choose which + libraries you want patrons to be able to re-run their search in + + - `OpacAddMastheadLibraryPulldown <#OpacAddMastheadLibraryPulldown>`__ + : If you're a multi-branch system you can add a pull down to the + search bar for patrons to search which library to search + + - `EnableOpacSearchHistory <#EnableOpacSearchHistory>`__ : Decide if + you want the system to keep a search history + +- Set up your `cron jobs <#cronjobs>`__ + + - If you have the `OpacBrowser <#OpacBrowser>`__ preference set + decide `when you want the contents to + rebuild <#authbrowsercron>`__ (French libraries only) + + - If you have `custom RSS feeds <#customrss>`__, decide when you + want the `feed to be populated <#customrssfeedcron>`__ + +`Editable OPAC Regions <#editableopac>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Using the OPAC system preferences you can customize various regions, the +following graphic will define what preferences update each of the +regions in the Bootstrap theme. + +OPAC Editable Regions +|image1068| + +`Enhanced Content Configuration <#impenhanced>`__ +------------------------------------------------- + +Koha allows you to pull in content from outside sources to enhance your +bib records. All of this content can be toggled on and off using the +enhanced content system preferences. + +- `FRBR/Editions <#frbrenhancedprefs>`__ + + - If you would like to have your OPAC and/or staff client show an + 'Editions' tab on the bib record, you want to enable one or the + other FRBR preferences and then either one or both of the ISBN + services (XISBN and ThingISBN). + +- `Amazon <#amazonprefs>`__ : This service is free and just requires + that you visit http://aws.amazon.com to sign up + + - Using the Amazon preferences you can choose to show cover images + from Amazon. + +- `Babelthèque <#Babelthequeprefs>`__ + + - This is a pay service. Contact Babelthèque to learn how to enable + this content in the OPAC. + +- `Baker and Taylor <#btcontentprefs>`__ + + - This is a pay service from Baker & Taylor. Contact Baker & Taylor + for the information to enter into these preferences. + +- `HTML5 Media <#html5>`__ + + - This allows libraries to embed streaming media in their catalog + +- `Google <#googleprefs>`__ + + - This service is free and does not require registration, simply + enable GoogleJackets and you're set to go. + +- `I Deam Books <#IDreamLibraries>`__ + + - This is a free service that compiles reviews for popular titles + from many different sources. + +- `LibraryThing <#librarythingprefs>`__ + + - With the exception of ThingISBN, you will need to contact + LibraryThing for the information to enter into these preferences + + - Enabling ThingISBN will help to populate the editions tab on the + bib record display if you have enabled FRBR. + +- `Novelist <#novelistselect>`__ + + - This is a pay service from Ebsco. Contact Ebsco for the + information to enter into these preferences + +- `OCLC <#oclcprefs>`__ + + - XISBN is used to populate the editions tab on the bib record + display if you have enabled FRBR. This service is free for up to + 999 queries a day. + +- `Open Library <#OpenLibraryPrefs>`__ + + - Open Library project is an open system that you can pull cover + images (and in the future additional content) from + +- `Overdrive <#overdriveprefs>`__ + + - This is a pay service that libraries can subscribe to for ebook + content. If the library subscribes to Overdrive they can integrate + that content in to Koha for free. + +- `Syndetics <#Syndeticsprefs>`__ + + - This is a pay service from Syndetics to add content for your bib + records. Contact Syndetics for the information to enter into these + preferences. + +- `Tagging <#taggingprefs>`__ + + - Choose whether or not you want to allow patrons to add tags to + records in Koha. + +`Acquisitions Configuration <#impacq>`__ +---------------------------------------- + +When using acquisitions in Koha you first need to define some defaults. + +- Set up your `funds & budgets <#budgetplanning>`__ + +- Choose your `default currency <#currexchangeadmin>`__ and enter + others if you order from multiple countries + +- Enter in your `vendor information <#acqvendors>`__ + +- Create an `Framework with the code ACQ <#marcbibframeworks>`__ (if + you're going to enter item records at the time of ordering or + receiving) + +- Acquisitions System preferences + + - `AcqCreateItem <#AcqCreateItem>`__ : Decide if an item record is + created during acquisition + + - `CurrencyFormat <#CurrencyFormat>`__ : Decide how you want + monetary amounts to display + + - `gist <#gist>`__ : Enter your sales tax (if you are billed for + tax) + + - `OrderPdfFormat <#OrderPdfFormat>`__ : Decide what format you want + your print orders to use + +`Serials Configuration <#impserials>`__ +--------------------------------------- + +When you use serials there are a few options you can set before hand. + +- Serials System Preferences + + - `RenewSerialAddsSuggestion <#RenewSerialAddsSuggestion>`__ : + Decide if you want renewing serials to add a suggestion for easy + purchasing + + - `RoutingSerials <#RoutingSerials>`__ : Decide if you want to route + serials around your library + + - `RoutingListAddReserves <#RoutingListAddReserves>`__ : Decide if + holds are placed on serials when there is a routing list in place + +- Cataloging System Preferences + + - `StaffSerialIssueDisplayCount <#StaffSerialIssueDisplayCount>`__ : + Decide how many of the most recent issues to display in the staff + client + + - `OPACSerialIssueDisplayCount <#OPACSerialIssueDisplayCount>`__ : + Decide how many of the most recent issues to display in the OPAC + + - `SubscriptionHistory <#SubscriptionHistory>`__ : Decide how you + want the subscription information to display in the OPAC + +`Planning for Go-Live <#impgolive>`__ +------------------------------------- + +Once you have all of your settings ready, you need to prepare for making +your system live: + +- Decide if you need training by an outside service or if your staff + can do the training themselves. + +- Make sure that there is time for your staff to play with your test + system and get comfortable with it + +- If this is a migration, work with your previous company to extract + data right before you go live + +- Come up with URLs for your new Koha OPAC & Staff Client + +- Make sure that if you're hosting your own system you have a backup + plan + +SOPAC2 Installation +=================== + +`Introduction <#sopacintro>`__ +------------------------------ + +This is an installation guide for SOPAC2 and its Koha connector. It has +been tested on Debian Lenny and Ubuntu Jaunty with Drupal 6.12 and Koha +3.0.x. It does not cover the installation of Koha and Drupal, only +SOPAC, its dependencies and the connector. + +`Installation of Locum and Insurge <#sopacinstall>`__ +----------------------------------------------------- + +Locum and Insurge are the two libraries used primarily by SOPAC. They +serve as a layer of abstraction to the data. Insurge manages the social +aspect (tags, reviews, ratings), while Locum manages the connection to +the ILS via the connector. Both libraries use a different database from +that of Drupal. + +`Dependencies <#sopacdepend>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +There are no packages for Debian MDB2 yet, you can install it via pear: + +:: + + # apt-get install php-pear + # pear install MDB2 + # pear install MDB2#mysql + +`Download <#sopacdownload>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Download the Locum and Insurge libraries from SVN: + +:: + + # cd /usr/local/lib + # svn co http://dobby.darienlibrary.org/svn/locum/trunk/ locum + # svn co http://dobby.darienlibrary.org/svn/insurge/trunk/ insurge + +`Creation of the Database <#sopaccreatedb>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +:: + + $ mysql -u root + mysql> create database scas; + mysql> grant all privileges on scas.* to scas_user@'localhost' identified by 'scas_pass'; + mysql> flush privileges; + mysql> exit + +`Sync DSN <#sopacdsn>`__ +~~~~~~~~~~~~~~~~~~~~~~~~ + +This file will provide the connection information to a DB libraries: + +:: + + # nano /usr/local/etc/locum_insurge_dsn.php + +It should contain: + +:: + + <?php + $dsn = 'mysql://scas_user:scas_pass@localhost/scas'; + +`Installation of Insurge <#sopacinstallinsurge>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If you customize the name of the database, remember to edit the sql +file: + +:: + + # nano /usr/local/lib/insurge/sql/scas_insurge.sql + +Import Insurge: + +:: + + $ mysql -u root -p < /usr/local/lib/insurge/sql/scas_insurge.sql + +Configure Insurge: + +:: + + # nano /usr/local/lib/insurge/config/insurge.ini + +The variables in insurge.ini are empty. The default values are too long +and cause MySQL errors. + +Here is a sample of insurge.ini + +:: + + ; This is the Locum configuration file + ; General configuration options for your installation of Insurge. + [insurge_config] + dsn_file = "/usr/local/etc/locum_insurge_dsn.php" + ; This is where you configure your repository membership information. + ; + ; parent_server is the server name of the repository parent server you have been + ; told to use. + ; group_id = The group ID you have been given by your repository admin. + ; These configuration points are OPTIONAL and are only necessary if you are + ; participating in a repository relationship. + [repository_info] + parent_server = "" + group_id = "" + group_key = "" + +`Installation of Locum <#sopacinstallocum>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The same procedure applies to Locum + +:: + + # nano /usr/local/lib/locum/sql/scas_locum.sql + # mysql < /usr/local/lib/locum/sql/scas_locum.sql + # nano /usr/local/lib/locum/sql/locum_init.sql + # mysql < /usr/local/lib/locum/sql/locum_init.sql + # nano /usr/local/lib/locum/config/locum.ini + # mkdir /usr/local/var + # mkdir /usr/local/var/log + +Configure the DSN: + +:: + + [locum_config] + dsn_file = "/usr/local/etc/locum_insurge_dsn.php" + +And the information for your Koha installation: + +:: + + [ils_config] + ils = "koha"; + ils_version = "30x" + ils_server = "localhost" + ils_harvest_port = "80" + +The rest depends on your Koha configuration. + +`Installation of Koha Connector <#sopackoha>`__ +----------------------------------------------- + +Download the Koha connector using SVN: + +:: + + # cd /usr/local/lib/locum/connectors/ + # svn co http://dobby.darienlibrary.org/svn/connectors/koha/ locum_koha_30x + +`Harvest Records <#sopacharvest>`__ +----------------------------------- + +Now that the connector is in place, we will be able to launch +harvest.php, a tool that will reap Locum DB Koha and fill the locum. + +Start by configuring harvest.php: + +:: + + # nano /usr/local/lib/locum/tools/harvest.php + +Here are the variables you must change: + +:: + + $first_record = 1; + $last_record = 30; + +These are the minimum and maximum biblionumbers from your Koha install. + +Then start the harvest: + +:: + + # chmod +x /usr/local/lib/locum/tools/harvest.php + $ /usr/local/lib/locum/tools/harvest.php + +`Installation of Sphinx <#sopacphinx>`__ +---------------------------------------- + +Sphinx is the indexer for the database used by Locum and Insurge. + +`Dependencies <#sphinxdepend>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +There is no Debian package for Sphinx so you'll have to compile the +source directly: + +:: + + # apt-get install g++ make libmysql++-dev + +`Download and Compile <#sphinxdownload>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +:: + + $ wget http://sphinxsearch.com/downloads/sphinx-0.9.8.tar.gz + $ tar zxvf sphinx-0.9.8.tar.gz + $ cd sphinx-0.9.8 + $ ./configure --prefix=/usr/local/sphinx + $ make + # make install + # mkdir /usr/local/sphinx + # mkdir /usr/local/sphinx/lib + # cp api/sphinxapi.php /usr/local/sphinx/lib/ + $ rm -R sphinx-0.9.8* + +`Creation of User and Group <#sphinxuser>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Creating a Sphinx user and change the owner: + +:: + + # adduser sphinx + # addgroup sphinx + # usermod -G sphinx sphinx + # mkdir /usr/local/sphinx/var/run + # chown -R sphinx.sphinx /usr/local/sphinx/var + +`The Sphinx daemon <#demonsphinx>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Download: + +:: + + # cd /etc/init.d + # wget http://www.thesocialopac.net/sites/thesocialopac.net/files/sphinx + # chmod +x /etc/init.d/sphinx + +Add Sphinx to the default boot services: + +:: + + # update-rc.d sphinx defaults + +`Configuration <#sphinxconfig>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Copy the configuration file supplied with the source of Sphinx before +the change: + +:: + + # cp /usr/local/lib/locum/sphinx/sphinx.conf /usr/local/sphinx/etc/ + # sed 's/locum_db_user/scas_user/g' /usr/local/sphinx/etc/sphinx.conf > tmpfile; + mv tmpfile /usr/local/sphinx/etc/sphinx.conf + # sed 's/locum_db_pass/scas_pass/g' /usr/local/sphinx/etc/sphinx.conf > tmpfile; mv tmpfile /usr/local/sphinx/etc/sphinx.conf + +And if you personalize the name of the database: + +:: + + # sed 's/scas/MY_DB/g' /usr/local/sphinx/etc/sphinx.conf > tmpfile; mv tmpfile /usr/local/sphinx/etc/sphinx.conf + +`Indexing documents <#sphinxindexing>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Indexing is necessary if you want to use the search features of SOPAC. + +You must first complete the Insurge table index + +:: + + # chmod +x /usr/local/lib/insurge/tools/update-index.php + $ /usr/local/lib/insurge/tools/update-index.php + +Then start indexing Sphinx + +:: + + $ /usr/local/sphinx/bin/indexer --all + +Finally, we must start the daemon: + +:: + + # /etc/init.d/sphinx start + +When the daemon is running, you can update the index with: + +:: + + $ /usr/local/sphinx/bin/indexer --all --rotate + +`Installation of SOPAC2 <#installsopac>`__ +------------------------------------------ + +Now to the SOPAC software itself: + +`Download <#downloadsopac>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Download from SVN: + +:: + + $ cd /chemin/vers/drupal/sites/all/ + $ mkdir modules + $ cd modules/ + $ svn co http://dobby.darienlibrary.org/svn/sopac/trunk/ sopac + +`Installation <#sopacinstallation>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +In Drupal's administration settings, activate the module. Also, enable +the dependencies: + +- Profile + +- PHP Filter + +- Path + +The Drupal menu should now list these entries. + +`Configuration <#configsopac>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Then go into the settings of SOPAC. + +- Configure the paths to the Locum and Insurge libraries + +- Choose a URL prefix SOPAC, in my "catalog". Create a node with + content like: + +:: + + <?php + print sopac_search_form('both'); + print theme('pages_catalog'); + +- Check the Input Format "PHP Code" + +- Check Move to front page + +- In URL path settings, set the SOPAC URL prefix you have chosen. + +Go to the root of Drupal, a search form will appear. + +Remember to empty Drupal's cache when something does not work. + +Drupal offers a few blocks, which are not configured by default. You +must specify on which page they should appear. diff --git a/en/source/16_sopac.rst b/en/source/16_sopac.rst new file mode 100644 index 0000000..a7c187a --- /dev/null +++ b/en/source/16_sopac.rst @@ -0,0 +1,357 @@ +.. include:: images.rst + +SOPAC2 Installation +=================== + +`Introduction <#sopacintro>`__ +------------------------------ + +This is an installation guide for SOPAC2 and its Koha connector. It has +been tested on Debian Lenny and Ubuntu Jaunty with Drupal 6.12 and Koha +3.0.x. It does not cover the installation of Koha and Drupal, only +SOPAC, its dependencies and the connector. + +`Installation of Locum and Insurge <#sopacinstall>`__ +----------------------------------------------------- + +Locum and Insurge are the two libraries used primarily by SOPAC. They +serve as a layer of abstraction to the data. Insurge manages the social +aspect (tags, reviews, ratings), while Locum manages the connection to +the ILS via the connector. Both libraries use a different database from +that of Drupal. + +`Dependencies <#sopacdepend>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +There are no packages for Debian MDB2 yet, you can install it via pear: + +:: + + # apt-get install php-pear + # pear install MDB2 + # pear install MDB2#mysql + +`Download <#sopacdownload>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Download the Locum and Insurge libraries from SVN: + +:: + + # cd /usr/local/lib + # svn co http://dobby.darienlibrary.org/svn/locum/trunk/ locum + # svn co http://dobby.darienlibrary.org/svn/insurge/trunk/ insurge + +`Creation of the Database <#sopaccreatedb>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +:: + + $ mysql -u root + mysql> create database scas; + mysql> grant all privileges on scas.* to scas_user@'localhost' identified by 'scas_pass'; + mysql> flush privileges; + mysql> exit + +`Sync DSN <#sopacdsn>`__ +~~~~~~~~~~~~~~~~~~~~~~~~ + +This file will provide the connection information to a DB libraries: + +:: + + # nano /usr/local/etc/locum_insurge_dsn.php + +It should contain: + +:: + + <?php + $dsn = 'mysql://scas_user:scas_pass@localhost/scas'; + +`Installation of Insurge <#sopacinstallinsurge>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If you customize the name of the database, remember to edit the sql +file: + +:: + + # nano /usr/local/lib/insurge/sql/scas_insurge.sql + +Import Insurge: + +:: + + $ mysql -u root -p < /usr/local/lib/insurge/sql/scas_insurge.sql + +Configure Insurge: + +:: + + # nano /usr/local/lib/insurge/config/insurge.ini + +The variables in insurge.ini are empty. The default values are too long +and cause MySQL errors. + +Here is a sample of insurge.ini + +:: + + ; This is the Locum configuration file + ; General configuration options for your installation of Insurge. + [insurge_config] + dsn_file = "/usr/local/etc/locum_insurge_dsn.php" + ; This is where you configure your repository membership information. + ; + ; parent_server is the server name of the repository parent server you have been + ; told to use. + ; group_id = The group ID you have been given by your repository admin. + ; These configuration points are OPTIONAL and are only necessary if you are + ; participating in a repository relationship. + [repository_info] + parent_server = "" + group_id = "" + group_key = "" + +`Installation of Locum <#sopacinstallocum>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The same procedure applies to Locum + +:: + + # nano /usr/local/lib/locum/sql/scas_locum.sql + # mysql < /usr/local/lib/locum/sql/scas_locum.sql + # nano /usr/local/lib/locum/sql/locum_init.sql + # mysql < /usr/local/lib/locum/sql/locum_init.sql + # nano /usr/local/lib/locum/config/locum.ini + # mkdir /usr/local/var + # mkdir /usr/local/var/log + +Configure the DSN: + +:: + + [locum_config] + dsn_file = "/usr/local/etc/locum_insurge_dsn.php" + +And the information for your Koha installation: + +:: + + [ils_config] + ils = "koha"; + ils_version = "30x" + ils_server = "localhost" + ils_harvest_port = "80" + +The rest depends on your Koha configuration. + +`Installation of Koha Connector <#sopackoha>`__ +----------------------------------------------- + +Download the Koha connector using SVN: + +:: + + # cd /usr/local/lib/locum/connectors/ + # svn co http://dobby.darienlibrary.org/svn/connectors/koha/ locum_koha_30x + +`Harvest Records <#sopacharvest>`__ +----------------------------------- + +Now that the connector is in place, we will be able to launch +harvest.php, a tool that will reap Locum DB Koha and fill the locum. + +Start by configuring harvest.php: + +:: + + # nano /usr/local/lib/locum/tools/harvest.php + +Here are the variables you must change: + +:: + + $first_record = 1; + $last_record = 30; + +These are the minimum and maximum biblionumbers from your Koha install. + +Then start the harvest: + +:: + + # chmod +x /usr/local/lib/locum/tools/harvest.php + $ /usr/local/lib/locum/tools/harvest.php + +`Installation of Sphinx <#sopacphinx>`__ +---------------------------------------- + +Sphinx is the indexer for the database used by Locum and Insurge. + +`Dependencies <#sphinxdepend>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +There is no Debian package for Sphinx so you'll have to compile the +source directly: + +:: + + # apt-get install g++ make libmysql++-dev + +`Download and Compile <#sphinxdownload>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +:: + + $ wget http://sphinxsearch.com/downloads/sphinx-0.9.8.tar.gz + $ tar zxvf sphinx-0.9.8.tar.gz + $ cd sphinx-0.9.8 + $ ./configure --prefix=/usr/local/sphinx + $ make + # make install + # mkdir /usr/local/sphinx + # mkdir /usr/local/sphinx/lib + # cp api/sphinxapi.php /usr/local/sphinx/lib/ + $ rm -R sphinx-0.9.8* + +`Creation of User and Group <#sphinxuser>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Creating a Sphinx user and change the owner: + +:: + + # adduser sphinx + # addgroup sphinx + # usermod -G sphinx sphinx + # mkdir /usr/local/sphinx/var/run + # chown -R sphinx.sphinx /usr/local/sphinx/var + +`The Sphinx daemon <#demonsphinx>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Download: + +:: + + # cd /etc/init.d + # wget http://www.thesocialopac.net/sites/thesocialopac.net/files/sphinx + # chmod +x /etc/init.d/sphinx + +Add Sphinx to the default boot services: + +:: + + # update-rc.d sphinx defaults + +`Configuration <#sphinxconfig>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Copy the configuration file supplied with the source of Sphinx before +the change: + +:: + + # cp /usr/local/lib/locum/sphinx/sphinx.conf /usr/local/sphinx/etc/ + # sed 's/locum_db_user/scas_user/g' /usr/local/sphinx/etc/sphinx.conf > tmpfile; + mv tmpfile /usr/local/sphinx/etc/sphinx.conf + # sed 's/locum_db_pass/scas_pass/g' /usr/local/sphinx/etc/sphinx.conf > tmpfile; mv tmpfile /usr/local/sphinx/etc/sphinx.conf + +And if you personalize the name of the database: + +:: + + # sed 's/scas/MY_DB/g' /usr/local/sphinx/etc/sphinx.conf > tmpfile; mv tmpfile /usr/local/sphinx/etc/sphinx.conf + +`Indexing documents <#sphinxindexing>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Indexing is necessary if you want to use the search features of SOPAC. + +You must first complete the Insurge table index + +:: + + # chmod +x /usr/local/lib/insurge/tools/update-index.php + $ /usr/local/lib/insurge/tools/update-index.php + +Then start indexing Sphinx + +:: + + $ /usr/local/sphinx/bin/indexer --all + +Finally, we must start the daemon: + +:: + + # /etc/init.d/sphinx start + +When the daemon is running, you can update the index with: + +:: + + $ /usr/local/sphinx/bin/indexer --all --rotate + +`Installation of SOPAC2 <#installsopac>`__ +------------------------------------------ + +Now to the SOPAC software itself: + +`Download <#downloadsopac>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Download from SVN: + +:: + + $ cd /chemin/vers/drupal/sites/all/ + $ mkdir modules + $ cd modules/ + $ svn co http://dobby.darienlibrary.org/svn/sopac/trunk/ sopac + +`Installation <#sopacinstallation>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +In Drupal's administration settings, activate the module. Also, enable +the dependencies: + +- Profile + +- PHP Filter + +- Path + +The Drupal menu should now list these entries. + +`Configuration <#configsopac>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Then go into the settings of SOPAC. + +- Configure the paths to the Locum and Insurge libraries + +- Choose a URL prefix SOPAC, in my "catalog". Create a node with + content like: + +:: + + <?php + print sopac_search_form('both'); + print theme('pages_catalog'); + +- Check the Input Format "PHP Code" + +- Check Move to front page + +- In URL path settings, set the SOPAC URL prefix you have chosen. + +Go to the root of Drupal, a search form will appear. + +Remember to empty Drupal's cache when something does not work. + +Drupal offers a few blocks, which are not configured by default. You +must specify on which page they should appear. diff --git a/en/source/17_cron_jobs.rst b/en/source/17_cron_jobs.rst new file mode 100644 index 0000000..45475df --- /dev/null +++ b/en/source/17_cron_jobs.rst @@ -0,0 +1,1554 @@ +.. include:: images.rst + + +Cron Jobs +========= + +A cron job is a Linux command for scheduling a command or script on your +server to complete repetitive tasks automatically. Scripts executed as a +cron job are typically used to modify files or databases; however, they +can perform other tasks that do not modify data on the server, like +sending out email notifications. Koha has many cron jobs in place that +you can enable (search engine indexing, overdue notice generation, data +cleanup and more), this chapter will explain those for you. + +`Cron Jobs <#cronjobs>`__ +------------------------- + +The locations below assume a dev install which puts the crons in misc/, +if you have a standard install you may want to look in bin/ for these +files if you cannot find them in misc/ + +`Search <#searchcron>`__ +~~~~~~~~~~~~~~~~~~~~~~~~ + +`Rebuild Index <#rebuildsearchcron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/migration\_tools/rebuild\_zebra.pl + +Does: Updates Zebra indexes with recently changed data. + +Required by: Zebra + +Frequency suggestion: every x minutes, (between 5-15 minutes) depending +on performance needs + +`Circulation <#circcron>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +`Holds Queue <#buildholdscron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/holds/build\_holds\_queue.pl + +Does: Updates holds queue report + +Required by: `Holds Queue Report <#holdsqueue>`__ + +Frequency suggestion: every 1-4 hours + +Description: + +- A script that should be run periodically if your library system + allows borrowers to place on-shelf holds. This script decides which + library should be responsible for fulfilling a given hold request. + + It's behavior is controlled by the system preferences + `StaticHoldsQueueWeight <#holdqueueweight>`__ and + `RandomizeHoldsQueueWeight <#holdqueueweight>`__. + + If you do not want all of your libraries to participate in the + on-shelf holds fulfillment process, you should list the the libraries + that \*do\* participate in the process here by inputting all the + participating library's branchcodes, separated by commas ( e.g. + "MPL,CPL,SPL,BML" etc. ). + + By default, the holds queue will be generated such that the system + will first attempt to hold fulfillment using items already at the + pickup library if possible. If there are no items available at the + pickup library to fill a hold, build\_holds\_queue.pl will then use + the list of libraries defined in StaticHoldsQueueWeight. If + RandomizeHoldsQueueWeight is disabled ( which it is by default ), the + script will assign fulfillment requests in the order the branches are + placed in the StaticHoldsQueueWeight system preference. + + For example, if your system has three libraries, of varying sizes ( + small, medium and large ) and you want the burden of holds + fulfillment to be on larger libraries before smaller libraries, you + would want StaticHoldsQueueWeight to look something like + "LRG,MED,SML". + + If you want the burden of holds fulfillment to be spread out equally + throughout your library system, simply enable + RandomizeHoldsQueueWeight. When this system preference is enabled, + the order in which libraries will be requested to fulfill an on-shelf + hold will be randomized each time the list is regenerated. + + Leaving StaticHoldsQueueWeight empty is contraindicated at this time. + Doing so will cause the build\_holds\_queue script to ignore + RandomizeHoldsQueueWeight, causing the script to request hold + fulfillment not randomly, but by alphabetical order. + +`Perl Documentation <#buildholdscronperl>`__ +'''''''''''''''''''''''''''''''''''''''''''' + +**GetBibsWithPendingHoldRequests** + +my $biblionumber\_aref = GetBibsWithPendingHoldRequests(); + +Return an arrayref of the biblionumbers of all bibs that have one or +more unfilled hold requests. + +**GetPendingHoldRequestsForBib** + +my $requests = GetPendingHoldRequestsForBib($biblionumber); + +Returns an arrayref of hashrefs to pending, unfilled hold requests on + +the bib identified by $biblionumber. The following keys are present in +each hashref: + +- biblionumber + +- borrowernumber + +- itemnumber + +- priority + +- branchcode + +- reservedate + +- reservenotes + +- borrowerbranch + +The arrayref is sorted in order of increasing priority. + +**GetItemsAvailableToFillHoldRequestsForBib** + +my $available\_items = + +GetItemsAvailableToFillHoldRequestsForBib($biblionumber); + +Returns an arrayref of items available to fill hold requests for the bib +identified by $biblionumber. An item is available to fill a hold + +request if and only if: + +- it is not on loan + +- it is not withdrawn + +- it is not marked notforloan + +- it is not currently in transit + +- it is not lost + +- it is not sitting on the hold shelf + +**MapItemsToHoldRequests** + +MapItemsToHoldRequests($hold\_requests, $available\_items); + +**CreatePickListFromItemMap** + +**AddToHoldTargetMap** + +**\_get\_branches\_to\_pull\_from** + +Query system preferences to get ordered list of branches to use to fill +hold requests. + +`Expired Holds <#expiredholdscron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/holds/cancel\_expired\_holds.pl + +Does: By default, this cron job will only automatically cancel holds +where the user has set an expiration date. If the library is using the +`ExpireReservesMaxPickUpDelay <#ExpireReservesMaxPickUpDelay>`__ and +`ExpireReservesMaxPickUpDelayCharge <#ExpireReservesMaxPickUpDelayCharge>`__ +preferences then this script will also cancel holds that have been +sitting on the hold shelf for too long and will (if the library does) +charge the patron for not picking up the hold. + +Frequency suggestion: daily + +`Unsuspend Holds <#unsuspendholdcron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/holds/auto\_unsuspend\_holds.pl + +Does: This script checks to find holds that should no longer be +suspended and removes the suspension if the +`AutoResumeSuspendedHolds <#AutoResumeSuspendedHolds>`__ preference is +set to 'allow'. This puts the patron back in to the queue where they +were when the hold was suspended. + +Frequency suggestion: daily + +`Fines <#finescronjob>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/fines.pl + +Does: Calculates and posts fines to patron accounts. + +Required by: `finesMode <#finesMode>`__ system preference + +Frequency suggestion: nightly + +`Long Overdues <#longoverduecron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/longoverdue.pl + +Does: allows one to specify delays for changing items to different lost +statuses, and optionally charge for them using the replacement price +listed on the item record. + +Frequency suggestion: nightly + + **Note** + + Staff can control some of the parameters for the longoverdue cron + job with the + `DefaultLongOverdueLostValue <#DefaultLongOverdueLostValue>`__ and + `DefaultLongOverdueChargeValue <#DefaultLongOverdueChargeValue>`__ + preferences. + +`Perl Documentation <#longoverduecronperl>`__ +''''''''''''''''''''''''''''''''''''''''''''' + +**NAME** + +longoverdue.pl cron script to set lost statuses on overdue materials. +Execute without options for help. + +**DESCRIPTION** + +--lost \| -l + +This option takes the form of n=lv, where n is num days overdue, and lv +is the lost value. See warning below. + +--charge \| -c + +This specifies what lost value triggers Koha to charge the account for +the lost item. Replacement costs are not charged if this is not +specified. + +--verbose \| v + +verbose. + +--confirm + +confirm. without this option, the script will report the number of +affected items and return without modifying any records. + +--quiet + +suppress summary output. + +--maxdays + +Specifies the end of the range of overdue days to deal with (defaults to +366). This value is universal to all lost num days overdue passed. + +--mark-returned + +When an item is marked lost, remove it from the borrowers issued items. + +`Track total checkouts <#updateissuescron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/update\_totalissues.pl + +Does: updates the biblioitems.totalissues field in the database with the +latest tally of checkouts. + +Frequency suggestion: nightly + +`Perl Documentation <#updateissuesperldoc>`__ +''''''''''''''''''''''''''''''''''''''''''''' + +**NAME** + +update\_totalissues.pl + +**SYNOPSIS** + +update\_totalissues.pl --use-stats + +update\_totalissues.pl --use-items + +update\_totalissues.pl --commit=1000 + +update\_totalissues.pl --since='2012-01-01' + +update\_totalissues.pl --interval=30d + +**DESCRIPTION** + +This batch job populates bibliographic records' total issues count based +on historical issue statistics. + +--help Prints this help + +-v\|--verbose + +Provide verbose log information (list every bib modified). + +--use-stats + +Use the data in the statistics table for populating total issues. + +--use-items + +Use items.issues data for populating total issues. Note that issues data +from the items table does not respect the --since or --interval options, +by definition. Also note that if both --use-stats and --use-items are +specified, the count of biblios processed will be misleading. + +-s\|--since=DATE + +Only process issues recorded in the statistics table since DATE. + +-i\|--interval=S + +Only process issues recorded in the statistics table in the last N units +of time. The interval should consist of a number with a one- letter unit +suffix. The valid suffixes are h (hours), d (days), w (weeks), m +(months), and y (years). The default unit is days. + +--incremental + +Add the number of issues found in the statistics table to the existing +total issues count. Intended so that this script can be used as a cron +job to update popularity information during low-usage periods. If +neither --since or --interval are specified, incremental mode will +default to processing the last twenty-four hours. + +--commit=N + +Commit the results to the database after every N records are processed. + +--test + +Only test the popularity population script. + +**WARNING** + +If the time on your database server does not match the time on your Koha +server you will need to take that into account, and probably use the +--since argument instead of the --interval argument for incremental +updating. + +**CREDITS** + +This patch to Koha was sponsored by the Arcadia Public Library and the +Arcadia Public Library Foundation in honor of Jackie Faust-Moreno, late +director of the Arcadia Public Library. + +**AUTHOR** + +Jared Camins-Esakov <jcamins AT cpbibliography DOT com> + +`Generate Patron File for Offline Circulation <#offlinecirccron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/create\_koc\_db.pl + +Does: Generates the borrowers.db file for use with the `Koha Offline +Circulation <#windowsofflinecirc>`__ tool + +Frequency suggestion: weekly + +`Automatic renewal <#autorenewcron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/automatic\_renewals.pl + +Does: Will automatically renew items if you're allowing automatic +renewal with your `circulation and fine rules <#circfinerules>`__. + +Frequency suggestion: nightly + +`Perl Documentation <#autorenewcronperl>`__ +''''''''''''''''''''''''''''''''''''''''''' + +**NAME** + +automatic\_renewals.pl - cron script to renew loans + +**SYNOPSIS** + +./automatic\_renewals.pl + +or, in crontab: 0 3 \* \* \* automatic\_renewals.pl + +**DESCRIPTION** + +This script searches for issues scheduled for automatic renewal +(issues.auto\_renew). If there are still renews left (Renewals allowed) +and the renewal isn't premature (No Renewal before) the issue is +renewed. + +**OPTIONS** + +No options. + +`Patrons <#patroncrons>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +`Unverified Registrations <#deleteexpiredregistrationcron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/delete\_expired\_opac\_registrations.pl + +Does: Deletes patron registrations that were submitted via the OPAC but +not reviewed by the library within the number of days entered in the +`PatronSelfRegistrationExpireTemporaryAccountsDelay <#PatronSelfRegistrationExpireTemporaryAccountsDelay>`__ +preference. + +Frequency suggestion: nightly + +`Unconfirmed Registrations <#deleteunverifiedcron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/delete\_unverified\_opac\_registrations.pl + +Does: Deletes patron self registrations that were submitted via the OPAC +but not confirmed via email within 24 hours. This is only necessary if +you are requiring patrons to confirm their registrations via email with +the +`PatronSelfRegistrationVerifyByEmail <#PatronSelfRegistrationVerifyByEmail>`__ +preference. + +Frequency suggestion: hourly + +`Anonymize Patron Data <#anonymizecron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/batch\_anonymise.pl + +Does: Used to anonymize patron data. This will remove borrowernumbers +from circulation history so that the stats are kept, but the patron +information is removed for privacy reasons. + +`Update Child to Adult Patron Type <#j2acron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/j2a.pl + +Does: Convert juvenile/child patrons from juvenile patron category and +category code to corresponding adult patron category and category code +when they reach the upper age limit defined in the Patron Categories. + +Frequency suggestion: nightly + +`Perl Documentation <#j2aperldoc>`__ +'''''''''''''''''''''''''''''''''''' + +**NAME** + +juv2adult.pl - convert juvenile/child patrons from juvenile patron +category and category code to corresponding adult patron category and +category code when they reach the upper age limit defined in the Patron +Categories. + +**SYNOPSIS** + +juv2adult.pl [ -b=<branchcode> -f=<categorycode> -t=<categorycode> ] + +Options: + +--help brief help message + +--man full documentation + +-v verbose mode + +-n take no action, display only + +-b <branchname> only deal with patrons from this library/branch + +-f <categorycode> change patron category from this category + +-t <categorycode> change patron category to this category + +=head1 OPTIONS + +--help Print a brief help message and exits. + +--man Prints the manual page and exits. + +-v Verbose. Without this flag set, only fatal errors are reported. + +-n No Action. With this flag set, script will report changes but not +actually execute them on the database. + +-b changes patrons for one specific branch. Use the value in the +branches.branchcode table. + +-f \*required\* defines the juvenile category to update. Expects the +code from categories.categorycode. + +-t \*required\* defines the category juvenile patrons will be converted +to. Expects the code from categories.categorycode. + +**DESCRIPTION** + +This script is designed to update patrons from juvenile to adult patron +types, remove the guarantor, and update their category codes +appropriately when they reach the upper age limit defined in the Patron +Categories. + +**USAGE EXAMPLES** + +"juv2adult.pl" - Suggests that you read this help. :) + +"juv2adult.pl" -b=<branchcode> -f=<categorycode> -t=<categorycode> - +Processes a single branch, and updates the patron categories from +fromcat to tocat. + +"juv2adult.pl" -f=<categorycode> -t=<categorycode> -v -n - Processes all +branches, shows all messages, and reports the patrons who would be +affected. Takes no action on the database. + +`Notices <#noticescron>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +`Message Queue <#msgqueuecron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/process\_message\_queue.pl + +Does: processes the message queue to send the check out, check in and +hold filled emails and SMS message to users and sends outgoing emails to +patrons. requires +`EnhancedMessagingPreferences <#EnhancedMessagingPreferences>`__ to be +on + +Frequency suggestion: 1-4 hours + + **Important** + + Item due and Advanced due notices are controlled by the + `advance\_notices cron <#advnoticecron>`__. + +`Advanced Notice <#advnoticecron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/advance\_notices.pl + +Does: prepares "pre-due" notices and "item due" notices for patrons who +request them prepares notices for patrons for items just due or coming +due soon. requires +`EnhancedMessagingPreferences <#EnhancedMessagingPreferences>`__ to be +on + +Frequency suggestion: nightly + + **Note** + + This script does not actually send the notices. It queues them in + the `message queue <#msgqueuecron>`__ for later + +`Perl Documentation <#advnoticecronperl>`__ +''''''''''''''''''''''''''''''''''''''''''' + +**NAME** + +advance\_notices.pl - cron script to put item due reminders into message +queue + +**SYNOPSIS** + +./advance\_notices.pl -c + +or, in crontab: 0 1 \* \* \* advance\_notices.pl -c + +**DESCRIPTION** + +This script prepares pre-due and item due reminders to be sent to +patrons. It queues them in the message queue, which is processed by the +process\_message\_queue.pl cronjob. The type and timing of the messages +can be configured by the patrons in their "My Alerts" tab in the OPAC. + +**METHODS** + +parse\_letter + +`Overdue Notice <#overduenoticecron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/overdue\_notices.pl + +Does: prepares messages to alert patrons of overdue messages (both via +email and print) + +Frequency suggestion: nightly + + **Note** + + This script does not actually send the notices. It queues them in + the `message queue <#msgqueuecron>`__ for later or generates the + HTML for later printing + +`Perl Documentation <#overduenoticecronperl>`__ +''''''''''''''''''''''''''''''''''''''''''''''' + +**NAME** + +overdue\_notices.pl - prepare messages to be sent to patrons for overdue +items + +**SYNOPSIS** + +overdue\_notices.pl [ -n ] [ -library <branchcode> ] [ -library +<branchcode>...] [ -max <number of days> ] [ -csv [ <filename> ] ] +[-itemscontent <field list> ] + +Options: + +-help brief help message + +-man full documentation + +-n No email will be sent + +-max <days> maximum days overdue to deal with + +-library <branchname> only deal with overdues from this library +(repeatable : several libraries can be given) + +-csv <filename> populate CSV file + +-html <filename> Output html to file + +-itemscontent <list of fields> item information in templates + +-borcat <categorycode> category code that must be included + +-borcatout <categorycode> category code that must be excluded + +**OPTIONS** + +-help Print a brief help message and exits. + +-man Prints the manual page and exits. + +-v Verbose. Without this flag set, only fatal errors are reported. + +-n Do not send any email. Overdue notices that would have been sent to +the patrons or to the admin are printed to standard out. CSV data (if +the -csv flag is set) is written to standard out or to any csv filename +given. + +-max Items older than max days are assumed to be handled somewhere else, +probably the longoverdues.pl script. They are therefore ignored by this +program. No notices are sent for them, and they are not added to any CSV +files. Defaults to 90 to match longoverdues.pl. + +-library + +select overdues for one specific library. Use the value in the +branches.branchcode table. This option can be repeated in order to +select overdues for a group of libraries. + +-csv Produces CSV data. if -n (no mail) flag is set, then this CSV data +is sent to standard out or to a filename if provided. Otherwise, only +overdues that could not be emailed are sent in CSV format to the admin. + +-itemscontent + +comma separated list of fields that get substituted into templates in +places of the <<items.content>> placeholder. This defaults to +issuedate,title,barcode,author + +Other possible values come from fields in the biblios, items, and issues +tables. + +-borcat Repetable field, that permit to select only few of patrons +categories. + +-borcatout + +Repetable field, permis to exclude some patrons categories. + +-t \| --triggered + +This option causes a notice to be generated if and only if an item is +overdue by the number of days defined in a notice trigger. + +By default, a notice is sent each time the script runs, which is +suitable for less frequent run cron script, but requires syncing notice +triggers with the cron schedule to ensure proper behavior. Add the +--triggered option for daily cron, at the risk of no notice being +generated if the cron fails to run on time. + +-list-all + +Default items.content lists only those items that fall in the range of +the currently processing notice. Choose list-all to include all overdue +items in the list (limited by -max setting). + +**DESCRIPTION** + +This script is designed to alert patrons and administrators of overdue +items. + +Configuration + +This script pays attention to the overdue notice configuration performed +in the "Overdue notice/status triggers" section of the "Tools" area of +the staff interface to Koha. There, you can choose which letter +templates are sent out after a configurable number of days to patrons of +each library. More information about the use of this section of Koha is +available in the Koha manual. + +The templates used to craft the emails are defined in the "Tools: +Notices" section of the staff interface to Koha. + +Outgoing emails + +Typically, messages are prepared for each patron with overdue items. +Messages for whom there is no email address on file are collected and +sent as attachments in a single email to each library administrator, or +if that is not set, then to the email address in the +"KohaAdminEmailAddress" system preference. + +These emails are staged in the outgoing message queue, as are messages +produced by other features of Koha. This message queue must be processed +regularly by the misc/cronjobs/process\_message\_queue.pl program. + +In the event that the "-n" flag is passed to this program, no emails are +sent. Instead, messages are sent on standard output from this program. +They may be redirected to a file if desired. + +Templates + +Templates can contain variables enclosed in double angle brackets like +<<this>>. Those variables will be replaced with values specific to the +overdue items or relevant patron. Available variables are: + +<<bib>> + +the name of the library + +<<items.content>> + +one line for each item, each line containing a tab separated list of +title, author, barcode, issuedate + +<<borrowers.\*>> + +any field from the borrowers table + +<<branches.\*>> + +any field from the branches table + +CSV output + +The "-csv" command line option lets you specify a file to which overdues +data should be output in CSV format. + +With the "-n" flag set, data about all overdues is written to the file. +Without that flag, only information about overdues that were unable to +be sent directly to the patrons will be written. In other words, this +CSV file replaces the data that is typically sent to the administrator +email address. + +**USAGE EXAMPLES** + +"overdue\_notices.pl" - In this most basic usage, with no command line +arguments, all libraries are processed individually, and notices are +prepared for all patrons with overdue items for whom we have email +addresses. Messages for those patrons for whom we have no email address +are sent in a single attachment to the library administrator's email +address, or to the address in the KohaAdminEmailAddress system +preference. + +"overdue\_notices.pl -n -csv /tmp/overdues.csv" - sends no email and +populates /tmp/overdues.csv with information about all overdue items. + +"overdue\_notices.pl -library MAIN max 14" - prepare notices of overdues +in the last 2 weeks for the MAIN library. + +**SEE ALSO** + +The misc/cronjobs/advance\_notices.pl program allows you to send +messages to patrons in advance of their items becoming due, or to alert +them of items that have just become due. + +**INTERNAL METHODS** + +These methods are internal to the operation of overdue\_notices.pl. + +parse\_letter + +parses the letter template, replacing the placeholders with data +specific to this patron, biblio, or item + +named parameters: + +letter - required hashref + +borrowernumber - required integer + +substitute - optional hashref of other key/value pairs that should be +substituted in the letter content + +returns the "letter" hashref, with the content updated to reflect the +substituted keys and values. + +prepare\_letter\_for\_printing + +returns a string of text appropriate for printing in the event that an +overdue notice will not be sent to the patron's email address. Depending +on the desired output format, this may be a CSV string, or a +human-readable representation of the notice. + +required parameters: + +letter + +borrowernumber + +optional parameters: + +outputformat + +`Print Hold Notices <#printholdcron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/gather\_print\_notices.pl + +Does: looks through the message queue for hold notices that didn't go +through because the patron didn't have an email address and generates a +print notice + +Frequency suggestion: nightly + +`Talking Tech <#talkingtechcrons>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To learn more about setting up this third party product view the +`Talking Tech Appendix <#talkingtechappendix>`__. + +`Sending Notices File <#talkingtechsendcron>`__ +''''''''''''''''''''''''''''''''''''''''''''''' + +Script path: misc/cronjobs/thirdparty/TalkingTech\_itiva\_outbound.pl + +Does: Script to generate Spec C outbound notifications file for Talking +Tech i-tiva phone notification system. + +Required by: +`TalkingTechItivaPhoneNotification <#TalkingTechItivaPhoneNotification>`__ + +Frequency suggestion: nightly + +`Perl Documentation <#talkingsendcronperl>`__ + + +**USAGE** + +TalkingTech\_itiva\_outbound.pl + +TalkingTech\_itiva\_outbound.pl --type=OVERDUE -w 0 -w 2 -w 6 +--output=/tmp/talkingtech/outbound.csv + +TalkingTech\_itiva\_outbound.pl --type=RESERVE --type=PREOVERDUE +--lang=FR + +Script to generate Spec C outbound notifications file for Talking Tech +i-tiva phone notification system. + +--help -h + +Prints this help + +-v Provide verbose log information. + +--output -o + +Destination for outbound notifications file (CSV format). If no value is +specified, output is dumped to screen. + +--lang + +Sets the language for all outbound messages. Currently supported values +are EN, FR and ES. If no value is specified, EN will be used by default. + +--type + +REQUIRED. Sets which messaging types are to be used. Can be given +multiple times, to specify multiple types in a single output file. +Currently supported values are RESERVE, PREOVERDUE and OVERDUE. If no +value is given, this script will not produce any outbound notifications. + +--waiting-hold-day -w + +OPTIONAL for --type=RESERVE. Sets the days after a hold has been set to +waiting on which to call. Use switch as many times as desired. For +example, passing "-w 0 -w 2 -w 6" will cause calls to be placed on the +day the hold was set to waiting, 2 days after the waiting date, and 6 +days after. See example above. If this switch is not used with +--type=RESERVE, calls will be placed every day until the waiting reserve +is picked up or canceled. + +--library-code --code -c + +OPTIONAL The code of the source library of the message. The library code +is used to group notices together for consortium purposes and apply +library specific settings, such as prompts, to those notices. This field +can be blank if all messages are from a single library. + +`Receiving Notices File <#talkingtechreceivecron>`__ +'''''''''''''''''''''''''''''''''''''''''''''''''''' + +Script path: misc/cronjobs/thirdparty/TalkingTech\_itiva\_inbound.pl + +Does: Script to process received Results files for Talking Tech i-tiva +phone notification system. + +Required by: +`TalkingTechItivaPhoneNotification <#TalkingTechItivaPhoneNotification>`__ + +Frequency suggestion: nightly + +`Perl Documentation <#talkingreceivecronperl>`__ + + +**USAGE** + +TalkingTech\_itiva\_inbound.pl + +TalkingTech\_itiva\_inbound.pl -v --input=/tmp/talkingtech/results.csv + +Script to process received Results files for Talking Tech i-tiva phone +notification system. + +--help -h + +Prints this help + +-v Provide verbose log information. + +--input -i + +REQUIRED. Path to incoming results file. + +`Notify Patrons of Expiration <#patronexpirycron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/membership\_expiry.pl + +Does: Sends messages to warn patrons of their card expiration to the +`messaage queue <#msgqueuecron>`__ cron. + +Requires: `MembershipExpiryDaysNotice <#MembershipExpiryDaysNotice>`__ + +Frequency: nightly + +`In Processing/Book Cart <#proccartcron>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Script path: misc/cronjobs/cart\_to\_shelf.pl + +Does: Updates all items with a location of CART to the item's permanent +location. + +Required by: `NewItemsDefaultLocation <#NewItemsDefaultLocation>`__, +`InProcessingToShelvingCart <#InProcessingToShelvingCart>`__, & +`ReturnToShelvingCart <#ReturnToShelvingCart>`__ system preferences + +Frequency suggestion: hourly + +`Perl Documentation <#proccartcronperl>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**NAME** + +cart\_to\_shelf.pl cron script to set items with location of CART to +original shelving location after X hours. Execute without options for +help. + +`Catalog <#catalogcron>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +`Check URLs <#checkurlcron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/check-url.pl + +Does: checks URLs in 856$u field. Script output can now be formatted in +CSV or HTML. The HTML version links directly to MARC biblio record +editor. + +Frequency suggestion: monthly + +Learn more: http://wiki.koha-community.org/wiki/Check-url_enhancements + +`Perl Documentation <#checkurlcronperl>`__ +'''''''''''''''''''''''''''''''''''''''''' + +**NAME** + +C4::URL::Checker - base object for checking URL stored in Koha DB + +**SYNOPSIS** + +:: + + use C4::URL::Checker; + + my $checker = C4::URL::Checker->new( ); + $checker->{ host_default } = 'http://mylib.kohalibrary.com'; + my $checked_urls = $checker->check_biblio( 123 ); + foreach my $url ( @$checked_urls ) { + print "url: ", $url->{ url A }, "\n", + "is_success: ", $url->{ is_success }, "\n", + "status: ", $url->{ status }, "\n"; + } + +**FUNCTIONS** + +new + +Create a URL Checker. The returned object can be used to set default +host variable : + +:: + + my $checker = C4::URL::Checker->new( ); + $checker->{ host_default } = 'http://mylib.kohalibrary.com'; + +check\_biblio + +Check all URL from a biblio record. Returns a pointer to an array +containing all URLs with checking for each of them. + +:: + + my $checked_urls = $checker->check_biblio( 123 ); + +With 2 URLs, the returned array will look like that: + +:: + + [ + { + 'url' => 'http://mylib.tamil.fr/img/62265_0055B.JPG', + 'is_success' => 1, + 'status' => 'ok' + }, + { + 'url' => 'http://mylib.tamil.fr//img/62265_0055C.JPG', + 'is_success' => 0, + 'status' => '404 - Page not found' + } + ], + +**NAME** + +check-url.pl - Check URLs from 856$u field. + +**USAGE** + +check-url.pl [--verbose\|--help] [--host=http://default.tld] + +Scan all URLs found in 856$u of bib records and display if resources are +available or not. + +**PARAMETERS** + +--host=http://default.tld + +Server host used when URL doesn't have one, ie doesn't begin with +'http:'. For example, if --host=http://www.mylib.com, then when 856$u +contains 'img/image.jpg', the url checked is: +http://www.mylib.com/image.jpg'. + +--verbose\|-v + +Outputs both successful and failed URLs. + +--html + +Formats output in HTML. The result can be redirected to a file +accessible by http. This way, it's possible to link directly to biblio +record in edit mode. With this parameter --host-pro is required. + +--host-pro=http://koha-pro.tld + +Server host used to link to biblio record editing page. + +--help\|-h + +Print this help page. + +`Update Authorities <#mergeauthcron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/migration\_tools/merge\_authority.pl + +Does: Updates biblio data with changes to authorities records + + **Note** + + The name of this script is misleading. This script does not merge + authorities together it instead merges authority data with linked + bib records. Edits to authority records will be applied to + bibliographic records that use that authority when this script is + run. + +Required by: `dontmerge <#dontmerge>`__ system preference + +Frequency suggestion: nightly + +`Serials Update <#serialscron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/serialsUpdate.pl + +Does: checks if there is a "late" issue on active subscriptions, and if +there is, the script will set it as late, and add the next one as +expected. + +Frequency suggestion: nightly + +`Automatic item update <#autoitemupdatecron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/automatic\_item\_modification\_by\_age.pl + +Does: updates items based on the list of rules set forth in the +`Automatic item modifications by age <#autoitemagemod>`__ tool + +Required by: `Automatic item modifications by age <#autoitemagemod>`__ + +Frequency suggestions: nightly + +`Perl Documentation <#autoitemupdatecrondoc>`__ +''''''''''''''''''''''''''''''''''''''''''''''' + +**NAME** + +automatic\_item\_modification\_by\_age.pl + +**SYNOPSIS** + +./automatic\_item\_modification\_by\_age.pl -h + +Toggle recent acquisitions status. Use this script to delete "new" +status for items. + +**OPTIONS** + +-h\|--help Prints this help message. + +-v\|--verbose Set the verbose flag. + +-c\|--confirm The script will modify the items. + +**AUTHOR** + +Jonathan Druart <jonathan.druart@biblibre.com> + +**COPYRIGHT** + +Copyright 2013 BibLibre + +**LICENSE** + +This file is part of Koha. + +Koha is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free +Software Foundation; either version 3 of the License, or (at your +option) any later version. + +Koha is distributed in the hope that it will be useful, but WITHOUT ANY +WARRANTY; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for +more details. + +You should have received a copy of the GNU General Public License along +with Koha; if not, see <http://www.gnu.org/licenses>. + +`OPAC <#opaccrons>`__ +~~~~~~~~~~~~~~~~~~~~~ + +`RSS Feeds <#customrssfeedcron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/rss/rss.pl + +Does: Produces an RSS XML document for any SQL query (not used for +search results RSS feed). `Learn more <#customrss>`__. + +Frequency suggestion: hourly + +`Authorities Browser <#authbrowsercron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/build\_browser\_and\_cloud.pl + +Does: Generate content for authorities browse in OPAC + +Required by: `OpacBrowser <#OpacBrowser>`__ system preference + + **Important** + + This preference and cron job should only be used on French systems. + +`Subject/Author Clouds <#keywordclouds>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/cloud-kw.pl + +Does: Generates HTML keywords clouds from Koha Zebra indexes. +misc/cronjobs/cloud-sample.conf has a sample of how this script +operates. + +Frequency: This is the type of script you can run once a month or so, +the content generated isn't going to change very much over time. + +`Perl Documentation <#keywordcloudsperl>`__ +''''''''''''''''''''''''''''''''''''''''''' + +**NAME** + +cloud-kw.pl - Creates HTML keywords clouds from Koha Zebra Indexes + +**USAGE** + +cloud-kw.pl [--verbose\|--help] --conf=cloud.conf + +Creates multiple HTML files containing keywords cloud with top terms +sorted by their logarithmic weight. cloud.conf is a YAML configuration +file driving cloud generation process. + +**PARAMETERS** + +--conf=configuration file + +Specify configuration file name + +--verbose\|-v + +Enable script verbose mode. + +--help\|-h + +Print this help page. + +**CONFIGURATION** + +Configuration file looks like that: + +:: + + --- + # Koha configuration file for a specific installation + # If not present, defaults to KOHA_CONF + KohaConf: /home/koha/mylibray/etc/koha-conf.xml + # Zebra index to scan + ZebraIndex: Author + # Koha index used to link found kewords with an opac search URL + KohaIndex: au + # Number of top keyword to use for the cloud + Count: 50 + # Include CSS style directives with the cloud + # This could be used as a model and then CSS directives are + # put in the appropriate CSS file directly. + Withcss: Yes + # HTML file where to output the cloud + Output: /home/koha/mylibrary/koharoot/koha-tmpl/cloud-author.html + --- + KohaConf: /home/koha/yourlibray/etc/koha-conf.xml + ZebraIndex: Subject + KohaIndex: su + Count: 200 + Withcss: no + Output: /home/koha/yourlibrary/koharoot/koha-tmpl/cloud-subject.html + +**IMPROVEMENTS** + +Generated top terms have more informations than those outputted from the +time being. Some parameters could be easily added to improve this +script: + +WithCount + +In order to output terms with the number of occurrences they have been +found in Koha Catalogue by Zebra. + +CloudLevels + +Number of levels in the cloud. Now 24 levels are hardcoded. + +Weighting + +Weighting method used to distribute terms in the cloud. We could have +two values: Logarithmic and Linear. Now it's Logarithmic by default. + +Order + +Now terms are outputted in the lexical order. They could be sorted by +their weight. + +`System Administration <#systemcron>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +`Clean up Database <#cleandbcron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/cleanup\_database.pl + +Does: Truncates the sessions table, cleans out old zebraqueue entries, +action logs and staged MARC files. + +Perl Documentation +'''''''''''''''''' + +**USAGE** + +kohaclone/misc/cronjobs/cleanup\_database.pl [-h\|--help] [--sessions] +[--sessdays DAYS] [-v\|--verbose] [--zebraqueue DAYS] [-m\|--mail] +[--merged] [--import DAYS] [--logs DAYS] [--searchhistory DAYS] + +**PARAMETERS** + +-h --help + +prints this help message, and exits, ignoring all other options + +--sessions + +purge the sessions table. If you use this while users are logged into +Koha, they will have to reconnect. + +--sessdays DAYS + +purge only sessions older than DAYS days + +-v --verbose + +will cause the script to give you a bit more information about the run. + +--zebraqueue DAYS + +purge completed zebraqueue entries older than DAYS days. Defaults to 30 +days if no days specified. + +-m --mail DAYS + +purge items from the mail queue that are older than DAYS days. Defaults +to 30 days if no days specified. + +--merged + +purged completed entries from need\_merge\_authorities. + +--import DAYS + +purge records from import tables older than DAYS days. Defaults to 60 +days if no days specified + +--z3950 + +purge records from import tables that are the result of Z39.50 searches + +--logs DAYS + +purge entries from action\_logs older than DAYS days. Defaults to 180 +days if no days specified + +--searchhistory DAYS + +purge entries from search\_history older than DAYS days. Defaults to 30 +days if no days specified + +--list-invites DAYS + +purge (unaccepted) list share invites older than DAYS days. Defaults to +14 days if no days specified. + +--restrictions DAYS + +purge patrons restrictions expired since more than DAYS days. Defaults +to 30 days if no days specified. + +`Share Usage Stats <#usagecron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/share\_usage\_with\_koha\_community.pl + +Does: If you're sharing information via the `UsageStats <#UsageStats>`__ +feature this will send your info to the `Hea +website <http://hea.koha-community.org/>`__. + +Frequency: monthly + +`Perl Documentation <#usagecronperl>`__ +''''''''''''''''''''''''''''''''''''''' + +**NAME** + +share\_usage\_with\_koha\_community.pl - Share your library's usage with +the Koha community + +**SYNOPSIS** + +share\_usage\_with\_koha\_community.pl [-h\|--help] [-v\|--verbose] + +If the `UsageStats <#UsageStats>`__ system preference is set, you can +launch this script to share your usage data anonymously with the Koha +community. + +Collecting Koha usage statistics will help developers to know how Koha +is used across the world. + +This script will send the usage data for the bibliographic and authority +records, checkouts, holds, orders, and subscriptions. + +Only the total number is retrieved. In no case will private data be +shared! + +In order to know which parts of Koha modules are used, this script will +collect some system preference values. + +If you want to tell us who you are, you can fill the +`UsageStatsLibraryName <#UsageStatsLibraryName>`__ system preference +with your library name, +`UsageStatsLibraryUrl <#UsageStatsLibraryUrl>`__, +`UsageStatsLibraryType <#UsageStatsLibraryType>`__ and/or +`UsageStatsCountry <#UsageStatsCountry>`__. + +All these data will be analyzed on the http://hea.koha-community.org +Koha community website. + +IMPORTANT : please do NOT run the cron on the 1st, but on another day. +The idea is to avoid all Koha libraries sending their data at the same +time ! So choose any day between 1 and 28 ! + +**OPTIONS** + +-h\|--help + +Print a brief help message + +-v\|--verbose + +Verbose mode. + +-f\|--force + +Force the update. + +**AUTHOR** + +Alex Arnaud <alex.arnaud@biblibre.com> + +Jonathan Druart <jonathan.druart@biblibre.com> + +**COPYRIGHT** + +Copyright 2014 BibLibre + +**LICENSE** + +This file is part of Koha. + +Koha is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free +Software Foundation; either version 3 of the License, or (at your +option) any later version. + +You should have received a copy of the GNU General Public License along +with Koha; if not, write to the Free Software Foundation, Inc., 51 +Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + +`Acquisitions <#acqcrons>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +`Clean up old suggestions <#cleansuggcron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/purge\_suggestions.pl + +Does: Removes old (defined by you) suggestions from the suggestion +management area. + +`Email suggestions to process <#emailsuggestfund>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/notice\_unprocessed\_suggestions.pl + +Does: Generates a notice to the fund owner that there are suggestions in +need of processing + +`Perl Documentation <#emailsuggestfundperl>`__ +'''''''''''''''''''''''''''''''''''''''''''''' + +**NAME** + +notice\_unprocessed\_suggestions.pl - Generate notification for +unprocessed suggestions. + +The budget owner will be notified. + +The letter template 'TO\_PROCESS' will be used. + +**SYNOPSIS** + +notice\_unprocessed\_suggestions.pl [-h\|--help] [-v\|--verbose] +[-c\|--confirm] [--days=NUMBER\_OF\_DAYS] + +**OPTIONS** + +-h\|--help Print a brief help message + +-c\|--confirm This flag must be provided in order for the script to +actually generate notices. If it is not supplied, the script will only +report on the patron it would have noticed. + +--days This parameter is mandatory. It must contain an integer +representing the number of days elapsed since the last modification of +suggestions to process. + +-v\|--verbose Verbose mode. + +`EDI Message Processing <#edicron>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Script path: misc/cronjobs/edi\_cron.pl + +Does: Sends and received EDI messages + +Frequency: Every 15 minutes + +`Deprecated scripts <#deprecatedcrons>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +These should not be run without modification: + +Script path: misc/cronjobs/update\_items.pl + +Script path:misc/cronjobs/smsoverdues.pl + +Script path:misc/cronjobs/notifyMailsOp.pl + +Script path:misc/cronjobs/reservefix.pl + +Script path:misc/cronjobs/zebraqueue\_start.pl diff --git a/en/source/18_miscellaneous.rst b/en/source/18_miscellaneous.rst new file mode 100644 index 0000000..52b51be --- /dev/null +++ b/en/source/18_miscellaneous.rst @@ -0,0 +1,4530 @@ +.. include:: images.rst + +Web Services +============ + +`OAI-PMH <#OAI-PMHservice>`__ +----------------------------- + +For the Open Archives Initiative-Protocol for Metadata Harvesting +(OAI-PMH) there are two groups of 'participants': Data Providers and +Service Providers. Data Providers (open archives, repositories) provide +free access to metadata, and may, but do not necessarily, offer free +access to full texts or other resources. OAI-PMH provides an easy to +implement, low barrier solution for Data Providers. Service Providers +use the OAI interfaces of the Data Providers to harvest and store +metadata. Note that this means that there are no live search requests to +the Data Providers; rather, services are based on the harvested data via +OAI-PMH. + +Koha at present can only act as a Data Provider. It can not harvest from +other repositories. The biggest stumbling block to having Koha harvest +from other repositories is that MARC is the only metadata format that +Koha indexes natively. Visit +http://www.oaforum.org/tutorial/english/page3.htm for diagrams of how +OAI-PMH works. + +Learn more about OAI-PMH at: http://www.openarchives.org/pmh/ + +To enable OAI-PMH in Koha edit the `OAI-PMH <#OAI-PMH>`__ preference. +Once enabled you can visit http://YOURKOHACATALOG/cgi-bin/koha/oai.pl to +see your file. + +`Sample OAI Conf File <#oaiconfsample>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +:: + + format: + vs: + metadataPrefix: vs + metadataNamespace: http://veryspecial.tamil.fr/vs/format-pivot/1.1/vs + schema: http://veryspecial.tamil.fr/vs/format-pivot/1.1/vs.xsd + xsl_file: /usr/local/koha/xslt/vs.xsl + marcxml: + metadataPrefix: marxml + metadataNamespace: http://www.loc.gov/MARC21/slim + http://www.loc.gov/standards/marcxml/schema/MARC21slim + schema: http://www.loc.gov/MARC21/slim + http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd + oai_dc: + metadataPrefix: oai_dc + metadataNamespace: http://www.openarchives.org/OAI/2.0/oai_dc/ + schema: http://www.openarchives.org/OAI/2.0/oai_dc.xsd + xsl_file: + /usr/local/koha/koha-tmpl/intranet-tmpl/xslt/UNIMARCslim2OAIDC.xsl + +`REST services <#Rest-services>`__ +---------------------------------- + +Koha can now be requested by REST http requests. BibLibre wrotes an +external module to adds more possibilities than ILS-DI can provide.There +is no authentication process, but authorized ips are listed in the +config file. Services have been tested in 3.10, 3.12 and 3.14 koha +versions. You can find more information about it into README file and +opac/rest.pl documentation on http://git.biblibre.com. If you want to +add features, send us a patch at dev\_patches AT biblibre DOT com. + +Services provided in 1.4 version are: + +:: + + GET branches + GET user/byid/:borrowernumber/holds + GET user/:user_name/holds + GET user/byid/:borrowernumber/issues + GET user/:user_name/issues + GET user/:user_name/issues_history + GET user/byid/:borrowernumber/issues_history + GET user/today + GET user/all + POST user + PUT user/:user_name + GET biblio/:biblionumber/items + GET biblio/:biblionumber/holdable + GET biblio/:biblionumber/items_holdable_status + GET item/:itemnumber/holdable + PUT auth/change_password + GET /suggestions + GET /suggestions/:suggestionid + POST /suggestions + PUT /suggestions/:suggestionid + DELETE /suggestions/:suggestionid + + +Using the SRU server +==================== + +`Using the SRU server <#usingsru>`__ +------------------------------------ + +Koha implements the Search/Retrieve via URL (SRU) protocol. More +information about the protocol itself can be found at +http://www.loc.gov/standards/sru/. The version implemented is version +1.1. + +`Explain <#sru_explain>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If you want to have information about the implementation of SRU on a +given server, you should have access to the Explain file using a request +to the server without any parameter. Like +<http://myserver.com:9999/biblios/>. The response from the server is an +XML file that should look like the following and will give you +information about the default settings of the SRU server. + +:: + + <zs:explainResponse> + <zs:version>1.1</zs:version> + <zs:record> + <zs:recordSchema>http://explain.z3950.org/dtd/2.0/</zs:recordSchema> + <zs:recordPacking>xml</zs:recordPacking> + <zs:recordData> + <explain xml:base="zebradb/explain-biblios.xml"> + <!-- + try stylesheet url: http://./?stylesheet=docpath/sru2.xsl + --> + <serverInfo protocol="SRW/SRU/Z39.50"> + <host>biblibre</host> + <port>9999</port> + <database>biblios</database> + </serverInfo> + <databaseInfo> + <title lang="en" primary="true">Koha 3 Bibliographic SRU/SRW/Z39.50 server + Koha 3 Bibliographic Server + + http://biblibre:9999 + + + + + CQL Standard Set + + + CQL Server Choice + + serverChoice + + + text + + + + CQL All + + all + + + text + + + + + Record ID + + id + + + rec:id + 3 + + + + +`Search <#sru_search>`__ +~~~~~~~~~~~~~~~~~~~~~~~~ + +This url : +http://myserver.com:9999/biblios?version=1.1&operation=searchRetrieve&query=reefs +is composed of the following elements: + +- base url of the SRU server : http://myserver.com:9999/biblios? + +- search part with the 3 required parameters : version, operation and + query. The parameters within the search part should be of the + key=value form, and can be combined with the & character. + +One can add optional parameters to the query, for instance +maximumRecords indicating the maximum number of records to be returned +by the server. So +http://myserver.com:9999/biblios?version=1.1&operation=searchRetrieve&query=reefs&maximumRecords=5 +will only get the first 5 results results from the server. + +http://www.loc.gov/standards/sru/sru1-1archive/search-retrieve-operation.html +gives more details about the search operations and in particular the +list of optional parameters for searching. + +`More details about Search <#sru_search_more_details>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The "operation" key can take two values: scan or searchRetrieve. + +If operation=searchRetrieve, then the search key should be query. As in +: operation=searchRetrieve&query=reefs + +If operation=scan, then the search key should be scanClause. As in : +operation=scan&scanClause=reefs + +etc/zebradb/biblios/etc/bib1.att defines Zebra/3950 indexes that exist +on your system. For instance you'll see that we have indexes for Subject +and for Title: att 21 Subject and att 4 Title respectively. + +In the pqf.properties file located under etc/zebradb/pqf.properties I +see that an access point already uses my Subject index (index.dc.subject += 1=21) while another uses my Title index (index.dc.title = 1=4) I know +this is my Subject index because as I've seen just before in my bib1.att +file, it's called with =1=21 in Z3950: so index.dc.subject = 1=21 +correctly points to my Subject index. And Title was called with 1=4 so +index.dc.title = 1=4 correctly points to my Title index. I can now +construct my query just like I would in a search box, just preceding it +with the "query" key: query=Subject=reefs and Title=coral searches +"reefs" in the subject and "coral" in the title. The full url would be +http://myserver.com:9999/biblios?version=1.1&operation=searchRetrieve&query=Subject=reefs +and Title=coral If I want to limit the result set to just 5 records, I +can do +http://myserver.com:9999/biblios?version=1.1&operation=searchRetrieve&query=Subject=reefs +and Title=coral&maximumRecords=5 + +I can also play with truncate, relations, etc. Those are also defined in +my pqf.properties file. I can see for instance the position properties +defined as: + +:: + + position.first = 3=1 6=1 + # "first in field" + position.any = 3=3 6=1 + # "any position in field" + + +So as an example if I want "coral" to be at the beginning of the title, +I can do this query : +http://myserver.com:9999/biblios?version=1.1&operation=searchRetrieve&query=Title=coral +first + +`Retrieve <#sru_retrieve>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +My search for +http://univ\_lyon3.biblibre.com:9999/biblios?version=1.1&operation=searchRetrieve&query=coral +reefs&maximumRecords=1 retrieves just on record. The response looks like +this: + +:: + + + 1.1 + 1 + + + xml + + + cam a22 4500 + + 2-603-01193-6 + rel. + 159 F + + + FR + 00065351 + + + ita + + + a z 00|y| + + + r + + + 20091130 frey50 + + + Guide des récifs coralliens / A Guide to Coral Reefs + Texte imprimé + la faune sous-marine des coraux + A. et A. Ferrari + + + Lausanne + Paris + Delachaux et Niestlé + cop. 2000 + impr. en Espagne + + + 287 p. + ill. en coul., couv. ill. en coul. + 20 cm + + ...... + + 4725 + 2 + /tmp/nw10BJv9Pk/upd_biblio/exported_records + + + + 1 + + + + + + +New titles slider for OPAC +========================== + +Often times libraries will want to add a flowing widget with new +materials at the library to their main public catalog page. To do this +you can use a widget from any number of services (usually for a cost) or +you can `enable plugins <#pluginsystem>`__ in Koha and use the `Cover +Flow +plugin `__ +which is based on the +`Flipster `__, a responsive +jQuery coverflow plugin. + +Once the plugin is installed, the steps to get your coverflow to show up +are as follows: + +First, you need to create one or more public reports for your coverflow +widget or widgets to be based on. This is how the plugin knows what the +content of your widget should contain. Each report needs only three +columns; title, biblionumber, and isbn. It is important that you have a +good and valid isbn, as that is the datum used to actually fetch the +cover. In the iteration of the plugin, we are using Amazon cover images, +but I believe in the end I will make the cover image fetcher +configurable so we can use any data source for cover image fetching. + +Second, we need to configure the plugin. The plugin configuration is a +single text area that uses YAML ( actually, it’s JSON, whcih is a subset +of YAML ) to store the configuration options. In this example it looks +like this: + +:: + + - id: 42 + selector: #coverflow + options: + style: coverflow + +In this example, we are telling the plugin to use the report with id 42, +and use it to create a coverflow widget to replace the HTML element with +the id “coverflow”. The options list is passed directly to Flipster, so +any options supported by Flipster can be set from the plugin +configuration! In fact, in addition to the traditional coverflow, +Flipster has a “carousel” mode which is a much more compact version of +the coverflow. You can also configure which cover the widget will start +on, among other options. + +At the time the plugins options are saved or updated, the plugin will +then generate some minified JavaScript code that is automatically stored +in the Koha system preference OPACUserJS. Here is an example of the +output: + +:: + + /* JS for Koha CoverFlow Plugin + This JS was added automatically by installing the CoverFlow plugin + Please do not modify */$(document).ready(function(){$.getScript("/plugin/Koha/Plugin/Com/ByWaterSolutions/CoverFlow/jquery-flipster/src/js/jquery.flipster.min.js",function(data,textStatus,jqxhr){$("head").append("");$('#coverflow').load("/coverflow.pl?id=42",function(){var opt={'items':'.item','minfactor':15,'distribution':1.5,'scalethreshold':0,'staticbelowthreshold':false,'titleclass':'itemTitle','selectedclass':'selectedItem','scrollactive':true,'step':{'limit':4,'width':10,'scale':true}};$('#coverflow').flipster({style:'coverflow',});});});}); + /* End of JS for Koha CoverFlow Plugin */ + +Why do this? For speed! Rather than regenerating this code each and +every time the page loads, we can generate it once, and use it over and +over again. + +If you inspect the code closely, you’ll notice it references a script +“coverflow.pl”. This is a script that is included with the coverflow +plugin. Since we need to access this from the OPAC ( and we don’t want +to set off any XSS attack alarms ), we need to modify the web server +configuration for the public catalog and add the followup to it: + +:: + + ScriptAlias /coverflow.pl "/var/lib/koha/mykoha/plugins/Koha/Plugin/Com/ByWaterSolutions/CoverFlow/coverflow.pl" + +This line gives us access to the coverflow.pl script from the OPAC. This +script retrieves the report data and passes it back to the public +catalog for creating the coverflow widget. Koha::Cache is supported in +order to make the widget load as quickly as possible! + +The final step is to put your selector element somewhere in your public +catalog. In this example, I put the following in the system preference +OpacMainUserBlock: + +:: + + Loading... + +Once that is in place, you need only refresh your OPAC page, and there +you have it, your very own catalog coverflow widget! Not only do these +coverflows look great on a computer screen, but they look great on +mobile platforms as well, and are even touch responsive!Coverflow Widget + +System Preference Defaults +========================== + +`ISBD Defaults <#isbddefaults>`__ +--------------------------------- + +Default values for the `ISBD <#isbdpref>`__ preference. + +`MARC Default <#isbddefault>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +#100\|\|{ 100a }{ 100b }{ 100c }{ 100d }{ 110a }{ 110b }{ 110c }{ 110d +}{ 110e }{ 110f }{ 110g }{ 130a }{ 130d }{ 130f }{ 130g }{ 130h }{ 130k +}{ 130l }{ 130m }{ 130n }{ 130o }{ 130p }{ 130r }{ 130s }{ 130t +}\|

+ +#245\|\|{ 245a }{ 245b }{245f }{ 245g }{ 245k }{ 245n }{ 245p }{ 245s }{ +245h }\| + +#246\|\|{ : 246i }{ 246a }{ 246b }{ 246f }{ 246g }{ 246n }{ 246p }{ 246h +}\| + +#242\|\|{ = 242a }{ 242b }{ 242n }{ 242p }{ 242h }\| + +#245\|\|{ 245c }\| + +#242\|\|{ = 242c }\| + +#250\| - \|{ 250a }{ 250b }\| + +#254\|, \|{ 254a }\| + +#255\|, \|{ 255a }{ 255b }{ 255c }{ 255d }{ 255e }{ 255f }{ 255g }\| + +#256\|, \|{ 256a }\| + +#257\|, \|{ 257a }\| + +#258\|, \|{ 258a }{ 258b }\| + +#260\| - \|{ 260a }{ 260b }{ 260c }\| + +#300\| - \|{ 300a }{ 300b }{ 300c }{ 300d }{ 300e }{ 300f }{ 300g }\| + +#306\| - \|{ 306a }\| + +#307\| - \|{ 307a }{ 307b }\| + +#310\| - \|{ 310a }{ 310b }\| + +#321\| - \|{ 321a }{ 321b }\| + +#340\| - \|{ 3403 }{ 340a }{ 340b }{ 340c }{ 340d }{ 340e }{ 340f }{ +340h }{ 340i }\| + +#342\| - \|{ 342a }{ 342b }{ 342c }{ 342d }{ 342e }{ 342f }{ 342g }{ +342h }{ 342i }{ 342j }{ 342k }{ 342l }{ 342m }{ 342n }{ 342o }{ 342p }{ +342q }{ 342r }{ 342s }{ 342t }{ 342u }{ 342v }{ 342w }\| + +#343\| - \|{ 343a }{ 343b }{ 343c }{ 343d }{ 343e }{ 343f }{ 343g }{ +343h }{ 343i }\| + +#351\| - \|{ 3513 }{ 351a }{ 351b }{ 351c }\| + +#352\| - \|{ 352a }{ 352b }{ 352c }{ 352d }{ 352e }{ 352f }{ 352g }{ +352i }{ 352q }\| + +#362\| - \|{ 362a }{ 351z }\| + +#440\| - \|{ 440a }{ 440n }{ 440p }{ 440v }{ 440x }\|. + +#490\| - \|{ 490a }{ 490v }{ 490x }\|. + +#800\| - \|{ 800a }{ 800b }{ 800c }{ 800d }{ 800e }{ 800f }{ 800g }{ +800h }{ 800j }{ 800k }{ 800l }{ 800m }{ 800n }{ 800o }{ 800p }{ 800q }{ +800r }{ 800s }{ 800t }{ 800u }{ 800v }\|. + +#810\| - \|{ 810a }{ 810b }{ 810c }{ 810d }{ 810e }{ 810f }{ 810g }{ +810h }{ 810k }{ 810l }{ 810m }{ 810n }{ 810o }{ 810p }{ 810r }{ 810s }{ +810t }{ 810u }{ 810v }\|. + +#811\| - \|{ 811a }{ 811c }{ 811d }{ 811e }{ 811f }{ 811g }{ 811h }{ +811k }{ 811l }{ 811n }{ 811p }{ 811q }{ 811s }{ 811t }{ 811u }{ 811v +}\|. + +#830\| - \|{ 830a }{ 830d }{ 830f }{ 830g }{ 830h }{ 830k }{ 830l }{ +830m }{ 830n }{ 830o }{ 830p }{ 830r }{ 830s }{ 830t }{ 830v }\|. + +#500\|

\|{ 5003 }{ 500a }\| + +#501\|

\|{ 501a }\| + +#502\|

\|{ 502a }\| + +#504\|

\|{ 504a }\| + +#505\|

\|{ 505a }{ 505t }{ 505r }{ 505g }{ 505u }\| + +#506\|

\|{ 5063 }{ 506a }{ 506b }{ 506c }{ 506d }{ 506u }\| + +#507\|

\|{ 507a }{ 507b }\| + +#508\|

\|{ 508a }{ 508a }\| + +#510\|

\|{ 5103 }{ 510a }{ 510x }{ 510c }{ 510b }\| + +#511\|

\|{ 511a }\| + +#513\|

\|{ 513a }{513b }\| + +#514\|

\|{ 514z }{ 514a }{ 514b }{ 514c }{ 514d }{ 514e }{ 514f +}{ 514g }{ 514h }{ 514i }{ 514j }{ 514k }{ 514m }{ 514u }\| + +#515\|

\|{ 515a }\| + +#516\|

\|{ 516a }\| + +#518\|

\|{ 5183 }{ 518a }\| + +#520\|

\|{ 5203 }{ 520a }{ 520b }{ 520u }\| + +#521\|

\|{ 5213 }{ 521a }{ 521b }\| + +#522\|

\|{ 522a }\| + +#524\|

\|{ 524a }\| + +#525\|

\|{ 525a }\| + +#526\|

\|{\\n510i }{\\n510a }{ 510b }{ 510c }{ 510d }{\\n510x +}\| + +#530\|

\|{\\n5063 }{\\n506a }{ 506b }{ 506c }{ 506d }{\\n506u +}\| + +#533\|

\|{\\n5333 }{\\n533a }{\\n533b }{\\n533c }{\\n533d +}{\\n533e }{\\n533f }{\\n533m }{\\n533n }\| + +#534\|

\|{\\n533p }{\\n533a }{\\n533b }{\\n533c }{\\n533d +}{\\n533e }{\\n533f }{\\n533m }{\\n533n }{\\n533t }{\\n533x }{\\n533z +}\| + +#535\|

\|{\\n5353 }{\\n535a }{\\n535b }{\\n535c }{\\n535d }\| + +#538\|

\|{\\n5383 }{\\n538a }{\\n538i }{\\n538u }\| + +#540\|

\|{\\n5403 }{\\n540a }{ 540b }{ 540c }{ 540d }{\\n520u +}\| + +#544\|

\|{\\n5443 }{\\n544a }{\\n544b }{\\n544c }{\\n544d +}{\\n544e }{\\n544n }\| + +#545\|

\|{\\n545a }{ 545b }{\\n545u }\| + +#546\|

\|{\\n5463 }{\\n546a }{ 546b }\| + +#547\|

\|{\\n547a }\| + +#550\|

\|{ 550a }\| + +#552\|

\|{ 552z }{ 552a }{ 552b }{ 552c }{ 552d }{ 552e }{ 552f +}{ 552g }{ 552h }{ 552i }{ 552j }{ 552k }{ 552l }{ 552m }{ 552n }{ 562o +}{ 552p }{ 552u }\| + +#555\|

\|{ 5553 }{ 555a }{ 555b }{ 555c }{ 555d }{ 555u }\| + +#556\|

\|{ 556a }{ 506z }\| + +#563\|

\|{ 5633 }{ 563a }{ 563u }\| + +#565\|

\|{ 5653 }{ 565a }{ 565b }{ 565c }{ 565d }{ 565e }\| + +#567\|

\|{ 567a }\| + +#580\|

\|{ 580a }\| + +#581\|

\|{ 5633 }{ 581a }{ 581z }\| + +#584\|

\|{ 5843 }{ 584a }{ 584b }\| + +#585\|

\|{ 5853 }{ 585a }\| + +#586\|

\|{ 5863 }{ 586a }\| + +#020\|

\|{ 020a }{ 020c }\| + +#022\|

\|{ 022a }\| + +#222\| = \|{ 222a }{ 222b }\| + +#210\| = \|{ 210a }{ 210b }\| + +#024\|

\|{ 024a }{ 024c }{ 024d }{ +0242 }\| + +#027\|

\|{ 027a }\| + +#028\|

\|{ 028a }{ 028b }\| + +#013\|

\|{ 013a }{ 013b }{ 013c }{ +013d }{ 013e }{ 013f }\| + +#030\|

\|{ 030a }\| + +#037\|

\|{ 037a }{ 037b }{ 037c }{ 037f +}{ 037g }{ 037n }\| + +#010\|

\|{ 010a }\| + +#015\|

\|{ 015a }{ 0152 }\| + +#016\|

\|{ 016a }{ +0162 }\| + +#600\|

\|{\\n6003 +}{\\n600a}{ 600b }{ 600c }{ 600d }{ 600e }{ 600f }{ 600g }{ 600h +}{--600k}{ 600l }{ 600m }{ 600n }{ 600o }{--600p}{ 600r }{ 600s }{ 600t +}{ 600u }{--600x}{--600z}{--600y}{--600v}\| + +#610\|

\|{\\n6103 +}{\\n610a}{ 610b }{ 610c }{ 610d }{ 610e }{ 610f }{ 610g }{ 610h +}{--610k}{ 610l }{ 610m }{ 610n }{ 610o }{--610p}{ 610r }{ 610s }{ 610t +}{ 610u }{--610x}{--610z}{--610y}{--610v}\| + +#611\|

\|{\\n6113 +}{\\n611a}{ 611b }{ 611c }{ 611d }{ 611e }{ 611f }{ 611g }{ 611h +}{--611k}{ 611l }{ 611m }{ 611n }{ 611o }{--611p}{ 611r }{ 611s }{ 611t +}{ 611u }{--611x}{--611z}{--611y}{--611v}\| + +#630\|

\|{\\n630a}{ +630b }{ 630c }{ 630d }{ 630e }{ 630f }{ 630g }{ 630h }{--630k }{ 630l }{ +630m }{ 630n }{ 630o }{--630p}{ 630r }{ 630s }{ 630t +}{--630x}{--630z}{--630y}{--630v}\| + +#648\|

\|{\\n6483 +}{\\n648a }{--648x}{--648z}{--648y}{--648v}\| + +#650\|

\|{\\n6503 +}{\\n650a}{ 650b }{ 650c }{ 650d }{ 650e +}{--650x}{--650z}{--650y}{--650v}\| + +#651\|

\|{\\n6513 +}{\\n651a}{ 651b }{ 651c }{ 651d }{ 651e +}{--651x}{--651z}{--651y}{--651v}\| + +#653\|

\|{ 653a }\| + +#654\|

\|{\\n6543 +}{\\n654a}{--654b}{--654x}{--654z}{--654y}{--654v}\| + +#655\|

\|{\\n6553 +}{\\n655a}{--655b}{--655x }{--655z}{--655y}{--655v}\| + +#656\|

\|{\\n6563 +}{\\n656a}{--656k}{--656x}{--656z}{--656y}{--656v}\| + +#657\|

\|{\\n6573 +}{\\n657a}{--657x}{--657z}{--657y}{--657v}\| + +#658\|

\|{\\n658a}{--658b}{--658c}{--658d}{--658v}\| + +#050\|

\|{ 050a }{ / 050b }\| + +#082\|

\|{ 082a }{ / 082b }\| + +#080\|

\|{ 080a }{ +080x }{ / 080b }\| + +#070\|

\|{ 070a }{ / 070b }\| + +#060\|

\|{ 060a }{ / 060b }\| + +#074\|

\|{ 074a }\| + +#086\|

\|{ 086a }\| + +#088\|

\|{ 088a }\| + +`UNIMARC Default <#unimarcdefault>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +#200\|

Title : \|{200a}{. 200c}{ : 200e}{200d}{. 200h}{. 200i}\|

+ +#461\|\|{461t}{N∞ +461h} {v. 461v}{(461d)}
\| + +#200b\|\| {200b +}\|
+ +#101a\|\|{101a}\|
+ +#200f\|\|{200f +; }\|
+ +#200g\|\|{200g +; }\|
+ +#210a\|
\|{210a}\|
+ +#210c\|\|{210c +; }\|
+ +#210d\|\|{ +210d}\|
+ +#215\|\|{215a}{ : 215c}{ ; +215d}{ + 215e}\|
+ +#225a\|\|{225a +;} \| + +#225\|\|{ = 225d}{ : 225e}{. 225h}{. 225i}{ / 225f}{, 225x}{ ; +225v}\|
+ +#686\|\|{ 686a }\|
+ +#608\|\|{ 608a}\|

+ +#200\|\|
\|\| + +#856\|\|click here to go to the external resource
+ +#010\|\|{010a ;}\|
+ +#011\|\|{011a ;}\|
+ +#200\|\|\|
    + +#300\|\|
  • {300a}
    • \| + +#307\|\|
  • {307a}
    • \| + +#310\|\|
  • {310a}
    • \| + +#326\|\|
  • {326a}
    • \| + +#327\|\|
  • {327a}
    • \| + +#333\|
  • Public : \|{333a}
    • \| + +#200\|\|
\| + +#330\|\|\|
+ +#330\|\|{330a}\|
+ +#200\|\|

Items

\| + +#200\|\|\| + +#995\|\|\|
Call numberCopy +noteFondsGenre detailCirculation +typeBarcode
{995k} {995u} +{995y}{995e}   +{995o}{995f}
+ +`OPACISBD Defaults <#opacisbddefaults>`__ +----------------------------------------- + +Default values for the `OPACISBD <#OPACISBD>`__ preference. + +`MARC <#opacisbdmarcdefault>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +#100\|\|{ 100a }{ 100b }{ 100c }{ 100d }{ 110a }{ 110b }{ 110c }{ 110d +}{ 110e }{ 110f }{ 110g }{ 130a }{ 130d }{ 130f }{ 130g }{ 130h }{ 130k +}{ 130l }{ 130m }{ 130n }{ 130o }{ 130p }{ 130r }{ 130s }{ 130t +}\|

+ +#245\|\|{ 245a }{ 245b }{245f }{ 245g }{ 245k }{ 245n }{ 245p }{ 245s }{ +245h }\| + +#246\|\|{ : 246i }{ 246a }{ 246b }{ 246f }{ 246g }{ 246n }{ 246p }{ 246h +}\| + +#242\|\|{ = 242a }{ 242b }{ 242n }{ 242p }{ 242h }\| + +#245\|\|{ 245c }\| + +#242\|\|{ = 242c }\| + +#250\| - \|{ 250a }{ 250b }\| + +#254\|, \|{ 254a }\| #255\|, \|{ 255a }{ 255b }{ 255c }{ 255d }{ 255e }{ +255f }{ 255g }\| #256\|, \|{ 256a }\| + +#257\|, \|{ 257a }\| + +#258\|, \|{ 258a }{ 258b }\| + +#260\| - \|{ 260a }{ 260b }{ 260c }\| + +#300\| - \|{ 300a }{ 300b }{ 300c }{ 300d }{ 300e }{ 300f }{ 300g }\| + +#306\| - \|{ 306a }\| #307\| - \|{ 307a }{ 307b }\| + +#310\| - \|{ 310a }{ 310b }\| + +#321\| - \|{ 321a }{ 321b }\| + +#340\| - \|{ 3403 }{ 340a }{ 340b }{ 340c }{ 340d }{ 340e }{ 340f }{ +340h }{ 340i }\| + +#342\| - \|{ 342a }{ 342b }{ 342c }{ 342d }{ 342e }{ 342f }{ 342g }{ +342h }{ 342i }{ 342j }{ 342k }{ 342l }{ 342m }{ 342n }{ 342o }{ 342p }{ +342q }{ 342r }{ 342s }{ 342t }{ 342u }{ 342v }{ 342w }\| + +#343\| - \|{ 343a }{ 343b }{ 343c }{ 343d }{ 343e }{ 343f }{ 343g }{ +343h }{ 343i }\| + +#351\| - \|{ 3513 }{ 351a }{ 351b }{ 351c }\| + +#352\| - \|{ 352a }{ 352b }{ 352c }{ 352d }{ 352e }{ 352f }{ 352g }{ +352i }{ 352q }\| + +#362\| - \|{ 362a }{ 351z }\| + +#440\| - \|{ 440a }{ 440n }{ 440p }{ 440v }{ 440x }\|. #490\| - \|{ 490a +}{ 490v }{ 490x }\|. + +#800\| - \|{ 800a }{ 800b }{ 800c }{ 800d }{ 800e }{ 800f }{ 800g }{ +800h }{ 800j }{ 800k }{ 800l }{ 800m }{ 800n }{ 800o }{ 800p }{ 800q }{ +800r }{ 800s }{ 800t }{ 800u }{ 800v }\|. + +#810\| - \|{ 810a }{ 810b }{ 810c }{ 810d }{ 810e }{ 810f }{ 810g }{ +810h }{ 810k }{ 810l }{ 810m }{ 810n }{ 810o }{ 810p }{ 810r }{ 810s }{ +810t }{ 810u }{ 810v }\|. + +#811\| - \|{ 811a }{ 811c }{ 811d }{ 811e }{ 811f }{ 811g }{ 811h }{ +811k }{ 811l }{ 811n }{ 811p }{ 811q }{ 811s }{ 811t }{ 811u }{ 811v +}\|. + +#830\| - \|{ 830a }{ 830d }{ 830f }{ 830g }{ 830h }{ 830k }{ 830l }{ +830m }{ 830n }{ 830o }{ 830p }{ 830r }{ 830s }{ 830t }{ 830v }\|. + +#500\|

\|{ 5003 }{ 500a }\| + +#501\|

\|{ 501a }\| + +#502\|

\|{ 502a }\| + +#504\|

\|{ 504a }\| + +#505\|

\|{ 505a }{ 505t }{ 505r }{ 505g }{ 505u }\| + +#506\|

\|{ 5063 }{ 506a }{ 506b }{ 506c }{ 506d }{ 506u }\| + +#507\|

\|{ 507a }{ 507b }\| #508\|

\|{ 508a }{ 508a +}\| + +#510\|

\|{ 5103 }{ 510a }{ 510x }{ 510c }{ 510b }\| + +#511\|

\|{ 511a }\| + +#513\|

\|{ 513a }{513b }\| + +#514\|

\|{ 514z }{ 514a }{ 514b }{ 514c }{ 514d }{ 514e }{ 514f +}{ 514g }{ 514h }{ 514i }{ 514j }{ 514k }{ 514m }{ 514u }\| + +#515\|

\|{ 515a }\| + +#516\|

\|{ 516a }\| + +#518\|

\|{ 5183 }{ 518a }\| + +#520\|

\|{ 5203 }{ 520a }{ 520b }{ 520u }\| + +#521\|

\|{ 5213 }{ 521a }{ 521b }\| + +#522\|

\|{ 522a }\| + +#524\|

\|{ 524a }\| + +#525\|

\|{ 525a }\| + +#526\|

\|{\\n510i }{\\n510a }{ 510b }{ 510c }{ 510d }{\\n510x +}\| + +#530\|

\|{\\n5063 }{\\n506a }{ 506b }{ 506c }{ 506d }{\\n506u +}\| + +#533\|

\|{\\n5333 }{\\n533a }{\\n533b }{\\n533c }{\\n533d +}{\\n533e }{\\n533f }{\\n533m }{\\n533n }\| + +#534\|

\|{\\n533p }{\\n533a }{\\n533b }{\\n533c }{\\n533d +}{\\n533e }{\\n533f }{\\n533m }{\\n533n }{\\n533t }{\\n533x }{\\n533z +}\| + +#535\|

\|{\\n5353 }{\\n535a }{\\n535b }{\\n535c }{\\n535d }\| + +#538\|

\|{\\n5383 }{\\n538a }{\\n538i }{\\n538u }\| + +#540\|

\|{\\n5403 }{\\n540a }{ 540b }{ 540c }{ 540d }{\\n520u +}\| + +#544\|

\|{\\n5443 }{\\n544a }{\\n544b }{\\n544c }{\\n544d +}{\\n544e }{\\n544n }\| + +#545\|

\|{\\n545a }{ 545b }{\\n545u }\| +#546\|

\|{\\n5463 }{\\n546a }{ 546b }\| + +#547\|

\|{\\n547a }\| #550\|

\|{ 550a }\| + +#552\|

\|{ 552z }{ 552a }{ 552b }{ 552c }{ 552d }{ 552e }{ 552f +}{ 552g }{ 552h }{ 552i }{ 552j }{ 552k }{ 552l }{ 552m }{ 552n }{ 562o +}{ 552p }{ 552u }\| + +#555\|

\|{ 5553 }{ 555a }{ 555b }{ 555c }{ 555d }{ 555u }\| + +#556\|

\|{ 556a }{ 506z }\| #563\|

\|{ 5633 }{ 563a }{ +563u }\| + +#565\|

\|{ 5653 }{ 565a }{ 565b }{ 565c }{ 565d }{ 565e }\| + +#567\|

\|{ 567a }\| + +#580\|

\|{ 580a }\| + +#581\|

\|{ 5633 }{ 581a }{ 581z }\| + +#584\|

\|{ 5843 }{ 584a }{ 584b }\| + +#585\|

\|{ 5853 }{ 585a }\| + +#586\|

\|{ 5863 }{ 586a }\| + +#020\|

\|{ 020a }{ 020c }\| + +#022\|

\|{ 022a }\| + +#222\| = \|{ 222a }{ 222b }\| + +#210\| = \|{ 210a }{ 210b }\| + +#024\|

\|{ 024a }{ 024c }{ 024d }{ +0242 }\| + +#027\|

\|{ 027a }\| + +#028\|

\|{ 028a }{ 028b }\| + +#013\|

\|{ 013a }{ 013b }{ 013c }{ +013d }{ 013e }{ 013f }\| + +#030\|

\|{ 030a }\| + +#037\|

\|{ 037a }{ 037b }{ 037c }{ 037f +}{ 037g }{ 037n }\| + +#010\|

\|{ 010a }\| + +#015\|

\|{ 015a }{ 0152 }\| + +#016\|

\|{ 016a }{ +0162 }\| + +#600\|

\|{\\n6003 +}{\\n600a}{ 600b }{ 600c }{ 600d }{ 600e }{ 600f }{ 600g }{ 600h +}{--600k}{ 600l }{ 600m }{ 600n }{ 600o }{--600p}{ 600r }{ 600s }{ 600t +}{ 600u }{--600x}{--600z}{--600y}{--600v}\| + +#610\|

\|{\\n6103 +}{\\n610a}{ 610b }{ 610c }{ 610d }{ 610e }{ 610f }{ 610g }{ 610h +}{--610k}{ 610l }{ 610m }{ 610n }{ 610o }{--610p}{ 610r }{ 610s }{ 610t +}{ 610u }{--610x}{--610z}{--610y}{--610v}\| + +#611\|

\|{\\n6113 +}{\\n611a}{ 611b }{ 611c }{ 611d }{ 611e }{ 611f }{ 611g }{ 611h +}{--611k}{ 611l }{ 611m }{ 611n }{ 611o }{--611p}{ 611r }{ 611s }{ 611t +}{ 611u }{--611x}{--611z}{--611y}{--611v}\| + +#630\|

\|{\\n630a}{ +630b }{ 630c }{ 630d }{ 630e }{ 630f }{ 630g }{ 630h }{--630k }{ 630l }{ +630m }{ 630n }{ 630o }{--630p}{ 630r }{ 630s }{ 630t +}{--630x}{--630z}{--630y}{--630v}\| + +#648\|

\|{\\n6483 +}{\\n648a }{--648x}{--648z}{--648y}{--648v}\| +#650\|

\|{\\n6503 +}{\\n650a}{ 650b }{ 650c }{ 650d }{ 650e +}{--650x}{--650z}{--650y}{--650v}\| + +#651\|

\|{\\n6513 +}{\\n651a}{ 651b }{ 651c }{ 651d }{ 651e +}{--651x}{--651z}{--651y}{--651v}\| + +#653\|

\|{ 653a }\| + +#654\|

\|{\\n6543 +}{\\n654a}{--654b}{--654x}{--654z}{--654y}{--654v}\| + +#655\|

\|{\\n6553 +}{\\n655a}{--655b}{--655x }{--655z}{--655y}{--655v}\| + +#656\|

\|{\\n6563 +}{\\n656a}{--656k}{--656x}{--656z}{--656y}{--656v}\| + +#657\|

\|{\\n6573 +}{\\n657a}{--657x}{--657z}{--657y}{--657v}\| + +#658\|

\|{\\n658a}{--658b}{--658c}{--658d}{--658v}\| + +#050\|

\|{ 050a }{ / 050b }\| + +#082\|

\|{ 082a }{ / 082b }\| + +#080\|

\|{ 080a }{ +080x }{ / 080b }\| + +#070\|

\|{ 070a }{ / 070b }\| + +#060\|

\|{ 060a }{ / 060b }\| + +#074\|

\|{ 074a }\| + +#086\|

\|{ 086a }\| + +#088\|

\|{ 088a }\| + +Configuring Receipt Printers +============================ + +The following instructions are for specific receipt printers, but can +probably be used to help with setup of other brands as well. + +`For Epson TM-T88III (3) & TM-T88IV (4) Printers <#epsonprinters>`__ +-------------------------------------------------------------------- + +`In the Print Driver <#epsonprintdriver>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +For these instructions, we are using version 5,0,3,0 of the Epson +TM-T88III print driver; the EPSON TM-T88IV version is ReceiptE4. +Register at the `EpsonExpert Technical Resource Center +website `__ to gain access to the +drivers; go to Technical Resources, then choose the printer model from +the Printers drop-down list. + +Click Start > Printers and Faxes > Right click the receipt printer > +Properties: + +- Advanced Tab, click Printing Defaults button + +- Layout Tab: Paper size: Roll Paper 80 x 297mm + +- TM-T88III: Layout Tab: Check Reduce Printing and Fit to Printable + Width + +- TM-T88IV: Check Reduced Size Print; Click OK on the popup window that + appears. Fit to Printable Width should be automatically selected. + +- OK your way out of there. + +`In Firefox <#epsonfirefox>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Under File > Page Setup: + +- Shrink to fit page on Format & Options tab + +- 0,0,0,0 for Margins on Margins & Header/Footer Tab. This makes the + receipts use all available space on the paper roll. + +- Set all Headers/Footers to -blank-. This removes all of the gunk you + might normally find on a print from Firefox, such as the URL, number + of pages, etc. + +- Click OK + +Set the default printer settings in Firefox so you don't see a "Print" +dialog: + +- Go to File > Print + +- Set the Printer to the receipt printer. + +- Click the Advanced (or Properties) button + +- Layout Tab: Paper size: Roll Paper 80 x 297mm + +- TM-T88III: Layout Tab: Check Reduce Printing and Fit to Printable + Width + +- TM-T88IV: Check Reduced Size Print; click OK on the popup window that + appears. Fit to Printable Width should be automatically selected. + +- OK your way out, go ahead and print whatever page you are on. + +- Type about:config, in the address bar. Click "I'll be careful, I + promise!" on the warning message. + +- Type, print.always in Filter. + +- Look for print.always\_print\_silent. + + - If the preference is there then set the value to true. + +- If the preference is not there (and it shouldn't be in most browsers) + you have to add the preference. + + - Right click the preference area and select New > Boolean + + - Type print.always\_print\_silent in the dialog box and set the + value to True. This sets the print settings in Firefox to always + use the same settings and print without showing a dialog box. + + **Warning** + + Setting the print.always\_print\_silent setting in about:config + DISABLES the ability to choose a printer in Firefox. + +`For Epson TM-T88II (2) Printers <#epson2>`__ +--------------------------------------------- + +Register at the `EpsonExpert Technical Resource Center +website `__ to gain access to the +drivers; go to Technical Resources, then choose the printer model from +the Printers drop-down list. + +`In Firefox <#epson2firefox>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Under File > Page Setup: + +- Shrink to fit page on Format & Options tab + +- 0,0,0,0 for Margins on Margins & Header/Footer Tab. This makes the + receipts use all available space on the paper roll. + +- Set all Headers/Footers to -blank-. This removes all of the gunk you + might normally find on a print from Firefox, such as the URL, number + of pages, etc. + +- Click OK + +Set the default printer settings in Firefox so you don't see a "Print" +dialog: + +- Go to File > Print + +- Set the Printer to the receipt printer. + +- Print whatever page you are on. + +- Type about:config, in the address bar. Click "I'll be careful, I + promise!" on the warning message. + +- Type, print.always in Filter. + +- Look for, print.always\_print\_silent. + + - If the preference is there then set the value to true. + +- If the preference is not there (and it shouldn't be in most browsers) + you have to add the preference. + + - Right click the preference area and select New > Boolean + + - Type, print.always\_print\_silent in the dialog box and set the + value to True. This sets the print settings in Firefox to always + use the same settings and print without showing a dialog box. + + **Warning** + + Setting the print.always\_print\_silent setting in about:config + DISABLES the ability to choose a printer in Firefox. + +`For Star SP542 Printers <#starprinter>`__ +------------------------------------------ + +`Installing the Printer <#installstarprinter>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +While the following comments are based on the Star SP542 receipt +printer, they probably apply to all printers in the SP5xx series. + +The Star SP542 receipt printer works well with Koha and **Firefox on +Windows XP SP3**. This printer, with either the parallel or USB +interface, is fairly easy to install and configure. You will need the +following executable file which is available from numerous places on the +Internet: + +linemode\_2k-xp\_20030205.exe + +This executable actually does all of the installation; you will not need +to use the Microsoft Windows "Add Printer" program. We recommend that +when installing, the option for the software monitor not be selected; we +have experienced significant pauses and delays in printing with it. +Instead, simply choose to install the receipt printer without the +monitor. + +Additionally, the install program may not put the printer on the correct +port, especially if using the USB interface. This is easily corrected by +going to "Start -> Printers and Faxes -> Properties for the SP542 +printer -> Ports", then check the appropriate port. + +A reboot may be required, even if not indicated by the installation +software or the operating system. + +**Windows 7** users should refer to this page: +http://www.starmicronics.com/supports/win7.aspx. + +`Configuring Firefox to Print to Receipt Printer <#firefoxreceipt>`__ +--------------------------------------------------------------------- + +- Open File > Page Setup + +- Make all the headers and footers blank + +- Set the margins to 0 (zero) + +- In the address bar of Firefox, type about:config + +- Search for print.always\_print\_silent and double click it + +- Change it from false to true + + - This lets you skip the Print pop up box that comes up, as well as + skipping the step where you have to click OK, automatically + printing the right sized slip. + +- If print.always\_print\_silent does not come up + + - Right click on a blank area of the preference window + + - Select new > Boolean + + - Enter "print.always\_print\_silent" as the name (without quotes) + + - Click OK + + - Select true for the value + +- You may also want to check what is listed for print.print\_printer + + - You may have to choose Generic/Text Only (or whatever your receipt + printer might be named) + +Notice & Slips Guides +===================== + +`Field Guide for Notices & Slips <#noticesfieldguide>`__ +-------------------------------------------------------- + +This guide will break down the notices and slips information in 3 ways. +First it will tell you what file generates the notice, then how you will +present the item info in that notice and finally if the notice can be +branch specific or not. + ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| Letter Code | Used In | Detail tag | Can be branch specific | ++=====================+============================+=======================================+==========================+ +| DUE | advance\_notices.pl | <> | No | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| DUEDGST | advance\_notices.pl | <> | No | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| PREDUE | advance\_notices.pl | <> | No | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| PREDUEDGST | advance\_notices.pl | <> | No | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| ODUE\* | overdue\_notices.pl | <> or | Yes | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| CHECKOUT | C4/Circulation.pm | N/A | Yes | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| RENEWAL | C4/Circulation.pm | N/A | Yes | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| TRANSFERSLIP | C4/Circulation.pm | N/A | Yes | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| ISSUESLIP | C4/Members.pm | | Yes | +| | | | | +| | | | | +| | | | | +| | | | | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| ISSUEQSLIP | C4/Members.pm | | Yes | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| HOLDPLACED | C4/Reserves.pm | N/A | Yes | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| RESERVESLIP | C4/Reserves.pm | N/A | Yes | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| ASKED | C4/Suggestions.pm | N/A | Yes | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| CHECKED | C4/Suggestions.pm | N/A | Yes | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| ACCEPTED | C4/Suggestions.pm | N/A | Yes | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| REJECTED | C4/Suggestions.pm | N/A | Yes | ++---------------------+----------------------------+---------------------------------------+--------------------------+ +| OPAC\_REG\_VERIFY | opac/opac-memberentry.pl | N/A | No | ++---------------------+----------------------------+---------------------------------------+--------------------------+ + +Example Notice +============== + +Nicole Engard + +410 Library Rd. + +Philadelphia, PA 19107 + +Dear Nicole Engard (23529000035726), + +According to our records, at the time of this notice, you have items +that are overdue. Please return or renew them as soon as possible to +avoid increasing late fines. + +If you have registered a password with the library, you may use it with +your library card number to renew online. + +If you believe you have returned the items below please call at and +library staff will be happy to help resolve the issue. + +The following item(s) are currently overdue: + +07/08/2008 Creating drug-free schools and communities : 502326000054 +Fox, C. Lynn. + +06/27/2008 Eating fractions / 502326000022 McMillan, Bruce. + +Sincerely, Library Staff + +Sample Serials +============== + +`Reader's Digest (0034-0375) <#readersdigestsample>`__ +------------------------------------------------------ + +- Published 12 times a year (monthly) + +- The Volume number changes every 6 months and the numbers continues on + (requires an advanced pattern). + + Sample Reader's Digest Subscription + |image1069| + +`People Weekly (1076-0091) <#peoplesample>`__ +--------------------------------------------- + +- Published weekly + + - The website says "on Saturday except the first week of August, + Thanksgiving week, the first and last weeks of the year" but this + does not match the pattern for 2007 or 2008 + +- In the Jul-Dec there are 26 issues + +- In the Jan-Jun there are 25 issues (no issue for the first week of + January) + +Since the irregularity on the first # 26 does not skip a week, this +would be set up as to roll over on issue 25. The 26th issue in the +second half of the year would have to be received as a supplemental. + +The irregularity check will complain that 52 issues were expected, but +25 entered. The current irregularity check can only check that the first +position of the numbering pattern matches the expected issue count of +the periodicity. But we do need to trigger the rollover on the volume, +so we need to define the last two weeks of the year as irregularities. +So we receive 50 issues the first 50 weeks, then one supplemental issue +in week 51, which we have to define the enumeration for, then the next +predicted issue will be the following year's first week. + +`Et-Mol <#hebrewserialsample>`__ +-------------------------------- + +This journal is published with the following rules: + +- 6 issues a year (every 2 months) + +- year changes every 6 issues + +- we start in 2011 + +- the issue number goes up indefinitely + +- starting from issue 215 + +The planning would look like this: + +Sample for this Hebrew Journal +|image1070| + +`Backpacker (0277-867X) <#backpackerserial>`__ +---------------------------------------------- + +Published 9 times a year irregularly. The issues continues while the +volume and number rolls over every 9 issues. If you're holding Volume +41, Number 3, Issue 302 in your hand the prediction would look like +this: + +Backpacker numbering pattern +|image1071| + +And the received issues would number like this: + +v. 41, no. 3, iss. 302   + +v. 41, no. 4, iss. 303 + +v. 41, no. 5, iss. 304 + +v. 41, no. 6, iss. 305 + +v. 41, no. 7, iss. 306 + +v. 41, no. 8, iss. 307 + +v. 41, no. 9, iss. 308 + +v. 42, no. 1, iss. 309 + +v. 42, no. 2, iss. 310 + +v. 42, no. 3, iss. 311 + +v. 42, no. 4, iss. 312 + +`Keats-Shelley Journal (0453-4387) <#keatsserial>`__ +---------------------------------------------------- + +This journal is published once per year in July.  The numbering follows +this pattern:   + +- Vol. 61 2013 + +- Vol. 62 2014 + +- Vol. 63 2015 + +Setup should look like this (if you're starting in July 2014): + +Serial planning +|image1072| + +`Computers in Libraries (1041-7915) <#cilserial>`__ +--------------------------------------------------- + +Computers in Libraries is published ten times per year (monthly with +January/February and July/August combined issues). + +Subscription details +|image1073| + +Serial Planning +|image1074| + +Received details +|image1075| + +Sample List & Cart Emails +========================= + +`Example Email from List <#examplelistemail>`__ +----------------------------------------------- + +Below is an example of an email from a list in Koha. + +:: + + Hi, + + Here is your list called If You Like Jodi Picoult, sent from our online catalog. + + Please note that the attached file is a MARC bibliographic records file + which can be imported into a Personal Bibliographic Software like EndNote, + Reference Manager or ProCite. + --------------------------------------------- + + Home safe : a novel / + + by Berg, Elizabeth. + + Published by: Random House,, 260 p. ;, 25 cm. + Copyright year: 2009 + LCCN: 2008049247 + In the online catalog: + http://MYCATALOG/cgi-bin/koha/opac-detail.pl?biblionumber=12113 + Items : + North Branch FIC (FIC Ber) TVSN500088894O + Main Library FIC (FIC Boh) TVSN5000921548 + South Branch FIC (FIC Boh) TVSN500092156A + West Branch FIC (FIC Boh) TVSN5000921559 + + --------------------------------------------- + + Half a heart / + + by Brown, Rosellen. + + Published by: Farrar, Straus, and Giroux,, 402 p. ;, 24 cm. + Copyright year: 2000 + LCCN: 00022926 + In the online catalog: + http://MYCATALOG/cgi-bin/koha/opac-detail.pl?biblionumber=12501 + Items : + East Branch (813/.54) + South Branch FIC (FIC Bro) TVSN5000451333 + +`Example Email from Cart <#examplecartemail>`__ +----------------------------------------------- + +Below is a sample of what an email from the Cart in Koha will look like: + +:: + + Hi, + + Joaquin D'Planque sent you a cart from our online catalog. + + Please note that the attached file is a MARC bibliographic records + file which can be imported into personal bibliographic software like + EndNote, Reference Manager or ProCite. + + --------------------------------------------------------------------- + + + 1. Book / + Author(s): Brookfield, Karen. ; + Published by: Knopf : | Distributed by Random House, , 63 p. : , + 29 cm. + Copyright year: 1993 + Notes : Includes index. + LCCN: 93018833 /AC + + In online catalog: + http://MYCATALOG/cgi-bin/koha/opac-detail.pl?biblionumber=31644 + + Items: + + * East Branch (JNF 002 Bro) TVSN500017618A + + ----------------------------------------------------------------- + + 2. The 1965 World book year book : + + Published by: Field Enterprises Educational Corp., , 628 p. : , 26 + cm. + Copyright year: 1965 + Notes : Includes index. | Spine title: Year book, 1965. | Cover + title: The World book year book, 1965. + URL: + http://www.archive.org/details/1965worldbookyea00chic%20%7C%20http://www.openlibrary.org/books/OL24199089M + + In online catalog: + http://MYCATALOG/cgi-bin/koha/opac-detail.pl?biblionumber=88666 + + ----------------------------------------------------------------- + +Using Koha as a Content Management System (CMS) +=============================================== + +`Setup <#kohacmssetup>`__ +------------------------- + +These are instructions for taking a default install of Koha and allowing +it to function as a little content management system. This will allow a +library to publish an arbitrary number of pages based on a template. +This example uses the template for the main opac page, but you could +just as well use any template you wish with a bit more editing. This may +be appropriate if you have a small library, want to allow librarians to +easily add pages, and do not want to support a complete CMS. + +- Copy /usr/share/koha/opac/cgi-bin/opac/opac-main.pl to + /usr/share/koha/opac/cgi-bin/opac/pages.pl (in the same directory) + +- Edit pages.pl in an editor + +- At approximately line 33 change this code: + + :: + + template_name => "opac-main.tmpl", + +- To this code: + + :: + + template_name => "pages.tmpl", + +- At approximately line 62 after this code: + + :: + + $template->param( + koha_news => $all_koha_news, + koha_news_count => $koha_news_count, + display_daily_quote => C4::Context->preference('QuoteOfTheDay'), + daily_quote => $quote, + ); + +- Add these lines: + + :: + + my $page = "page_" . $input->param('p'); # go for "p" value in URL and do the concatenation + my $preference = C4::Context->preference($page); # Go for preference + $template->{VARS}->{'page_test'} = $preference; # pass variable to template pages.tt + +- Note pages.pl file must have Webserver user execution permissions, + you can use `chmod `__ command if + you are actually logged in as such user: + + :: + + $chmod 755 pages.pl + +- In the browser go to Home > Administration > System Preferences > + Local Use and add a New Preference called "page\_test" + +- Fill it out as so + + - Explanation: test page for pages tiny cms + + - Variable: page\_test + + - Value: Lorem ipsum + + - Click the TextArea link (or enter "TextArea" into the input field + below it) + + - variable options (last field): 80\|50 + +- In a browser go to http://youraddress/cgi-bin/koha/pages.pl?p=test + The page should come up with the words "Lorem ipsum" in the main + content area of the page. (replace "youraddress" with localhost, + 127.0.0.1, or your domain name depending on how you have Apache set + up.) + +- To add more pages simply create a system preference where the title + begins with "page\_" followed by any arbitrary letters. You can add + any markup you want as the value of the field. Reference the new page + by changing the value of the "p" parameter in the URL. + +To learn more visit the Koha wiki page on this topic: +http://wiki.koha-community.org/wiki/Koha_as_a_CMS + +`Editing the pages template <#kohacmstmpl>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The file to create / edit for the pages template will depend on your +`opacthemes <#opacthemes>`__ system preference setting + +`Editing 'bootstrap' theme template (current) <#kohacmstmplboot>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +- Copy + /usr/share/koha/opac/htdocs/opac-tmpl/bootstrap/en/modules/opac-main.tt + to + /usr/share/koha/opac/htdocs/opac-tmpl/bootstrap/en/modules/pages.tt + +- Edit + /usr/share/koha/opac/htdocs/opac-tmpl/bootstrap/en/modules/pages.tt + +- At approximately line 61, change this: + + :: + + [% IF ( OpacMainUserBlock ) %]
[% OpacMainUserBlock %]
[% END %] + +- To this: + + :: + + [% IF ( page_test ) %]
[% page_test %]
[% END %] + +Remark: You may wish to disable your News block of these CMS style pages +e.g. when you do not want it displayed on the CMS style pages or where +the News block is long enough that it actually makes the 'page\_test' +include scroll outside the default viewport dimensions. In that case, +remove the following code from your pages.tt template. + +:: + + [% IF ( koha_news_count ) %] +
+ + [% FOREACH koha_new IN koha_news %] + + + [% END %] +
[% koha_new.title %]

[% koha_new.new %]

+

(published on [% koha_new.newdate %])

+
+ [% END %] + + +`Troubleshooting <#kohacmstrouble>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If you have problems check file permissions on pages.pl and pages.tmpl. +They should have the same user and group as other Koha files like +opac-main.pl. + +`Bonus Points <#kohacmsbonus>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Instead of using the address +http://youraddress/cgi-bin/koha/pages.pl?p=test you can shorten it to +http://youraddress/pages.pl?p=test Just open up +/etc/koha/koha-httpd.conf and add the follow at about line 13: + +:: + + ScriptAlias /pages.pl "/usr/share/koha/opac/cgi-bin/opac/pages.pl" + +Then restart Apache. + +`Usage <#kohacmsusage>`__ +------------------------- + +After setting up Koha as a CMS you can create new pages following these +instructions: + +`Adding Pages <#kohacmspages>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +To add a new page you need to add a system preference under Local Use. + +- Get there: More > Administration > Global System Preferences > Local + Use + +- Click 'New Preference' + +- Enter in a description in the Explanation field + +- Enter a value that starts with 'page\_' in the Variable field + +- Enter starting HTML in the Value field + + Add a new preference + |image1076| + +- Set the Variable Type to Textarea + +- Set the Variable options to something like 20\|20 for 20 rows and 20 + columns + + Settings for the new preference + |image1077| + +`Viewing your page <#kohacmsview>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +You can view your new page at +http://YOUR-OPAC/cgi-bin/koha/pages.pl?p=PAGENAME where PAGENAME is the +part you entered after 'page\_' in the Variable field. + +`Example <#kohacmsexpage>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This process can be used to create recommended reading lists within +Koha. So once the code changes have been made per the instructions on +'Koha as a CMS' you go through the 'Adding a New Page' instructions +above to great a page for 'Recommended Reading Lists' + +Create page by modifying a system preference +|image1078| + +Next we need to create pages for our various classes (or categories). To +do this, return to the 'Adding a New Page' section and create a +preference for the first class. + +Add a new sys pref for another page +|image1079| + +Next you'll want to link your first page to your new second page, go to +the page\_recommend preference and click 'Edit.' Now you want to edit +the HTML to include a link to your newest page: + +Edit original preference to add new page +|image1080| + +`Live Examples <#examplecms>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- The Crawford Library at Dallas Christian College is using this method + for their recommended reading lists: http://opac.dallas.edu/ + +Resetting the Koha Database +=========================== + +These notes on how to reset the database for Koha were derived from the +following email thread: +http://lists.koha-community.org/pipermail/koha-devel/2009-January/008939.html +and http://lists.katipo.co.nz/public/koha/2014-June/039701.html + +Resetting the database may be useful if you install Koha with the sample +data, and then wish to use real data without reinstalling the software. + +`Delete sample data from Tables <#deletetables>`__ +-------------------------------------------------- + +Use your preferred MySQL client to +`delete `__ the +following tables: + +- bibio + +- biblioitems + +- items + +- auth\_header + +- sessions + +- zebraqueue + +You may need to disable foreign key checks to delete data from same +tables. For instructions follow this thread: +https://lists.katipo.co.nz/pipermail/koha/2013-July/036853.html. + +`Reset the Zebra Index <#resetzebra>`__ +--------------------------------------- + +Run the following commands to reset the authorities and biblios Zebra +indices. + +:: + + $ zebraidx -c /etc/koha/zebradb/zebra-authorities-dom.cfg -g iso2709 -d authorities init + $ zebraidx -c /etc/koha/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init + +If you are running a package install then you'll want to run the +following commands to reset the authorities and biblios Zebra indices +instead: + +:: + + $ sudo zebraidx -c /etc/koha/sites/YOURLIBRARY/zebra-authorities-dom.cfg  -g iso2709 -d authorities init + $ sudo zebraidx -c /etc/koha/sites/YOURLIBRARY/zebra-biblios.cfg  -g iso2709 -d biblios init + +Replacing YOURLIBRARY with your Koha installation name. + +Important Links +=============== + +`Koha Related <#koharelatedlinks>`__ +------------------------------------ + +- Report Koha Bugs - http://bugs.koha-community.org + +- Koha Versioning Control - http://git.koha-community.org/ + +- Database Structure - http://schema.koha-community.org + +- Koha Community Statistics - http://hea.koha-community.org + +- Koha as a CMS - http://wiki.koha-community.org/wiki/Koha_as_a_CMS + +- Kyles's Koha Tools - http://kylehall.info/index.php/projects/koha/ + +- Koha Bibliography - http://www.zotero.org/groups/koha + +- Koha Shared Links - http://groups.diigo.com/group/everything-koha + +`Circulation Related <#circrelatedlinks>`__ +------------------------------------------- + +- Koha Desktop Offline Circulation: + https://github.com/bywatersolutions/koha-offline-circulation/releases + +- Koha Firefox Offline Circulation: + https://addons.mozilla.org/en-US/firefox/addon/koct/ + +`Cataloging Related <#catalogrelatedlinks>`__ +--------------------------------------------- + +- Koha MARC Tutorials - http://www.pakban.net/brooke/ + +- IRSpy Open Z39.50 Server Search - http://irspy.indexdata.com/ + +- Z39.50 Server List - + http://staff.library.mun.ca/staff/toolbox/z3950hosts.htm + +- Open Koha Z39.50 Targets - + http://wiki.koha-community.org/wiki/Koha_Open_Z39.50_Sources + +- Library of Congress Authorities - http://authorities.loc.gov/ + +- MARC Country Codes - http://www.loc.gov/marc/countries/ + +- Search the MARC Code List for Organizations - + http://www.loc.gov/marc/organizations/org-search.php + +- Search for Canadian MARC Codes - + http://www.collectionscanada.gc.ca/illcandir-bin/illsear/l=0/c=1 + +- Z39.50 Bib-1 Attribute - + http://www.loc.gov/z3950/agency/defns/bib1.html + +`Enhanced Content Related <#enhancedcontentlinks>`__ +---------------------------------------------------- + +- Amazon Associates - + `https://affiliate-program.amazon.com `__ + +- Amazon Web Services - http://aws.amazon.com + +- WorldCat Affiliate Tools - + http://www.worldcat.org/wcpa/do/AffiliateUserServices?method=initSelfRegister + +- XISBN - http://www.worldcat.org/affiliate/webservices/xisbn/app.jsp + +- LibraryThing for Libraries - http://www.librarything.com/forlibraries + +`Design Related <#opaclinks>`__ +------------------------------- + +- JQuery Library - http://wiki.koha-community.org/wiki/JQuery_Library + +- HTML & CSS Library - + http://wiki.koha-community.org/wiki/HTML_%26_CSS_Library + +- Owen Leonard's Koha Blog - http://www.myacpl.org/koha + +`Reports Related <#reportlinks>`__ +---------------------------------- + +- SQL Reports Library - + http://wiki.koha-community.org/wiki/SQL_Reports_Library + +- Database Schema - http://schema.koha-community.org + +- Sample reports from NEKLS - + http://www.nexpresslibrary.org/training/reports-training/ + +`Installation Guides <#installlinks>`__ +--------------------------------------- + +- Installing Koha 3 on Ubuntu - + http://www.blazingmoon.org/guides/k3-on-u810-1.html + +- Koha on Debian installation documentation - + http://openlib.org/home/krichel/courses/lis508/doc/koha_installation_overview.html + +- Koha 3.2 on Debian Squeeze - + http://wiki.koha-community.org/wiki/Koha_3.2_on_Debian_Squeeze + +`Misc <#misclinks>`__ +--------------------- + +- Zotero - http://zotero.org + +- SOPAC - `http://thesocialopac.net `__ + +Koha XSLT Item Types +==================== + +When you have any of the XSLT system preferences +(`OPACXSLTDetailsDisplay <#OPACXSLTDetailsDisplay>`__, +`OPACXSLTResultsDisplay <#OPACXSLTResultsDisplay>`__, +`XSLTDetailsDisplay <#XSLTDetailsDisplay>`__, and/or +`XSLTResultsDisplay <#XSLTResultsDisplay>`__) along with the +`DisplayOPACiconsXSLT <#DisplayOPACiconsXSLT>`__ and +`DisplayIconsXSLT <#DisplayIconsXSLT>`__ preferences turned on you will +see item type icons on the related screen. + + **Important** + + These images are coming from values found in your leader, if your + leader is not cataloged properly it might be best to turn off the + `DisplayOPACiconsXSLT <#DisplayOPACiconsXSLT>`__ preference (which + can be done while leaving the other XSLT preferences turned on). + +Book image +|image1081| + +- Book [BK] + + - leader6 = a (and one of the leader7 values below) + + - leader7 = a + + - leader7 = c + + - leader7 = d + + - leader7 = m + + - leader6 = t + +Computer Image +|image1082| + +- Computer File [CF] + + - leader6 = m + +Continuing Resource Image +|image1083| + +- Continuing Resource [CR] + + - leader7 = b + + - leader7 = i + + - leader7 = s + +Map Image +|image1084| + +- Map [MP] + + - leader6 = e + + - leader6 = f + +Mixed Materials Image +|image1085| + +- Mixed [MX] + + - leader6 = p + +Sound Image +|image1086| + +- Sound [MU] + + - leader6 = c + + - leader6 = d + + - leader6 = i + + - leader6 = j + +Visual Material Image +|image1087| + +- Visual Material [VM] + + - leader6 = g + + - leader6 = k + + - leader6 = r + +Kit Image +|image1088| + +- Kit + + - leader6 = o + +MarcEdit +======== + +Many libraries like to use MarcEdit for modifications or data cleanup. +If you'd like to do this you will need to download it at: +http://marcedit.reeset.net/ + + **Important** + + Many of the actions described in this chapter can be done in Koha + using `Marc Modification Templates <#marcmodtemplates>`__, but this + section is here for those who are used to MarcEdit. + +`Adding a prefix to call numbers <#marceditprefix>`__ +----------------------------------------------------- + +When bringing data into Koha, you may want to first clean it up. One +common action among Koha users is to add a prefix to the call number. + +- Open MarcEdit + + MarcEdit + |image1089| + +- Click 'MarcEditor' + +- Go to Tools > Edit Subfield Data + + Edit subfield data + |image1090| + +- To prepend data the special character is: ^b  To simply prepend data + to the beginning of a subfield, add ^b to the Field Data: textbox and + the data to be appended in the Replace + + Prepend data to a field + |image1091| + + - To prepend data to the beginning of the subfield while replacing a + text string, add ^b[string to replace] to the Field Data textbox + and the data to be appended in the Replace With textbox. + +`Importing Excel data into Koha <#marceditexcel>`__ +--------------------------------------------------- + +Suppose you have records of your library in excel data sheet format and +want them to import into Koha. But how will you do this? Koha will not +let you import excel records directly. Well here is a very simple +solution for you which will let you import your excel records in Koha +easily. First, we will convert excel file into Marc file and then will +import it into Koha. + +Follow the given steps to import your excel records into Koha + +`Converting from Excel format into .mrk format <#convertexcel>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +First, we will convert excel format into .mrk format. For this we will +use MarcEdit. You can download it from http://marcedit.reeset.net/ + +Now open it and select Add-ins-->Delimited Text Translator. + +Delimited Text Translator +|image1092| + +Click Next when the following window appears. + +Delimited Text Translator +|image1093| + +Browse for your excel file. + +Delimited Text Translator +|image1094| + +Locate your excel file by choosing the format Excel File(\*.xls). + +Delimited Text Translator +|image1095| + +Similarly, fill all the other entries such as Output File, Excel Sheet +Name and check UTF-8 Encoded (if required) and Click Next. + +Delimited Text Translator +|image1096| + +Now you will be prompted for mapping the fields to recognise the fields +by standard marc format. + +Suppose for Field 0 that is first column I entered Map to: 022$a( Valid +ISSN for the continuing resource) and then click on Apply. + +Delimited Text Translator +|image1097| + + **Note** + + You can customize Indicators and all other things, for more + information on marc21 format visit the `official library of congress + site `__. + +Similarly map all other fields and then Click on Finish. + +Delimited Text Translator +|image1098| + +And then a window will appear indicating that your Marc Text +File(\*.mrk) has been created. + +Delimited Text Translator +|image1099| + +Click Close and we have created a .mrk file from .xls file in this step. +You can view the file by double clicking on it. + +`Convert .mrk file to .mrc <#convertmrk>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +We will convert .mrk file that we have created in the above step into +raw Marc format that can be directly imported into Koha. + +For this again open MarcEdit and Select MARC Tools. + +MARC Tools +|image1100| + +Next Select MarcMaker to convert .mrk file into .mrc format. + +MarcMaker +|image1101| + +Locate your input file and name your output file. Then Click Execute. + +MarcMaker +|image1102| + +And it will show you the Result. + +MarcMaker +|image1103| + +Click Close and now we have raw Marc records with us (.mrc file). + +`Import .mrc into Koha <#importmrc>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +More information on importing records into Koha can be found in the +'`Stage MARC Records for Import <#stagemarc>`__' section of this manual. + +Finally we will import above created .mrc file into Koha. + +Click on Tools in your Koha staff client. + +Koha Staff Client +|image1104| + +Next Click on Stage MARC Records for Import. + +Stage MARC Records for Import +|image1105| + +After this, choose your previously created .mrc file and click on +Upload. + +Stage File +|image1106| + +You can also add comment about file and finally click on Stage For +Import. + +Stage for Import +|image1107| + +When the import is done, you will get a result something like this + +Staged Records Summary +|image1108| + +Next, click on Manage staged records. + +Here you can even change matching rules. + +Manage Staged Records +|image1109| + +Click on Import this batch into catalog when you are done. + +Thats it. After all the records get imported, check Status and it should +read "imported" + +Finalize Import +|image1110| + +You can even undo the Import operation. + +And within few minutes, we have imported around 10,000 records in Koha + +Talking Tech +============ + +Talking Tech I-tiva is a third party, proprietary, product that +libraries can subscribe to. Learn more here: +http://www.talkingtech.com/solutions/library. + +`Installation and Setup Instructions <#talkingtechinstall>`__ +------------------------------------------------------------- + +Be sure you've run +installer/data/mysql/atomicupdate/Bug-4246-Talking-Tech-itiva-phone-notifications.pl +to install the required data pack (new syspref, notice placeholders and +messaging transport preferences) + +To use, +`TalkingTechItivaPhoneNotification <#TalkingTechItivaPhoneNotification>`__ +syspref must be turned on. + +If you wish to process PREOVERDUE or RESERVES messages, you'll need the +`EnhancedMessagingPreferences <#EnhancedMessagingPreferences>`__ system +preference turned on, and patrons to have filled in a preference for +receiving these notices by phone. + +For OVERDUE messages, overdue notice triggers must be configured under +Koha -> Tools -> `Overdue Notice Triggers <#noticetriggers>`__. Either +branch-specific triggers or the default level triggers may be used +(script will select whichever is appropriate). + +`Sending Notices File <#talkingtechsend>`__ +------------------------------------------- + +1. Add the `TalkingTech\_itiva\_outbound.pl <#talkingtechsendcron>`__ + script to your crontab + +2. Add an FTP/SFTP or other transport method to send the output file to + the I-tiva server + +3. If you wish, archive the sent notices file in another directory after + sending + +Run TalkingTech\_itiva\_outbound.pl --help for more information + +`Receiving Results File <#talkingtechreceive>`__ +------------------------------------------------ + +1. Add an FTP/SFTP or other transport method to send the Results file to + a known directory on your Koha server + +2. Add the `TalkingTech\_itiva\_inbound.pl <#talkingtechreceivecron>`__ + script to your crontab, aimed at that directory + +3. If you wish, archive the results file in another directory after + processing + +Run TalkingTech\_itiva\_inbound.pl --help for more information + +OCLC Connexion Gateway +====================== + +Koha can be set to work with the OCLC Connextion Gateway. This allows +libraries to use OCLC Connexion as their cataloging tool and simply send +those records to Koha with a single click. The following instructions +will help you set up the OCLC Connexion Gateway, if you have a system +administrator you will want to consult with them on this process. + +`Setting up OCLC service on Koha <#oclckohasetup>`__ +---------------------------------------------------- + +First, you'll need to create a file somewhere on your system with +configuration information.  You could put this anywhere that is visible +to the account that will be running the service. + +The file contains 11 lines. The first 6 will be about your Koha system: + +:: + + host: The IP address of your Koha server + port: The port you want to use for the Connexion service. This port must be different from your SIP port, or any other service + koha: The full URL of your staff client + log: The location (full file specification) of your log for the service + user: The default Koha username to use for importing + password: The password that goes with that username + +The remaining lines describe how to do the staging: + +:: + + match: The name of the matching rule from your system to use + overlay_action: "replace", "create_new", or "ignore"-- what to do if there is a match + nomatch_action: "create_new" or "ignore"-- what to do if there is no match + item_action: "always_add","add_only_for_matches","add_only_for_new", or "ignore" -- what to do with embedded 952 item data + import_mode: "direct" or "stage" + +A sample file would look like this: + +:: + + host: 1.2.3.4 + port: 8000 + log: /home/koha/koha-dev/var/log/connexion.log + koha: http://kohastaff.myuniversity.edu + user: koha_generic_staff + password: password + match: 001 + overlay_action: replace + nomatch_action: create_new + item_action: ignore + import_mode: direct + +When choosing an 'import\_mode' if you use "direct" then the staged +record will be immediately imported into Koha, and should be searchable +after your indexes catch up.  If you choose "stage", then the record +will be placed in a staged batch for you to later go the `Manage Staged +MARC Records <#managestaged>`__ tool to finish the import. + +If you import multiple records, they'll be in the same batch, until that +batch is imported, then a new batch will be created. + +In "direct" mode, each record will be in its' own batch. + +To start the service, run the script: + +:: + + /location/of/connexion/import/daemon/connexion_import_daemon.pl -d -c /location/of/config/file.cnf + +`Setting up your OCLC desktop client <#oclcdesktopsetup>`__ +----------------------------------------------------------- + + **Note** + + Screenshots are OCLC Connexion Client v.2.50, Koha v.3.12 + +To set up the OCLC Connexion desktop client to connect to Koha, go to +Tools > Options, then choose the Export tab. Connexion Export Tab + +- Click the "Create..." button to set up a new destination, then choose + "OCLC Gateway Export" and click OK. + + - Enter the following information: + + - "Host Name:" Your catalog’s appropriate IP address (from your + `config file above <#oclckohasetup>`__) + + - "Port:" Your catalog's appropriate port number (from your + `config file above <#oclckohasetup>`__) + + - "Login ID:" The cataloger's Koha login + + - "Password:" The cataloger's Koha password + + - "Notify Host Before Disconnect" = checked, + + - "Timeout" = 100, "Retries" = 3, "Delay" = 0 (zero), + + - "Send Local System Logon ID Password" = checked. + + OCLC Gateway Export Settings + |image1111| + +- Select "OK" when finished, and you should see your new "Gateway + Export" option listed (The catalog's IP address and port are blacked + out in the following screenshot) + + Gateway Export Added + +- Click on "Record Characteristics" and make sure that the + bibliographic records are using MARC21, UTF-8 Unicode, and click OK + to save. + + Record Characteristics + +You should be ready to go!  To export a record from OCLC Connexion +Client to Koha, just press F5 while the record is on-screen.  The export +dialog will pop up, and you'll see Connexion attempting to talk to Koha. + You should get a message that the record was added or overlaid, +including its biblio number, and a URL that you can copy into your web +browser to jump straight to the record. + +`Using the OCLC Connexion Gateway <#oclcgateway>`__ +--------------------------------------------------- + +Records can be exported from Connexion either in a batch or one by one. + +`Exporting records one by one <#oclconeexport>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +To export bibliographic records one by one, be sure your "Batch" options +are correct: from the "Tools" menu, select "Options", and select the +"Batch" tab. In the "Perform local actions in batch" area, +"Bibliographic Record Export" should be uncheckedConnexion batch options + +When ready to export, from the "Action" menu, select "Export" or use the +F5 key. You will see a screen similar to the following if the import is +successful and if the record is new to the Catalog; you may copy & paste +the resulting URL into your Koha catalog to see the new record.Connexion +Export + +If the record was overlaid, you will see a message to that effect in the +"OCLC Gateway Export Status" windowOverlay confirmation + +`Exporting records in a batch <#oclcbatchexport>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +To export bibliographic records in a batch, be sure your "Batch" options +are correct: from the "Tools" menu, select "Options", and select the +"Batch" tab. In the "Perform local actions in batch" area, +"Bibliographic Record Export" should be checkedOCLC Batch Export Options + +When a record is ready to export, from the "Action" menu, select +"Export" or use the F5 key, and it’s export status will be "ready." + +When ready to export the batch, from the "Batch" menu, select "Process +batch" and check the appropriate "Path" and "Export" boxesBatch import +process + +The export will begin, and the bib records will be exported & imported +into Koha one by one; you will see "OCLC Gateway Export Status" windows, +as above, showing you the results of each export. That window will stay +there until you select "Close," and then the next record’s export/import +will begin. The process will continue until all records in the batch are +completed. Then you may or may not see the Connexion Client export +report (depending on your Client options for that). + +`Items in OCLC <#oclcitems>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If you'd like to create your item records in OCLC you can do so by +addding a 952 for each item to the bib record you're cataloging. The +`Item/Holdings Cataloging Guide <#itemcatguide>`__ will break down what +subfields you can use in the 952, but at the minimum you want to have +subfield 2, a, b, and y on your items. + +952 +\\\\$2CLASSIFICATION$aHOMEBRANCHCODE$bHOLDINGBRANCHCODE$yITEMTYPECODE + +- The subfield 2 holds the classification code. This can be ddc for + Dewey or lcc for Library of Congress or z for Custom. Other + classification sources can be found in the `Classification + Sources <#classificationsources>`__ area in administration + +- Subfield a is your home library and needs to be the code for your + home library, not the library name. You can find these codes in the + `Libraries & Groups <#libsgroups>`__ administration area. + +- Subfield b is your holding library and needs to be the code for your + holding library, not the library name. You can find these codes in + the `Libraries & Groups <#libsgroups>`__ administration area. + +- Subfield y is your item type code. It needs to be the code, not the + item type name. You can find these codes in the `Item + Types <#itemtypeadmin>`__ administration area. + +952 \\\\$2ddc$aMAIN$bMAIN$yBOOK + +In addition to these required fields you can enter any other subfield +you'd like. Most libraries will enter a call number in subfield o and a +barcode in subfield p as well. Review the `Item/Holdings Cataloging +Guide <#itemcatguide>`__ for a full list of subfields and values. + +FAQs +==== + +`Display <#displayfaq>`__ +------------------------- + +`Custom Item Type/Authorized Value Icons <#customicons>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question:** Can I have my own set of item type images (or authorized +value icons)? + +**Answer:**\ Absolutely. To add additional icons to your system you +simply add a new directory to +koha-tmpl/intranet-tmpl/prog/img/itemtypeimg/ and to +koha-tmpl/opac-tmpl/prog/itemtypeimg and put your icons in the new +directory. Your icons will show up in a new tab as soon as they are in +the folders. + +- **Note** + + Remember to put the icons in both places (on the OPAC and the + intranet). + +`Customizing Koha Images <#customkohaimages>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Can I customize the images in the OPAC? + +**Answer**: Absolutely. Koha comes with a series of original images that +you can alter to meet your needs. The originals can be found in the +misc/interface\_customization/ directory. + +`OPAC Display Fields <#opacdisplayfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: What MARC fields print to the different OPAC screens in +Koha? + +**Answer**: The XSLT preference must be set as follows for the following +fields to show + +- `OPACXSLTResultsDisplay <#OPACXSLTResultsDisplay>`__ = using XSLT + stylesheets + +- `OPACXSLTDetailsDisplay <#OPACXSLTDetailsDisplay>`__ = using XSLT + stylesheets + +- `DisplayOPACiconsXSLT <#DisplayOPACiconsXSLT>`__ = show + +The OPAC Results page shows: + +- 245 + +- 100, 110, 111 + +- 700, 710, 711 + +- 250 + +- 260 + +- 246 + +- 856 + +The OPAC Details page shows: + +- 245 + +- 100, 110, 111 + +- 700, 710, 711 + +- 440, 490 + +- 260 + +- 250 + +- 300 + +- 020 + +- 022 + +- 246 + +- 130, 240 + +- 6xx + +- 856 + +- 505 + +- 773 + +- 520 + +- 866 + +- 775 + +- 780 + +- 785 + +- plus all of the 5xx fields in the Notes tab at the bottom + +`Subtitle Display on Bib Records <#displaysubtitle>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: How do I get the subtitle to display on the detail pages +for my bib records? + +**Answer**: Subtitle display now depends on there being a `keyword +mapping <#keywordmapping>`__ for the MARC field in question. Adding a +mapping for "subtitle" -> "245b" for an item's framework results in +display of the subtitle in OPAC and staff client search and detail pages +(although not in all instances where subtitles might be displayed, e.g. +the Cart). + +`Show patrons the barcodes of items they have checked out <#opacbarcodesfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Can patrons see the barcodes for the items they have +checked out. + +**Answer**: Not by default, but with a few edits to the patron record +you can make a barcode column appear on the patron's check out summary +in the OPAC. You can set up a `patron +attribute <#patronattributetypes>`__ with the value of SHOW\_BCODE and +`authorized value <#authorizedvalues>`__ of YES\_NO to make this happen. + +Add SHOW\_BCODE patron attribute +|image1112| + +Then on the `patron's record set the value <#editpatrons>`__ for +SHOW\_BCODE to yes. + +Setting value for SHOW\_BCODE on patron record +|image1113| + +This will add a column to the check out summary in the OPAC that shows +the patrons the barcodes of the items they have checked out. + +Barcode number on checkout list in OPAC +|image1114| + +Clicking on the 'Overdue' tab will show only the items that are overdue. + +`Circulation/Notices <#circfaq>`__ +---------------------------------- + +`Book drop Date <#dropboxfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: How is the book drop date is determined? Is it the last +open date for the checkout branch? Is it today's date minus one? Can the +book drop checkin date be set? + +**Answer**: If the library is closed for four days for renovations, for +example, there would be more than one day needed for the book drop date. +You will only have one book drop date and that will be the last day that +the library open (determined by the holiday calendar) because there is +no real way to know what day the books were dropped into the box during +the 4 closed days. The only way to change the effective checkin date in +book drop mode is to modify the calendar. + +`Holds to Pull and Holds Queue <#holdsreportsfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: What is the difference between the `Holds +Queue <#holdsqueue>`__ and `Holds to Pull <#holdspull>`__? + +**Answer**: The holds to pull report gives a simple list of what holds +need to be filled with available items. It should only be used in Koha +installations where there is only one library. + +The holds queue tries to do the same thing, but in a 'smarter' way. This +allows it to split up the list by library, consult the `transport cost +matrix <#transportcostmatrix>`__ and refresh regularly to provide +different pull lists to each library. + +`Duplicate Overdue Notices <#dupoverduefaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Why are patrons getting two overdue notices? + +**Answer**: This tool takes all branches in the overdue rules and sent +notifications to them. So, if you have a default rule & a branch rule, +the notification will be generated twice. A quick fix is to discard +"default rule" for instance. + +`Printing Overdue Notices <#printoverduefaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Can I print overdue notices for patrons without email +addresses on file? + +**Answer**: Yes. The `overdue notice cron job <#overduenoticecron>`__ +has a setting to generate the overdue notices as HTML for printing. An +example of this usage would be: + +:: + + overdue_notices.pl -t -html /tmp/noticedir -itemscontent issuedate,date_due,title,barcode,author + +In this example, we wanted to use only certain item fields in our +notices, so we specified itemscontent fields in the cron entry; that's +not a requirement for the feature. + +The command line needs to specify a web-accessible directory where the +print notices will go -- they get a filename like +notices-2009-11-24.html (or holdnotices-2009-11-24.html). The overdue +notice itself can be formatted to fit a Z-mailer. Within the notice +file, the text is spaced down or over to where it will print properly on +the form. The script has code that wraps around the notice file to tell +the HTML to obey the formatting, and to do a page break between notices. +That's so that when staff print it out, they get one per page. We had to +add an extra syspref (`PrintNoticesMaxLines <#PrintNoticesMaxLines>`__) +to specify page length because our client allows a \_lot\_ of checkouts +which meant some notices were running onto multiple pages. That syspref +says to truncate the print notice at that page length and put in a +message about go check your OPAC account for the full list. + +The print and email overdues use the same notice file. The print notices +for holds are different -- there's a separate HOLD\_PRINT notice file +and the system uses it if there's no email address. Then a nightly cron +job runs to gather those up from the message queue and put them in an +HTML file in the notice directory, as above. + +The cron entry is gather\_print\_notices.pl /tmp/noticedir + +`Unable to Renew Items <#renewfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: We're trying to renew some items for our patron. One of +the items is on hold and ineligible for renewal, but the other two items +refuse to renew even though they should be eligible. When I try to use +the override renewal limit, it just returns a little message that says +"renewal failed". Any idea what's going on here? + +**Answer**: At the very least you will need to set an absolute `default +circulation rule <#circfinerules>`__. This rule should be set for the +default itemtype, default branchcode and default patron category. That +will catch anyone who doesn't match a specific rule. Patrons who do not +match a specific rule will get blocked from placing holds or renewing +items, since there was no baseline number of holds or renewals to +utilize. + +`Unable to Place Holds <#holdsfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Why can't I place holds when I have all of the preferences +turned on. + +**Answer**: You probably need to set a default circulation rule. At the +very least you will need to set an default circulation rule. This rule +should be set for all item types, all branches and all patron +categories. That will catch all instances that do not match a specific +rule. When checking out if you do not have a rule for the default +branch, default item and default patron category then you may see +patrons getting blocked from placing holds. + +`Keyboard Shortcuts <#keyboardshort>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Do I have to use my mouse to access the checkout, checkin +and cataloging tabs at the top of the circulation pages? + +**Answer**: You can jump between the tabs on the quick search box at the +top of the screen by using the following hot keys (if the tab is +available): + +- jump to the catalog search with Alt+Q + +- jump to the checkout with Alt+U + + - this will not work for Mac user + +- jump to the checkin with Alt+R + + **Note** + + Mac users use the OPTION button in place of ALT + +`SMS Notices/Messages <#smsnoticefaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: I want Koha to send notices via SMS, what do I need to do? + +**Answer**: First you need to choose a SMS service to use with Koha. +There is a list available here: +http://search.cpan.org/search?query=sms%3A%3Asend&mode=all Not all SMS +services available to libraries have Perl drivers, so be sure to check +this list to see if the provider you're considering is listed. If not +you want to ask your provider if they have a Perl module, if not you +should consider another service. Some common options in the US (that +have Perl drivers) are: + +- AQL (`www.aql.com `__) + +- Wadja (`wadja.com `__) + +- Ipipi (`ipipi.com `__) + +- T-mobile + +- SMSDiscount (`smsdiscount.com `__) + +- Clickatell + +**Question**: What about in India? + +**Answer**: India does not yet have too many options here. This is +partly due to the Telecom regulatory authority's (TRAI) stipulations +about transactional SMSes and limits on the number of SMSes that may be +sent / received per users per day. India specific drivers include: + +- Unicel Technologies Pvt Ltd (`unicel.in `__) + +`Cataloging <#catfaq>`__ +------------------------ + +`Authority Fields <#authorityfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question:**\ Why can't I edit 1xx, 6xx, or 7xx fields in my catalog +record? + +**Answer:** These fields are authority controlled and you probably have +the `BiblioAddsAuthorities <#BiblioAddsAuthorities>`__ set to "Don't +allow". When it is set to "Don't allow" these fields will be locked and +require you to search for an existing authority record to populate the +field with. To allow typing in these authority fields set +`BiblioAddsAuthorities <#BiblioAddsAuthorities>`__ to 'Allow'. + + **Note** + + Fields affected by this preference will show a lock symbol in them + +Fields affected by this preference show a lock in the field +|image1115| + +`Koha to MARC Mapping <#kohamarcfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: What's the relationship between 'Koha to MARC Mapping' and +'MARC Bibliographic Frameworks'? + +**Answer**: Mapping can be defined through 'MARC Bibliographic +Frameworks' OR 'Koha to MARC Mapping'. 'Koha to MARC Mapping' is just a +shortcut to speed up linkage. If you change a mapping in one of these +modules, the mapping will change in the other as well. (In other words, +the two modules 'overwrite' each other in order to prevent conflicts +from existing in Koha). + +`Number of Items Per Bib Record <#itemsperbibfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Is there a limit on the number of items I can attach to a +bib record? + +**Answer**: There is no explicit limit to the number of items you can +attach to a bibliographic record, but if you attach enough of them, your +MARC record will exceed the maximum file size limit for the ISO 2709 +standard, which breaks indexing for that record. I've found this occurs +somewhere between 600 and 1000 items on a 'normal' bibliographic record. + +`Analytics <#analyticsfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: I am using the +`EasyAnalyticalRecords <#EasyAnalyticalRecords>`__ feature, but my links +in the OPAC and Staff Client to 'Show Analytics' are not working. + +**Answer**: If you plan on using +`EasyAnalyticalRecords <#EasyAnalyticalRecords>`__ you will want to make +sure to set your `UseControlNumber <#UseControlNumber>`__ preference to +"Don't use," this will prevent broken links. + +`Acquisitions <#acqfaq>`__ +-------------------------- + +`Planning Categories <#planningcatfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: What is a planning category? + +**Answer**: When you plan in advance for the way your budget is going to +be spent, you initially plan for how it's going to be spent over time, +that's the most natural thing to do. + +So you plan for $1000 in Jan. $1000 in Feb., $3000 in March, etc. You +can basically do the same thing with a list of values in lieu of the +months. + +Say you have a list like this one: + +- < 1 month + +- < 6 months + +- < 1 year + +- < 3 years + +- < 10 years + +- > 10 years + +The list is meant to represent when the books acquired where published. +Then you plan for it, saying: we went to spend at list 40% of our +budgets on books published less than a year ago, 10% on books more than +10 years old, etc. + +Upon acquiring new material, you'll be able to select, for a given item, +a value from this list in a drop down. Then, after the material has been +acquired, at the end of the year, you'll be able to compare the goals +set, with what's been achieved. + +`Serials <#serialsfaq>`__ +------------------------- + +`Advanced Patterns <#advancedpatternfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: What is the 'inner counter' on the advanced serials +pattern interface? + +**Answer**: I think it is better to give an example to understand this : + +Example for a monthly subscription : + +- First issue publication date : April 2010 + +- Numbering : No {X}, year {Y} + +- First issue : No 4, year 2010 + +For the year Y : you will want the year change on January 2011 + +So, the advanced pattern for Y will be : + +- Add : 1 + +- once every : 12 + +- When more than 9999999 + +- inner counter : 3 + +- Set back to 0 + +- Begins with 2010 + +Year is going to change after 12 received issues from April 2010, that +is in April 2011 if you don't set inner counter. Set inner counter to 3 +will say to Koha : change year after 12-3 = 9 received issues. + +Inner counter says to Koha to take into account the first issues of the +year, even if they are not received with Koha. If you begin with first +issue of the year write nothing or 0. + +`Reports <#reportsfaq>`__ +------------------------- + +`Define Codes Stored in DB <#accounttypefaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +`Fines Table <#finescodefaq>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question:** What do the codes in the accounttype field in the +accountlines table stand for? + +**Answer:** + +- A = Account management fee + +- C = Credit + +- F = Overdue fine + +- FOR = Forgiven + +- FU = Overdue, still acccruing + +- L = Lost item + +- LR = Lost item returned/refunded + +- M = Sundry + +- N = New card + +- PAY = Payment + +- W = Writeoff + +`Statistics Table <#statscodefaq>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question:**\ What are the possible codes for the type field in the +statistics table? + +**Answer:** + +- localuse + + - Registers if an item that had been checked out to a statistics + patron (category type = 'X') is returned + +- issue + +- return + +- renew + +- writeoff + +- payment + +- CreditXXX + + - The XXX stores different types of fee credits, so a query to catch + them all would include a clause like "type LIKE 'Credit%'" + +`Reserves Table <#rescodefaq>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question**: What are the possible codes for the found field in the +reserves and old\_reserves tables? + +**Answer**: + +- NULL: means the patron requested the 1st available, and we haven't + chosen the item + +- T = Transit: the reserve is linked to an item but is in transit to + the pickup branch + +- W = Waiting: the reserve is linked to an item, is at the pickup + branch, and is waiting on the hold shelf + +- F = Finished: the reserve has been completed, and is done + +`Reports Dictionary Table <#reportdicfaq>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question**: What are the possible codes for the area field in the +reports\_dictionary table? + +**Answer**: + +- 1 = Circulation + +- 2 = Catalog + +- 3 = Patrons + +- 4 = Acquisitions + +- 5 = Accounts + +`Messages Table <#msgtablefaq>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question**: What are the possible codes for the message\_type field in +the messages table? + +**Answer**: + +- L = For Librarians + +- B = For Patrons/Borrowers + +`Serial Table <#serialtablefaq>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question**: What are the possible codes for the status field in the +serial table? + +**Answer**: + +- 1 = Expected + +- 2 = Arrived + +- 3 = Late + +- 4 = Missing + +- 5 = Not available + +- 6 = Delete + +- 7 = Claimed + +- 8 = Stopped + +- 41 = Missing (not received) + +- 42 = Missing (sold out) + +- 43 = Missing (damaged) + +- 44 = Missing (lost) + +`Borrowers Table <#borrowerprivacyvalues>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question**: What are the possible codes for the privacy field in the +borrowers table? + +**Answer**: + +- 0 = Forever + +- 1 = Default + +- 2 = Never + +`Messaging Preferences <#messpreffaq>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question**: What are the possible codes in the message\_attribute\_id +field in the borrower\_message\_preferences table? + +**Answer**: + +- 2 = advanced notice + +- 6 = item checkout + +- 4 = hold filled + +- 1 = item due + +- 5 = item check in + +`Runtime Parameters <#runtimefaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Is there a way to filter my custom SQL reports before they +run? + +**Answer**: If you feel that your report might be too resource intensive +you might want to consider using runtime parameters to your query. +Runtime parameters basically make a filter appear before the report is +run to save your system resources. + +There is a specific syntax that Koha will understand as 'ask for values +when running the report'. The syntax is <>. + +- The << and >> are just delimiters. You must put << at the beginning + and >> at the end of your parameter + +- The 'Question to ask' will be displayed on the left of the string to + enter. + +- The authorized\_value can be omitted if not applicable. If it + contains an authorized value category, or branches or itemtype or + categorycode or biblio\_framework, a list with the Koha authorized + values will be displayed instead of a free field Note that you can + have more than one parameter in a given SQL Note that entering + nothing at run time won't probably work as you expect. It will be + considered as "value empty" not as "ignore this parameter". For + example entering nothing for : "title=<>" will display + results with title='' (no title). If you want to have to have + something not mandatory, use "title like <>" and enter a + % at run time instead of nothing + +Examples: + +- SELECT surname,firstname FROM borrowers WHERE branchcode=<> AND surname like <> + +- SELECT \* FROM items WHERE homebranch = <> and barcode like <> + +- SELECT title , author FROM biblio WHERE frameworkcode=<> + + **Note** + + To generate a date picker calendar to the right of the field when + running a report you can use the 'date' keyword like this: <> + + Date Picker + |image1116| + + **Note** + + You have to put "%" in a text box to 'leave it blank'. Otherwise, it + literally looks for "" (empty string) as the value for the field. + + **Important** + + In addition to using any authorized value code to generate a + dropdown, you can use the following values as well: Framework codes + (biblio\_framework), Branches (branches), Item Types (itemtypes) and + Patron Categories (categorycode). For example a branch pull down + would be generated like this <> + + Branch pull down + |image1117| + +`Results Limited <#reportlimitfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: When I download my report it's limited to 10,000 results, +how do I get all of the results to download? + +**Answer**: There is a limit of 10,000 records put on SQL statements +entered in Koha. To get around this you want to add 'LIMIT 100000' to +the end of your SQL statement (or any other number above 10,000. + +`Searching <#searchfaq>`__ +-------------------------- + +`Advanced Search <#advancedsearchfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +`Scan Indexes <#scanindexfaq>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question**: What does 'scan indexes' on the advanced search page mean? + +**Answer**: When you choose an index, enter a term, click 'scan indexes' +and do the search, Koha displays the searched term and the following +terms found in this index with the number of corresponding records That +is search is not made directly in the catalog, but first in the indexes +It works only for one index at once, and only with no limit in Location +(All libraries needed) + +`Searching for Terms that Start With a Character <#searchstartswith>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question**: How do I search for all titles that start with the letter +'C'? + +**Answer**: You can choose to search for things that start with a +character or series of characters by using the CCL 'first-in-subfield' + +- example: ti,first-in-subfield=C + +`Wildcard Searching <#wildcardsearchfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**:What is the difference between a keyword search using the +'\*' (asterisk) versus a keyword search using the '%' (percent)? Both +work in the catalog, but return different sets. Why? + +**Answer**: A wildcard is a character (\*,?,%,.) that can be used to +represent one or more characters in a word. Two of the wildcard +characters that can be used in Koha searches are the asterisk ('\*') and +the percent sign ('%'). However, these two characters act differently +when used in searching. + +The '\*' is going to force a more exact search of the first few +characters you enter prior to the '\*'. The asterisk will allow for an +infinite number of characters in the search as long as the first few +characters designated by your search remain the same. For example, +searching for authors using the term, Smi\*, will return a list that may +include Smith, Smithers, Smithfield, Smiley, etc depending on the +authors in your database. + +The '%' will treat the words you enter in the terms of "is like". So a +search of Smi% will search for words like Smi. This results in a much +more varied results list. For example, a search on Smi% will return a +list containing Smothers, Smith, Smelley, Smithfield and many others +depending on what is your database. + +The bottom line in searching with wildcards: '\*' is more exact while +'%' searches for like terms. + +`Title Searching <#titlesearchingfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Why does my Zebra title search for 'Help' not turn up 'The +help' in the first pages of results? + +**Answer**: When doing a title search, you actually want to search for +the title (i.e., 'the help' rather than just 'help'), and it will bubble +right up to the top. If you're just searching for 'help' then the +relevance ranking is going to affect the results you see. + +When it comes to relevance in Zebra, here's what's happening. First, the +search is done. If you search for the title "help", then any title that +has "help" in it comes back. Then from those records, separately, it +does relevance on the \*whole\* record. The more your word appears, the +more relevant, and some MARC tags are worth more points than others. So +a self-help book with 505 notes where "help" appears a \*lot\* will be +at the top, regardless of keyword or title. + +But when you add a \*second word\*, that helps it figure things out, as +it's weighing the relevance of both words and the phrase. Because of the +way relevance works, if you search "the help", then "the help" or "the +help I need" are more relevant than "the way to help", because they +appear together in order. Likewise, "help the girl" would be lower +relevance, because it's out of order, and "help for the homeless" would +be lower still, as they're out of order, and apart. + +The moral of the story is that single word searches, particularly on +common words, will always struggle a bit; it can't evaluate relevance +well, because you've not given it enough input. + +`Enhanced Content <#enhancedcontentfaq>`__ +------------------------------------------ + +`FRBRizing Content <#frbrfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question:**\ At our public library we are running a Koha installation +and we've tried to turn on all the nice functionalities in Koha such as +the frbrising tool, but do not get the same result as Nelsonville public +library. + +**Answer:**\ In fact, this feature is quite tricky to make that right. +First it looks at XISBN service. And then search in your database for +that ISBN. So both XISBN and your internal ISBN (in biblio table) have +to be normalized. You could therefore use the script +misc/batchupdateISBNs.pl (it removes all the - in your local ISBNs) + +`Amazon <#amzfaq>`__ +~~~~~~~~~~~~~~~~~~~~ + +`All Amazon Content <#amazonfaq>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question**: I have all of the Amazon preferences turned on and have +entered both of my keys, but none of the content appears in my system, +why is that? + +**Answer**: Amazon's API checks your server time on all requests and if +your server time is not set properly requests will be denied. To resolve +this issue be sure to set your system time appropriately. Once that +change in made Amazon content should appear immediately. + +On Debian the the command is *date -s "2010-06-30 17:21"* (with the +proper date and time for your timezone). + +`System Administration <#systemfaq>`__ +-------------------------------------- + +`Errors in Zebra Cron <#zebracronfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: I am noticing some errors in the +koha-zebradaemon-output.log file. When new records are added it takes a +bit longer to index than we think they should. Running rebuild zebra is +often faster. Zebra ends up indexing and search works, but I am +concerned about the errors. Any ideas? + +**Answer**: Rebuild\_zebra.pl -r deletes all of the files in the Zebra +db directories (such as reci-0.mf) and then recreates them. Thus, +permissions will be lost, and the files will be owned by the user who +ran rebuild\_zebra.pl. If one rebuilds the zebra indexes as root, the +daemons, which typically run under the user Koha, will not be able to +update the indexes. Thus, it's important then that the zebra rebuilds +are put in the cronjob file of the user Koha, and not root. Also +important is that other users, such as root, don't manually execute +rebuilds. + +If one desires that another user be able to execute rebuild\_zebra.pl, +he should be given the permission to execute 'sudo -u Koha +.../rebuild\_zebra.pl,' (if you want to do this, you also have to edit +the sudoers file to pass the PERL5LIB variable with the env\_keep option +as by default sudo strips away almost all environment variables). Or, as +root user, one can use a simple 'su koha' and then the rebuild\_zebra.pl +command. + +I've also tried to set the sticky bit on rebuild\_zebra.pl, but for +whatever reason it didn't seem to work due to some problem with the +PERL5LIB variable that I wasn't able to figure. That seems to me the +easiest thing to do, if anybody has any idea how to make it work. If it +worked and were the default, I think it would help folks to avoid a +great deal of the problems that come up with zebra. + +`Making Z39.50 Target Public <#publicztarget>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Could someone tell me the exact steps I need to take to +configure Zebra to expose my Koha 3 db as a public Z39.50 service? + +**Answer**: Edit the KOHA\_CONF file that your Koha is using. Uncomment +the publicserver line like: + + + +to be: + +tcp:@:9999 + +Then restart zebasrv and connect on the port specified (9999). + +`Shelving Location Authorized Values <#authvalfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: When editing an item, the new shelving location I created +is not showing up by default in the items where I assigned it to. + +**Answer**: This is because you created the new shelving location with a +code value of 0 (zero) Just FYI the system interprets authorized values +of 0 as equaling a null so when you edit a record in cataloging where +the authorized value in a field was assigned where the code was 0, the +value displays as null in the item editor (or MARC editor) instead of +the value the library meant it to be. + +`Why do I need Authorized Values? <#whyauthvals>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Why would I want to define authorized values for MARC +tags? + +**Answer**: Authorized Values create a 'controlled vocabulary' for your +staff. As an example, let us assume that your Koha installation is used +by several libraries, and you use MARC 21. You might want to restrict +the 850a MARC subfield to the institution codes for just those +libraries. In that case, you could define an authorized values category +(perhaps called "INST") and enter the institution codes as the +authorized values for that category. + + **Note** + + Koha automatically sets up authorized value categories for your item + types and branch codes, and you can link these authorized values to + MARC subfields when you set up your MARC tag structure. + +`How do I clean up the sessions table? <#sessionstblfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: Is there a periodic job that can be run to cull old +sessions from the table? We don't want to backup all the useless session +data every night. + +**Answer**: You can run `cleanup database cron job <#cleandbcron>`__. + +Or just before doing a backup command (mysqldump), you can truncate +session table:   + +:: + + mysql -u`__ +--------------------------- + +`Barcode Scanners <#barcodefaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +**Question**: What barcode scanners have been known to work with Koha? + +**Answer**: The simple rule of thumb is, does it act like a keyboard +device?, if so, it will work. (i.e. can you take the scanner, scan a +barcode and have it show up in a text editor, if so, it will work.) + +The main points to check are that it connects to your PC conveniently +(can be USB or "keyboard wedge" which means it connects in line with the +keyboard, which is useful with older computers), and that it scans the +barcode type that you are using. + +It is a good idea to test some 'used' barcodes if you have any, to see +whether the scanner can read scuffed or slightly wrinkled ones +successfully. Most scanners are capable of reading several barcode types +- there are many, and the specification should list the ones it can +read. You may need to adjust settings slightly, such as prefix and +suffix characters, or whether you want to send an 'enter' character or +not. + +One more tip - some can be set 'always on' and may come with a stand, +some have triggers under the handle, some have buttons on top, some are +held like a pen. Think about the staff working with the hardware before +choosing, as a button in the wrong place can be very awkward to use. + +`Printers <#printersfaq>`__ +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +`Printers used by Koha libraries <#kohaprinters>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +- POS-X receipt printer + +- Star Micronics printer (exact model unknown) with a generic/plain + text driver. + +- Star SP2000 (Nelsonville) + +- Star TSP-100 futurePRINT (Geauga) + + - "I know there have been a lot of questions on receipt printers so + I thought I'd pass on my findings. We have been testing the Star + TSP-100 futurePRINT. I found this print to be VERY easy to + configure for Koha. I was even able to customize the print job by + adding our system logo (a .gif) to the top of every receipt. Also + with a bitmap created in Paint was able to add a message at the + bottom of each receipt with the contact information, hours and + website for the library that the materials were checked out at." + +- Epson TM 88 IIIP thermal receipt printers + +- Epson TM-T88IV + +- 1x1 labels using a Dymolabelwriter printer + +`Braille Support <#braillefaq>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +**Question**: Are there any braille embosser or printer which has +inbuilt braille converter and it is accessible with UNIX environment? + +**Answer**: You may want to look into BRLTTY +(http://www.emptech.info/product_details.php?ID=1232). + +`Additional Support <#hardwaresupport>`__ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +- http://www.nexpresslibrary.org/go-live/configure-your-receipt-printers/ + +Extending Koha +============== + +`Amazon lookup script for Koha libraries <#amzlookup>`__ +-------------------------------------------------------- + +We order most of our materials from Amazon, so I've been looking for a +convenient way to tell if a book under consideration is in our catalog +already. + +Greasemonkey & a custom user script fit the bill nicely: + +- https://addons.mozilla.org/en-US/firefox/addon/748 + +- http://userscripts.org/scripts/show/56847 + +A few caveats: + +- Like most scripts, this one was designed to work with Firefox; I + haven't explored getting it to work with other browsers. + +- I'm not a JavaScript programmer -- this was adapted from others' + work. Just a few lines would have to be changed to get the script to + work with your catalog. + +- It depends on the existence of ISBN for the item in question, so + movies, older books, etc. would not work. + +Others have added all sorts of bells & whistles: XISBN lookups to search +for related titles, custom messages based on the status of items (on +order, on hold, etc.), ... just search the UserScripts site for Amazon + +library. For a later date! + +`Keyword Clouds <#extendkeywordclouds>`__ +----------------------------------------- + +In addition to the traditional tag cloud available in Koha, there is a +way to generate clouds for popular subjects within Koha. + +The `Author/Subject Cloud cron job <#keywordclouds>`__ is used to help +with this process. This cron job sends its output to files. + +- /home/koha/mylibrary/koharoot/koha-tmpl/cloud-author.html + +- /home/koha/yourlibrary/koharoot/koha-tmpl/cloud-subject.html + +This means that you can produce clouds for authors, collective author, +all kind of subjects, classifications, etc. And since it works on zebra +indexes, it is quick, even on large DBs. Tags clouds are sent to files. +It's up to library webmaster to deal with those files in order to +include them in `OPACMainUserBlock <#OpacMainUserBlock>`__, or include +them into their library CMS. + +Some libraries even send the file into a Samba shared folder where +webmaster take them, eventually clean them a little bit before +integrating them into navigation widgets or pages. + +`Newest Titles Pulldown <#newtitlesoption>`__ +--------------------------------------------- + +Often we want to add a way for our patrons to do searches for the newest +items. In this example I'll show you how to create a pull down menu of +the newest items by item type. These tips will work (with a couple +changes) for collection codes or shelving locations as well. + +First, it's important to note that every link in Koha is a permanent +link. This means if I do a search for everything of a specific item type +sorted by the acquisitions date and bookmark that URL, whenever I click +it I'll see the newest items of that type on the first few pages of the +results. + +I took this knowledge and wrote a form takes this functionality in to +consideration. It basically just does a search of your Koha catalog for +a specific item type and sorts the results by acquisitions date. + +The first thing I did was write a MySQL statement to generate a list of +item types for me - why copy and paste when you can use the power of +MySQL? + +:: + + select concat('') from itemtypes + +The above looks at the itemtypes table and slaps the necessary HTML +around each item type for me. I then exported that to CSV and opened it +in my text editor and added the other parts of the form. + +:: + +

New Items

+

+ + + + +
+

+ +Now, what does all of that mean? The important bits are these: + +First the starting of the form. + +:: + +

+ +This tells the browser to take any value selected and put it at the end +of this http://YOURSITE/cgi-bin/koha/opac-search.pl. If you want to +embed this form on your library website (and not on your OPAC) you can +put the full OPAC URL in there. + +Next, there is a hidden value that is telling the search to sort by +acquisitions date descending (newest items at the top): + +:: + + + +And finally you have an option for each item type you want people to +search. + +:: + + + +These options each include the string "mc-itype:" which tells Koha to do +an item type search. + +Once you have all of that in place you can copy and paste the form to +somewhere on your OPAC. The `Farmington Public Libraries +OPAC `__ has a few examples of +this on the left. + +`Cataloging and Searching by Color <#colorsearch>`__ +---------------------------------------------------- + +One of the icon sets installed in Koha includes a series of colors. This +set can be used to catalog and search by color if you'd like. This guide +will walk you use changing collection code to color in Koha so that you +can do this. + +The following SQL could be used to add these colors to the CCODE +authorized value category in a batch. If you wanted to use these colors +for another authorized value you'd have to edit this to use that +category: + +:: + + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','000000','Black','','colors/000000.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','66cc66','Bright Green','','colors/66cc66.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','99cc33','Olive','','colors/99cc33.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','3333cc','Dark Blue','','colors/3333cc.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','006600' ,'Dark Green','','colors/006600.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','6600cc','Plum','','colors/6600cc.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','6666cc','Purple','','colors/6666cc.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','9999cc','Light Purple','','colors/9999cc.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','660000' ,'Burgundy','','colors/660000.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','663333' ,'Brown','','colors/663333.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','990000' ,'Red','','colors/990000.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','996633' ,'Tan','','colors/996633.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','999999' ,'Gray','','colors/999999.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','cc66cc','Pink','','colors/cc66cc.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','cc99cc','Bubble Gum','','colors/cc99cc.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','cc3333' ,'Orange','','colors/cc3333.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','cc6666' ,'Peach','','colors/cc6666.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','cc9999' ,'Rose','','colors/cc9999.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','cccc00' ,'Gold','','colors/cccc00.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','ffff33' ,'Yellow','','colors/ffff33.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','ffffcc','Cream','','colors/ffffcc.png'); + insert into authorised_values (category, authorised_value, lib, + lib_opac, imageurl) values ('CCODE','ffffff','White','','colors/ffffff.png'); + +If you would like to choose the colors manually you can do that via the +`Authorized Values <#authorizedvalues>`__ administration area. + +Colors for CCODE +|image1118| + +Next you'll want to `update the frameworks <#marcbibframeworks>`__ so +that the 952$8 (if you're using collection code) label to says Color. + +Once you have that in place you can start to catalog items by color. + +Finally you'll want to add the following JQuery to your preferences so +that it will relabel 'Collection' to 'Color' + +`IntranetUserJS <#intranetuserjs>`__ + +:: + + $(document).ready(function(){ + $("#advsearch-tab-ccode a:contains('Collection')").text("Color"); + $("#holdings th:contains('Collection')").text("Color"); + }); + +`OPACUserJS <#opacuserjs>`__ + +:: + + $(document).ready(function(){ + $("#advsearch-tab-ccode a:contains('Collection')").text("Color"); + $('#item_ccode').text("Color"); + }); + +Koha and Your Website +===================== + +This appendix will include tips for integrating Koha in to your library +website. + +`Koha search on your site <#embedsearch>`__ +------------------------------------------- + +Often you'll want to add a Koha search box to your library website. To +do so, just copy and paste the following code in to your library website +and update the YOURCATALOG bit with your catalog's URL and you're set to +go. + +:: + + +

+ + +

+ + +GNU General Public License version 3 +==================================== + +Version 3, 29 June 2007 + +Copyright © 2007 Free Software Foundation, Inc. http://fsf.org/ + +Everyone is permitted to copy and distribute verbatim copies of this +license document, but changing it is not allowed. + +**Preamble** + +The GNU General Public License is a free, copyleft license for software +and other kinds of works. + +The licenses for most software and other practical works are designed to +take away your freedom to share and change the works. By contrast, the +GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + +When we speak of free software, we are referring to freedom, not price. +Our General Public Licenses are designed to make sure that you have the +freedom to distribute copies of free software (and charge for them if +you wish), that you receive source code or can get it if you want it, +that you can change the software or use pieces of it in new free +programs, and that you know you can do these things. + +To protect your rights, we need to prevent others from denying you these +rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + +For example, if you distribute copies of such a program, whether gratis +or for a fee, you must pass on to the recipients the same freedoms that +you received. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + +Developers that use the GNU GPL protect your rights with two steps: (1) +assert copyright on the software, and (2) offer you this License giving +you legal permission to copy, distribute and/or modify it. + +For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + +Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of protecting +users' freedom to change the software. The systematic pattern of such +abuse occurs in the area of products for individuals to use, which is +precisely where it is most unacceptable. Therefore, we have designed +this version of the GPL to prohibit the practice for those products. If +such problems arise substantially in other domains, we stand ready to +extend this provision to those domains in future versions of the GPL, as +needed to protect the freedom of users. + +Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + +The precise terms and conditions for copying, distribution and +modification follow. + +**TERMS AND CONDITIONS** + +**0. Definitions.** + +"This License" refers to version 3 of the GNU General Public License. + +"Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + +"The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + +To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + +A "covered work" means either the unmodified Program or a work based on +the Program. + +To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + +To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + +An interactive user interface displays "Appropriate Legal Notices" to +the extent that it includes a convenient and prominently visible feature +that (1) displays an appropriate copyright notice, and (2) tells the +user that there is no warranty for the work (except to the extent that +warranties are provided), that licensees may convey the work under this +License, and how to view a copy of this License. If the interface +presents a list of user commands or options, such as a menu, a prominent +item in the list meets this criterion. + +**1. Source Code.** + +The "source code" for a work means the preferred form of the work for +making modifications to it. "Object code" means any non-source form of a +work. + +A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that is +widely used among developers working in that language. + +The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that Major +Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A "Major +Component", in this context, means a major essential component (kernel, +window system, and so on) of the specific operating system (if any) on +which the executable work runs, or a compiler used to produce the work, +or an object code interpreter used to run it. + +The "Corresponding Source" for a work in object code form means all the +source code needed to generate, install, and (for an executable work) +run the object code and to modify the work, including scripts to control +those activities. However, it does not include the work's System +Libraries, or general-purpose tools or generally available free programs +which are used unmodified in performing those activities but which are +not part of the work. For example, Corresponding Source includes +interface definition files associated with source files for the work, +and the source code for shared libraries and dynamically linked +subprograms that the work is specifically designed to require, such as +by intimate data communication or control flow between those subprograms +and other parts of the work. + +The Corresponding Source need not include anything that users can +regenerate automatically from other parts of the Corresponding Source. + +The Corresponding Source for a work in source code form is that same +work. + +**2. Basic Permissions.** + +All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + +You may make, run and propagate covered works that you do not convey, +without conditions so long as your license otherwise remains in force. +You may convey covered works to others for the sole purpose of having +them make modifications exclusively for you, or provide you with +facilities for running those works, provided that you comply with the +terms of this License in conveying all material for which you do not +control copyright. Those thus making or running the covered works for +you must do so exclusively on your behalf, under your direction and +control, on terms that prohibit them from making any copies of your +copyrighted material outside their relationship with you. + +Conveying under any other circumstances is permitted solely under the +conditions stated below. Sublicensing is not allowed; section 10 makes +it unnecessary. + +**3. Protecting Users' Legal Rights From Anti-Circumvention Law.** + +No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article 11 +of the WIPO copyright treaty adopted on 20 December 1996, or similar +laws prohibiting or restricting circumvention of such measures. + +When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to the +covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + +**4. Conveying Verbatim Copies.** + +You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; keep +intact all notices stating that this License and any non-permissive +terms added in accord with section 7 apply to the code; keep intact all +notices of the absence of any warranty; and give all recipients a copy +of this License along with the Program. + +You may charge any price or no price for each copy that you convey, and +you may offer support or warranty protection for a fee. + +**5. Conveying Modified Source Versions.** + +You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the terms +of section 4, provided that you also meet all of these conditions: + +a. The work must carry prominent notices stating that you modified it, + and giving a relevant date. + +b. The work must carry prominent notices stating that it is released + under this License and any conditions added under section 7. This + requirement modifies the requirement in section 4 to "keep intact all + notices". + +c. You must license the entire work, as a whole, under this License to + anyone who comes into possession of a copy. This License will + therefore apply, along with any applicable section 7 additional + terms, to the whole of the work, and all its parts, regardless of how + they are packaged. This License gives no permission to license the + work in any other way, but it does not invalidate such permission if + you have separately received it. + +d. If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your work + need not make them do so. + +A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, and +which are not combined with it such as to form a larger program, in or +on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not used +to limit the access or legal rights of the compilation's users beyond +what the individual works permit. Inclusion of a covered work in an +aggregate does not cause this License to apply to the other parts of the +aggregate. + +**6. Conveying Non-Source Forms.** + +You may convey a covered work in object code form under the terms of +sections 4 and 5, provided that you also convey the machine-readable +Corresponding Source under the terms of this License, in one of these +ways: + +a. Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium customarily + used for software interchange. + +b. Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a written + offer, valid for at least three years and valid for as long as you + offer spare parts or customer support for that product model, to give + anyone who possesses the object code either (1) a copy of the + Corresponding Source for all the software in the product that is + covered by this License, on a durable physical medium customarily + used for software interchange, for a price no more than your + reasonable cost of physically performing this conveying of source, or + (2) access to copy the Corresponding Source from a network server at + no charge. + +c. Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This alternative + is allowed only occasionally and noncommercially, and only if you + received the object code with such an offer, in accord with + subsection 6b. + +d. Convey the object code by offering access from a designated place + (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to copy + the object code is a network server, the Corresponding Source may be + on a different server (operated by you or a third party) that + supports equivalent copying facilities, provided you maintain clear + directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + +e. Convey the object code using peer-to-peer transmission, provided you + inform other peers where the object code and Corresponding Source of + the work are being offered to the general public at no charge under + subsection 6d. + +A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be included +in conveying the object code work. + +A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for +incorporation into a dwelling. In determining whether a product is a +consumer product, doubtful cases shall be resolved in favor of coverage. +For a particular product received by a particular user, "normally used" +refers to a typical or common use of that class of product, regardless +of the status of the particular user or of the way in which the +particular user actually uses, or expects or is expected to use, the +product. A product is a consumer product regardless of whether the +product has substantial commercial, industrial or non-consumer uses, +unless such uses represent the only significant mode of use of the +product. + +"Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product +from a modified version of its Corresponding Source. The information +must suffice to ensure that the continued functioning of the modified +object code is in no case prevented or interfered with solely because +modification has been made. + +If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied by +the Installation Information. But this requirement does not apply if +neither you nor any third party retains the ability to install modified +object code on the User Product (for example, the work has been +installed in ROM). + +The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + +Corresponding Source conveyed, and Installation Information provided, in +accord with this section must be in a format that is publicly documented +(and with an implementation available to the public in source code +form), and must require no special password or key for unpacking, +reading or copying. + +**7. Additional Terms.** + +"Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by this +License without regard to the additional permissions. + +When you convey a copy of a covered work, you may at your option remove +any additional permissions from that copy, or from any part of it. +(Additional permissions may be written to require their own removal in +certain cases when you modify the work.) You may place additional +permissions on material, added by you to a covered work, for which you +have or can give appropriate copyright permission. + +Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders +of that material) supplement the terms of this License with terms: + +a. Disclaiming warranty or limiting liability differently from the terms + of sections 15 and 16 of this License; or + +b. Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + +c. Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + +d. Limiting the use for publicity purposes of names of licensors or + authors of the material; or + +e. Declining to grant rights under trademark law for use of some trade + names, trademarks, or service marks; or + +f. Requiring indemnification of licensors and authors of that material + by anyone who conveys the material (or modified versions of it) with + contractual assumptions of liability to the recipient, for any + liability that these contractual assumptions directly impose on those + licensors and authors. + +All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains a +further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms of +that license document, provided that the further restriction does not +survive such relicensing or conveying. + +If you add terms to a covered work in accord with this section, you must +place, in the relevant source files, a statement of the additional terms +that apply to those files, or a notice indicating where to find the +applicable terms. + +Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; the above +requirements apply either way. + +**8. Termination.** + +You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + +However, if you cease all violation of this License, then your license +from a particular copyright holder is reinstated (a) provisionally, +unless and until the copyright holder explicitly and finally terminates +your license, and (b) permanently, if the copyright holder fails to +notify you of the violation by some reasonable means prior to 60 days +after the cessation. + +Moreover, your license from a particular copyright holder is reinstated +permanently if the copyright holder notifies you of the violation by +some reasonable means, this is the first time you have received notice +of violation of this License (for any work) from that copyright holder, +and you cure the violation prior to 30 days after your receipt of the +notice. + +Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + +**9. Acceptance Not Required for Having Copies.** + +You are not required to accept this License in order to receive or run a +copy of the Program. Ancillary propagation of a covered work occurring +solely as a consequence of using peer-to-peer transmission to receive a +copy likewise does not require acceptance. However, nothing other than +this License grants you permission to propagate or modify any covered +work. These actions infringe copyright if you do not accept this +License. Therefore, by modifying or propagating a covered work, you +indicate your acceptance of this License to do so. + +**10. Automatic Licensing of Downstream Recipients.** + +Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + +An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered work +results from an entity transaction, each party to that transaction who +receives a copy of the work also receives whatever licenses to the work +the party's predecessor in interest had or could give under the previous +paragraph, plus a right to possession of the Corresponding Source of the +work from the predecessor in interest, if the predecessor has it or can +get it with reasonable efforts. + +You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may not +impose a license fee, royalty, or other charge for exercise of rights +granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that any +patent claim is infringed by making, using, selling, offering for sale, +or importing the Program or any portion of it. + +**11. Patents.** + +A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The work +thus licensed is called the contributor's "contributor version". + +A contributor's "essential patent claims" are all patent claims owned or +controlled by the contributor, whether already acquired or hereafter +acquired, that would be infringed by some manner, permitted by this +License, of making, using, or selling its contributor version, but do +not include claims that would be infringed only as a consequence of +further modification of the contributor version. For purposes of this +definition, "control" includes the right to grant patent sublicenses in +a manner consistent with the requirements of this License. + +Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to make, +use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + +In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + +If you convey a covered work, knowingly relying on a patent license, and +the Corresponding Source of the work is not available for anyone to +copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + +If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify or +convey a specific copy of the covered work, then the patent license you +grant is automatically extended to all recipients of the covered work +and works based on it. + +A patent license is "discriminatory" if it does not include within the +scope of its coverage, prohibits the exercise of, or is conditioned on +the non-exercise of one or more of the rights that are specifically +granted under this License. You may not convey a covered work if you are +a party to an arrangement with a third party that is in the business of +distributing software, under which you make payment to the third party +based on the extent of your activity of conveying the work, and under +which the third party grants, to any of the parties who would receive +the covered work from you, a discriminatory patent license (a) in +connection with copies of the covered work conveyed by you (or copies +made from those copies), or (b) primarily for and in connection with +specific products or compilations that contain the covered work, unless +you entered into that arrangement, or that patent license was granted, +prior to 28 March 2007. + +Nothing in this License shall be construed as excluding or limiting any +implied license or other defenses to infringement that may otherwise be +available to you under applicable patent law. + +**12. No Surrender of Others' Freedom.** + +If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not convey it at all. For example, if you agree to terms that +obligate you to collect a royalty for further conveying from those to +whom you convey the Program, the only way you could satisfy both those +terms and this License would be to refrain entirely from conveying the +Program. + +**13. Use with the GNU Affero General Public License.** + +Notwithstanding any other provision of this License, you have permission +to link or combine any covered work with a work licensed under version 3 +of the GNU Affero General Public License into a single combined work, +and to convey the resulting work. The terms of this License will +continue to apply to the part which is the covered work, but the special +requirements of the GNU Affero General Public License, section 13, +concerning interaction through a network will apply to the combination +as such. + +**14. Revised Versions of this License.** + +The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies that a certain numbered version of the GNU General Public +License "or any later version" applies to it, you have the option of +following the terms and conditions either of that numbered version or of +any later version published by the Free Software Foundation. If the +Program does not specify a version number of the GNU General Public +License, you may choose any version ever published by the Free Software +Foundation. + +If the Program specifies that a proxy can decide which future versions +of the GNU General Public License can be used, that proxy's public +statement of acceptance of a version permanently authorizes you to +choose that version for the Program. + +Later license versions may give you additional or different permissions. +However, no additional obligations are imposed on any author or +copyright holder as a result of your choosing to follow a later version. + +**15. Disclaimer of Warranty.** + +THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT +WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A +PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF +THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME +THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + +**16. Limitation of Liability.** + +IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR +CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES +ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT +NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES +SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE +WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN +ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. + +**17. Interpretation of Sections 15 and 16.** + +If the disclaimer of warranty and limitation of liability provided above +cannot be given local legal effect according to their terms, reviewing +courts shall apply local law that most closely approximates an absolute +waiver of all civil liability in connection with the Program, unless a +warranty or assumption of liability accompanies a copy of the Program in +return for a fee. + +**END OF TERMS AND CONDITIONS** + +**How to Apply These Terms to Your New Programs** + +If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these +terms. + +To do so, attach the following notices to the program. It is safest to +attach them to the start of each source file to most effectively state +the exclusion of warranty; and each file should have at least the +"copyright" line and a pointer to where the full notice is found. + +:: + + one line to give the program's name and a brief idea of what it does. + Copyright (C) year name of author + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see http://www.gnu.org/licenses/. + + +Also add information on how to contact you by electronic and paper mail. + +If the program does terminal interaction, make it output a short notice +like this when it starts in an interactive mode: + +:: + + program Copyright (C) year name of author + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + + +The hypothetical commands \`\ ``show w``' and \`\ ``show c``' should +show the appropriate parts of the General Public License. Of course, +your program's commands might be different; for a GUI interface, you +would use an "about box". + +You should also get your employer (if you work as a programmer) or +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. For more information on this, and how to apply and follow the +GNU GPL, see http://www.gnu.org/licenses/. + +The GNU General Public License does not permit incorporating your +program into proprietary programs. If your program is a subroutine +library, you may consider it more useful to permit linking proprietary +applications with the library. If this is what you want to do, use the +GNU Lesser General Public License instead of this License. But first, +please read http://www.gnu.org/philosophy/why-not-lgpl.html. diff --git a/en/source/19_license.rst b/en/source/19_license.rst new file mode 100644 index 0000000..08b5550 --- /dev/null +++ b/en/source/19_license.rst @@ -0,0 +1,683 @@ +GNU General Public License version 3 +==================================== + +Version 3, 29 June 2007 + +Copyright © 2007 Free Software Foundation, Inc. http://fsf.org/ + +Everyone is permitted to copy and distribute verbatim copies of this +license document, but changing it is not allowed. + +**Preamble** + +The GNU General Public License is a free, copyleft license for software +and other kinds of works. + +The licenses for most software and other practical works are designed to +take away your freedom to share and change the works. By contrast, the +GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + +When we speak of free software, we are referring to freedom, not price. +Our General Public Licenses are designed to make sure that you have the +freedom to distribute copies of free software (and charge for them if +you wish), that you receive source code or can get it if you want it, +that you can change the software or use pieces of it in new free +programs, and that you know you can do these things. + +To protect your rights, we need to prevent others from denying you these +rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + +For example, if you distribute copies of such a program, whether gratis +or for a fee, you must pass on to the recipients the same freedoms that +you received. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + +Developers that use the GNU GPL protect your rights with two steps: (1) +assert copyright on the software, and (2) offer you this License giving +you legal permission to copy, distribute and/or modify it. + +For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + +Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of protecting +users' freedom to change the software. The systematic pattern of such +abuse occurs in the area of products for individuals to use, which is +precisely where it is most unacceptable. Therefore, we have designed +this version of the GPL to prohibit the practice for those products. If +such problems arise substantially in other domains, we stand ready to +extend this provision to those domains in future versions of the GPL, as +needed to protect the freedom of users. + +Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + +The precise terms and conditions for copying, distribution and +modification follow. + +**TERMS AND CONDITIONS** + +**0. Definitions.** + +"This License" refers to version 3 of the GNU General Public License. + +"Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + +"The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + +To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + +A "covered work" means either the unmodified Program or a work based on +the Program. + +To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + +To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + +An interactive user interface displays "Appropriate Legal Notices" to +the extent that it includes a convenient and prominently visible feature +that (1) displays an appropriate copyright notice, and (2) tells the +user that there is no warranty for the work (except to the extent that +warranties are provided), that licensees may convey the work under this +License, and how to view a copy of this License. If the interface +presents a list of user commands or options, such as a menu, a prominent +item in the list meets this criterion. + +**1. Source Code.** + +The "source code" for a work means the preferred form of the work for +making modifications to it. "Object code" means any non-source form of a +work. + +A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that is +widely used among developers working in that language. + +The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that Major +Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A "Major +Component", in this context, means a major essential component (kernel, +window system, and so on) of the specific operating system (if any) on +which the executable work runs, or a compiler used to produce the work, +or an object code interpreter used to run it. + +The "Corresponding Source" for a work in object code form means all the +source code needed to generate, install, and (for an executable work) +run the object code and to modify the work, including scripts to control +those activities. However, it does not include the work's System +Libraries, or general-purpose tools or generally available free programs +which are used unmodified in performing those activities but which are +not part of the work. For example, Corresponding Source includes +interface definition files associated with source files for the work, +and the source code for shared libraries and dynamically linked +subprograms that the work is specifically designed to require, such as +by intimate data communication or control flow between those subprograms +and other parts of the work. + +The Corresponding Source need not include anything that users can +regenerate automatically from other parts of the Corresponding Source. + +The Corresponding Source for a work in source code form is that same +work. + +**2. Basic Permissions.** + +All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + +You may make, run and propagate covered works that you do not convey, +without conditions so long as your license otherwise remains in force. +You may convey covered works to others for the sole purpose of having +them make modifications exclusively for you, or provide you with +facilities for running those works, provided that you comply with the +terms of this License in conveying all material for which you do not +control copyright. Those thus making or running the covered works for +you must do so exclusively on your behalf, under your direction and +control, on terms that prohibit them from making any copies of your +copyrighted material outside their relationship with you. + +Conveying under any other circumstances is permitted solely under the +conditions stated below. Sublicensing is not allowed; section 10 makes +it unnecessary. + +**3. Protecting Users' Legal Rights From Anti-Circumvention Law.** + +No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article 11 +of the WIPO copyright treaty adopted on 20 December 1996, or similar +laws prohibiting or restricting circumvention of such measures. + +When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to the +covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + +**4. Conveying Verbatim Copies.** + +You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; keep +intact all notices stating that this License and any non-permissive +terms added in accord with section 7 apply to the code; keep intact all +notices of the absence of any warranty; and give all recipients a copy +of this License along with the Program. + +You may charge any price or no price for each copy that you convey, and +you may offer support or warranty protection for a fee. + +**5. Conveying Modified Source Versions.** + +You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the terms +of section 4, provided that you also meet all of these conditions: + +a. The work must carry prominent notices stating that you modified it, + and giving a relevant date. + +b. The work must carry prominent notices stating that it is released + under this License and any conditions added under section 7. This + requirement modifies the requirement in section 4 to "keep intact all + notices". + +c. You must license the entire work, as a whole, under this License to + anyone who comes into possession of a copy. This License will + therefore apply, along with any applicable section 7 additional + terms, to the whole of the work, and all its parts, regardless of how + they are packaged. This License gives no permission to license the + work in any other way, but it does not invalidate such permission if + you have separately received it. + +d. If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your work + need not make them do so. + +A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, and +which are not combined with it such as to form a larger program, in or +on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not used +to limit the access or legal rights of the compilation's users beyond +what the individual works permit. Inclusion of a covered work in an +aggregate does not cause this License to apply to the other parts of the +aggregate. + +**6. Conveying Non-Source Forms.** + +You may convey a covered work in object code form under the terms of +sections 4 and 5, provided that you also convey the machine-readable +Corresponding Source under the terms of this License, in one of these +ways: + +a. Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium customarily + used for software interchange. + +b. Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a written + offer, valid for at least three years and valid for as long as you + offer spare parts or customer support for that product model, to give + anyone who possesses the object code either (1) a copy of the + Corresponding Source for all the software in the product that is + covered by this License, on a durable physical medium customarily + used for software interchange, for a price no more than your + reasonable cost of physically performing this conveying of source, or + (2) access to copy the Corresponding Source from a network server at + no charge. + +c. Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This alternative + is allowed only occasionally and noncommercially, and only if you + received the object code with such an offer, in accord with + subsection 6b. + +d. Convey the object code by offering access from a designated place + (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to copy + the object code is a network server, the Corresponding Source may be + on a different server (operated by you or a third party) that + supports equivalent copying facilities, provided you maintain clear + directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + +e. Convey the object code using peer-to-peer transmission, provided you + inform other peers where the object code and Corresponding Source of + the work are being offered to the general public at no charge under + subsection 6d. + +A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be included +in conveying the object code work. + +A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for +incorporation into a dwelling. In determining whether a product is a +consumer product, doubtful cases shall be resolved in favor of coverage. +For a particular product received by a particular user, "normally used" +refers to a typical or common use of that class of product, regardless +of the status of the particular user or of the way in which the +particular user actually uses, or expects or is expected to use, the +product. A product is a consumer product regardless of whether the +product has substantial commercial, industrial or non-consumer uses, +unless such uses represent the only significant mode of use of the +product. + +"Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product +from a modified version of its Corresponding Source. The information +must suffice to ensure that the continued functioning of the modified +object code is in no case prevented or interfered with solely because +modification has been made. + +If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied by +the Installation Information. But this requirement does not apply if +neither you nor any third party retains the ability to install modified +object code on the User Product (for example, the work has been +installed in ROM). + +The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + +Corresponding Source conveyed, and Installation Information provided, in +accord with this section must be in a format that is publicly documented +(and with an implementation available to the public in source code +form), and must require no special password or key for unpacking, +reading or copying. + +**7. Additional Terms.** + +"Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by this +License without regard to the additional permissions. + +When you convey a copy of a covered work, you may at your option remove +any additional permissions from that copy, or from any part of it. +(Additional permissions may be written to require their own removal in +certain cases when you modify the work.) You may place additional +permissions on material, added by you to a covered work, for which you +have or can give appropriate copyright permission. + +Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders +of that material) supplement the terms of this License with terms: + +a. Disclaiming warranty or limiting liability differently from the terms + of sections 15 and 16 of this License; or + +b. Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + +c. Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + +d. Limiting the use for publicity purposes of names of licensors or + authors of the material; or + +e. Declining to grant rights under trademark law for use of some trade + names, trademarks, or service marks; or + +f. Requiring indemnification of licensors and authors of that material + by anyone who conveys the material (or modified versions of it) with + contractual assumptions of liability to the recipient, for any + liability that these contractual assumptions directly impose on those + licensors and authors. + +All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains a +further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms of +that license document, provided that the further restriction does not +survive such relicensing or conveying. + +If you add terms to a covered work in accord with this section, you must +place, in the relevant source files, a statement of the additional terms +that apply to those files, or a notice indicating where to find the +applicable terms. + +Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; the above +requirements apply either way. + +**8. Termination.** + +You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + +However, if you cease all violation of this License, then your license +from a particular copyright holder is reinstated (a) provisionally, +unless and until the copyright holder explicitly and finally terminates +your license, and (b) permanently, if the copyright holder fails to +notify you of the violation by some reasonable means prior to 60 days +after the cessation. + +Moreover, your license from a particular copyright holder is reinstated +permanently if the copyright holder notifies you of the violation by +some reasonable means, this is the first time you have received notice +of violation of this License (for any work) from that copyright holder, +and you cure the violation prior to 30 days after your receipt of the +notice. + +Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + +**9. Acceptance Not Required for Having Copies.** + +You are not required to accept this License in order to receive or run a +copy of the Program. Ancillary propagation of a covered work occurring +solely as a consequence of using peer-to-peer transmission to receive a +copy likewise does not require acceptance. However, nothing other than +this License grants you permission to propagate or modify any covered +work. These actions infringe copyright if you do not accept this +License. Therefore, by modifying or propagating a covered work, you +indicate your acceptance of this License to do so. + +**10. Automatic Licensing of Downstream Recipients.** + +Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + +An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered work +results from an entity transaction, each party to that transaction who +receives a copy of the work also receives whatever licenses to the work +the party's predecessor in interest had or could give under the previous +paragraph, plus a right to possession of the Corresponding Source of the +work from the predecessor in interest, if the predecessor has it or can +get it with reasonable efforts. + +You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may not +impose a license fee, royalty, or other charge for exercise of rights +granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that any +patent claim is infringed by making, using, selling, offering for sale, +or importing the Program or any portion of it. + +**11. Patents.** + +A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The work +thus licensed is called the contributor's "contributor version". + +A contributor's "essential patent claims" are all patent claims owned or +controlled by the contributor, whether already acquired or hereafter +acquired, that would be infringed by some manner, permitted by this +License, of making, using, or selling its contributor version, but do +not include claims that would be infringed only as a consequence of +further modification of the contributor version. For purposes of this +definition, "control" includes the right to grant patent sublicenses in +a manner consistent with the requirements of this License. + +Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to make, +use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + +In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + +If you convey a covered work, knowingly relying on a patent license, and +the Corresponding Source of the work is not available for anyone to +copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + +If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify or +convey a specific copy of the covered work, then the patent license you +grant is automatically extended to all recipients of the covered work +and works based on it. + +A patent license is "discriminatory" if it does not include within the +scope of its coverage, prohibits the exercise of, or is conditioned on +the non-exercise of one or more of the rights that are specifically +granted under this License. You may not convey a covered work if you are +a party to an arrangement with a third party that is in the business of +distributing software, under which you make payment to the third party +based on the extent of your activity of conveying the work, and under +which the third party grants, to any of the parties who would receive +the covered work from you, a discriminatory patent license (a) in +connection with copies of the covered work conveyed by you (or copies +made from those copies), or (b) primarily for and in connection with +specific products or compilations that contain the covered work, unless +you entered into that arrangement, or that patent license was granted, +prior to 28 March 2007. + +Nothing in this License shall be construed as excluding or limiting any +implied license or other defenses to infringement that may otherwise be +available to you under applicable patent law. + +**12. No Surrender of Others' Freedom.** + +If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not convey it at all. For example, if you agree to terms that +obligate you to collect a royalty for further conveying from those to +whom you convey the Program, the only way you could satisfy both those +terms and this License would be to refrain entirely from conveying the +Program. + +**13. Use with the GNU Affero General Public License.** + +Notwithstanding any other provision of this License, you have permission +to link or combine any covered work with a work licensed under version 3 +of the GNU Affero General Public License into a single combined work, +and to convey the resulting work. The terms of this License will +continue to apply to the part which is the covered work, but the special +requirements of the GNU Affero General Public License, section 13, +concerning interaction through a network will apply to the combination +as such. + +**14. Revised Versions of this License.** + +The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies that a certain numbered version of the GNU General Public +License "or any later version" applies to it, you have the option of +following the terms and conditions either of that numbered version or of +any later version published by the Free Software Foundation. If the +Program does not specify a version number of the GNU General Public +License, you may choose any version ever published by the Free Software +Foundation. + +If the Program specifies that a proxy can decide which future versions +of the GNU General Public License can be used, that proxy's public +statement of acceptance of a version permanently authorizes you to +choose that version for the Program. + +Later license versions may give you additional or different permissions. +However, no additional obligations are imposed on any author or +copyright holder as a result of your choosing to follow a later version. + +**15. Disclaimer of Warranty.** + +THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT +WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A +PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF +THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME +THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + +**16. Limitation of Liability.** + +IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR +CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES +ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT +NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES +SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE +WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN +ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. + +**17. Interpretation of Sections 15 and 16.** + +If the disclaimer of warranty and limitation of liability provided above +cannot be given local legal effect according to their terms, reviewing +courts shall apply local law that most closely approximates an absolute +waiver of all civil liability in connection with the Program, unless a +warranty or assumption of liability accompanies a copy of the Program in +return for a fee. + +**END OF TERMS AND CONDITIONS** + +**How to Apply These Terms to Your New Programs** + +If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these +terms. + +To do so, attach the following notices to the program. It is safest to +attach them to the start of each source file to most effectively state +the exclusion of warranty; and each file should have at least the +"copyright" line and a pointer to where the full notice is found. + +:: + + one line to give the program's name and a brief idea of what it does. + Copyright (C) year name of author + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see http://www.gnu.org/licenses/. + + +Also add information on how to contact you by electronic and paper mail. + +If the program does terminal interaction, make it output a short notice +like this when it starts in an interactive mode: + +:: + + program Copyright (C) year name of author + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + + +The hypothetical commands \`\ ``show w``' and \`\ ``show c``' should +show the appropriate parts of the General Public License. Of course, +your program's commands might be different; for a GUI interface, you +would use an "about box". + +You should also get your employer (if you work as a programmer) or +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. For more information on this, and how to apply and follow the +GNU GPL, see http://www.gnu.org/licenses/. + +The GNU General Public License does not permit incorporating your +program into proprietary programs. If your program is a subroutine +library, you may consider it more useful to permit linking proprietary +applications with the library. If this is what you want to do, use the +GNU Lesser General Public License instead of this License. But first, +please read http://www.gnu.org/philosophy/why-not-lgpl.html. diff --git a/en/source/index.rst b/en/source/index.rst index 9ea369e..f90f66c 100644 --- a/en/source/index.rst +++ b/en/source/index.rst @@ -21,4 +21,9 @@ Koha 16.11 Manual (en) 11_reports 12_opac 13_searching - manual + 14_plugins + 15_implementation_checklist + 16_sopac + 17_cron_jobs + 18_miscellaneous + 19_license diff --git a/en/source/manual.rst b/en/source/manual.rst deleted file mode 100644 index 0ac083b..0000000 --- a/en/source/manual.rst +++ /dev/null @@ -1,8500 +0,0 @@ - -Plugin System -============= - -Koha's Plugin System allows for you to add additional tools and reports -to Koha that are specific to your library. Plugins are installed by -uploading KPZ ( Koha Plugin Zip ) packages. A KPZ file is just a zip -file containing the perl files, template files, and any other files -necessary to make the plugin work. - -The plugin system needs to be turned on by a system administrator. - -`Set up <#pluginsetup>`__ -------------------------- - -To set up the Koha plugin system you must first make some changes to -your install. - -- Change 0 to - 1 in your koha-conf.xml file - -- Restart your webserver - -Once set up is complete you will need to alter your -`UseKohaPlugins <#UseKohaPlugins>`__ system preference. On the Tools -page you will see the Tools Plugins and on the Reports page you will see -the Reports Plugins. - -Search History -============== - -If you have your `EnableSearchHistory <#EnableSearchHistory>`__ -preference set to keep your search history then you can access this -information by clicking on your username in the top right of the staff -client and choosing 'Search history'. - -Search history -|image1062| - -From this page you will see your bibliographic search history - -Bibliographic search history -|image1063| - -And your authority search history. - -Authority search history -|image1064| - -About Koha -========== - -The 'About Koha' area will give you important server information as well -as general information about Koha. - -- *Get there:* More > About Koha - -`Server Information <#aboutserver>`__ -------------------------------------- - -Under the 'Server Information' tab you will find information about the -Koha version and the machine you have installed Koha on. This -information is very important for debugging problems. When reporting -issues to your support provider or to the various other support avenues -(mailing lists, chat room, etc), it's always good to give the -information from this screen. - -Server Information on Koha -|image1065| - -`Perl Modules <#aboutserverperl>`__ ------------------------------------ - -In order to take advantage of all of the functionalities of Koha, you -will need to keep your Perl modules up to date. The 'Perl Modules' tab -will show you all of the modules required by Koha, the version you have -installed and whether you need to upgrade certain modules. - -Perl Modules -|image1066| - -Items listed in bold are required by Koha, items highlighed in red are -missing completely and items highlighted in yellow simply need to be -upgraded. - -`System Information <#aboutsystem>`__ -------------------------------------- - -This tab will provide you with warnings if you are using system -preferences that have since been deprecated or system preferences that -you have set without other required preferences - -System Information -|image1067| - -Implementation Checklist -======================== - -The following guide will walk you through the areas of Koha you need to -look at in order to prepare to start using the system. - -`Data Migration <#imp-migration>`__ ------------------------------------ - -Before you can start using Koha you'll need to have some data. This can -be done by entering it all by hand, but most people already have their -data in electronic format of some sort and just need to reformat it a -bit for importing into Koha. - -- Create a list of libraries and enter their info and codes into - `Libraries & Groups <#libsgroups>`__ - -- Define your list of `Item Types <#itemtypeadmin>`__ - -- Define your patron categories and enter the categories and their - codes into `Patron Categories <#patcats>`__ - -- Enter any additional patron information fields you use in your - library in the `Patron Attributes <#patronattributetypes>`__ - - - Requires that you first set the - `ExtendedPatronAttributes <#ExtendedPatronAttributes>`__ system - preference if you have custom fields - -- Define all of your `Authorized Values <#authorizedvalues>`__ - - - `Collection codes <#ccode>`__ - - - `Shelving locations <#shelvelocvals>`__ - - - Item statuses (`lost <#lost>`__, `not for loan <#notforloan>`__, - `damaged <#damageauth>`__, `withdrawn <#withdrawnauth>`__) - - - Plus any others that are needed in your library - -- Optionally define `City/State/Postal Code <#citytowns>`__ combos - -- `Map your bibliographic data <#kohamarcmapping>`__ from your legacy - system to Koha fields and migrate (remembering to use the collection, - shelving, item type and library codes you entered in the above - setting areas) - -- `Map your patron data <#patronimport>`__ from your legacy system to - the Koha fields and migrate (remembering to use the patron and - library codes you defined above) - -- Test your migrated data to be sure that everything is as you expect - it to be, some things to test include: - - - Check some of your titles with diacritics and make sure that they - migrated properly. - - - Check titles in a series and make sure that series information - migrated properly. - - - Make sure that your patrons have their contact information in the - right fields. - - - If your serials data was migrated search for these records in the - catalog and confirm that they look right. - - - If your serials data was migrated search for these records in the - serials module and confirm that they look right. - - - Check marc records to verify a variety of items are cataloged - correctly - - - Check cataloging process to see if all necessary fields are - available - - - If fines are migrated, check to see that they are applied - correctly - - - If holds are migrated, check to see they are accurate in catalog - and patron record - -`Admin Configuration <#impadmin>`__ ------------------------------------ - -Most of these preferences won't need to be changed to use your Koha -system, but there are a few that you might want to customize. - -- If your library uses CAS Authentication, you'll want to set the - various `CAS system preferences <#casauthentication>`__ - -- Administration System Preferences - - - `KohaAdminEmailAddress <#KohaAdminEmailAddress>`__ : This is the - email address that will be used by the system in 'from' lines and - to send errors to if there is no email set for the branch - - - `noItemTypeImages <#noItemTypeImages>`__ : Decide if you want to - show item type icons in the staff client and opac - - - `delimiter <#delimiter>`__ : This value will be put in between - fields when exporting data from Koha - - - `virtualshelves <#virtualshelves>`__ : Decide if you want the - staff and/or patrons to use lists in Koha - - - `AutoLocation <#AutoLocation>`__ : Require staff to log in to the - staff client from a specific IP range - - - `IndependentBranches <#IndependentBranches>`__ : Prevent - librarians from editing content that belongs to other branches - -- Go through the `Log System Preferences <#logs>`__ and decide which - actions you want to keep track of in the logs - -- Decide if you'd like to share your library's information with the - Koha community by setting the `Sharing system - preferences <#heaprefs>`__. - -- Decide what `cron jobs <#cronjobsch>`__ you need to run and when. - - - If you're using the long overdue cron job be sure to set your - `DefaultLongOverdueChargeValue <#DefaultLongOverdueChargeValue>`__, - `DefaultLongOverdueLostValue <#DefaultLongOverdueLostValue>`__ & - `DefaultLongOverdueDays <#DefaultLongOverdueLostValue>`__ - preferences. - -`Localization Configuration <#implocal>`__ ------------------------------------------- - -Koha is used worldwide and so you need to make sure you set your -localization preferences so that options throughout Koha appear properly -for your location/language. - -- Localization/Internationalization System Preferences - - - `dateformat <#dateformat>`__ : Decide how dates are displayed - throughout Koha - - - `opaclanguagesdisplay <#opaclanguagesdisplay>`__ : Decide if - patrons can choose what language the OPAC appears in - - - `opaclanguages <#opaclanguages>`__ : Decide which languages the - patrons can choose from - - - `language <#languagepref>`__ : Decide which languages appear in - the staff client - - - `CalendarFirstDayOfWeek <#CalendarFirstDayOfWeek>`__ : Define your - first day of the week - -`Circulation Configuration <#impcirc>`__ ----------------------------------------- - -Before you start circulating your collection you'll need to set up your -rules and preferences for circulation. - -- Define your `Circulation/Fine rules <#circfinerules>`__ - -- Enter the `days your library is closed <#calholidays>`__ for fines - and due date calculations - -- Circulation System Preferences - - - `CircControl <#CircControl>`__ : Define whether circ rules are - based on item's location, patron's location or transaction - location - - - `useDaysMode <#useDaysMode>`__ : Define how due dates are - calculated - - - `finesCalendar <#finesCalendar>`__ : Define how fines are - calculated (for every late date or only for days the library is - open) - - - `SpecifyDueDate <#SpecifyDueDate>`__ : Decide if staff are allowed - to override due dates on checkout - - - `SpecifyReturnDate <#SpecifyReturnDate>`__ : Decide if you want to - let the staff specify an arbitrary return date on checkin - - - `itemBarcodeFallbackSearch <#itemBarcodeFallbackSearch>`__ : - Decide if you want staff to be able to checkout using a keyword - search (title, call number, etc) - - - `AutomaticItemReturn <#AutomaticItemReturn>`__ : Decide if items - are sent back to the owning branch when checked in - - - `todaysIssuesDefaultSortOrder <#todaysIssuesDefaultSortOrder>`__ : - Decide how items checked out today display on the patron record - - - `previousIssuesDefaultSortOrder <#previousIssuesDefaultSortOrder>`__ - : Decide how items checked out prior to today display on the - patron record - - - `noissuescharge <#noissuescharge>`__ : Define the maximum amount a - patron can owe before checkouts are blocked - - - `ReturnBeforeExpiry <#ReturnBeforeExpiry>`__ : Decide if patrons - need to return items before their accounts expire - - - `AllowHoldsOnDamagedItems <#AllowHoldsOnDamagedItems>`__ : Decide - if patrons can place holds on items that are marked as damaged - - - `AllowHoldPolicyOverride <#AllowHoldPolicyOverride>`__ : Decide - if you want the staff to be able to override the setting for - the above at checkout - - - `maxreserves <#maxreserves>`__ : Decide how many items a patron - can have on hold at once - - - `AllowHoldPolicyOverride <#AllowHoldPolicyOverride>`__ : Decide - if you want the staff to be able to override the setting for - the above at checkout - - - `maxoutstanding <#maxoutstanding>`__ : Define the maximum amount a - patron can owe before holds are blocked - - - `AllowHoldPolicyOverride <#AllowHoldPolicyOverride>`__ : Decide - if you want the staff to be able to override the setting for - the above at checkout - - - `ReservesMaxPickUpDelay <#ReservesMaxPickUpDelay>`__ : Define the - number of days before a hold expires - - - `WebBasedSelfCheck <#WebBasedSelfCheck>`__ : Decide if you want to - use the built in web-based self-checkout system - - - `AutoSelfCheckAllowed <#AutoSelfCheckAllowed>`__ : Decide if - the self-checkout system requires login - - - `ShowPatronImageInWebBasedSelfCheck <#ShowPatronImageInWebBasedSelfCheck>`__ - : Decide if you want patron images to show on the self checkout - screen - - - `AllowNotForLoanOverride <#AllowNotForLoanOverride>`__ : Decide if - you want the staff to be able to checkout items marked as 'not for - loan' - - - `AllowRenewalLimitOverride <#AllowRenewalLimitOverride>`__ : - Decide if you want staff to override the limit put on renewals - - - `AllowFineOverride <#AllowFineOverride>`__ : Decide if you want - staff to be able to override fine limits - - - `AllowTooManyOverride <#AllowTooManyOverride>`__ : Descide if you - want staff to be able to check out more than the limit to a patron - - - `RenewalPeriodBase <#RenewalPeriodBase>`__ : Decide what date - renewals are based on - - - `finesMode <#finesMode>`__ : Switch to 'Calculate and Charge' - before go live if you charge fines - - - `OverdueNoticeBcc <#OverdueNoticeBcc>`__ : If you want to receive - a copy of every overdue notice sent out, enter your email address - here - - - `emailLibrarianWhenHoldIsPlaced <#emailLibrarianWhenHoldIsPlaced>`__ - : Decide if you want an email every time a hold is placed - - - `ReservesControlBranch <#ReservesControlBranch>`__ : Decide which - branch's hold rules are considered first - - - `soundon <#AudioAlerts>`__ : Decide if you want to have sounds on - for circulation actions - - - `FilterBeforeOverdueReport <#FilterBeforeOverdueReport>`__ : If - you have a large amount of overdues, you might want to turn this - preference on so as to allow you to filter before results appear - - - `DisplayClearScreenButton <#DisplayClearScreenButton>`__ : If you - have a lot of staff members sharing one circ computer you might - want to enable this so that staff can clear the screen in between - checkouts to protect patron's privacy - - - `CircAutoPrintQuickSlip <#CircAutoPrintQuickSlip>`__ : Decide how - you want Koha to react if you scan in a blank barcode on the - checkout screen - - - `SuspendHoldsIntranet <#SuspendHoldsIntranet>`__ and/or - `SuspendHoldsOpac <#SuspendHoldsOpac>`__ : Decide if you want - patrons and/or staff to be able to suspend holds - - - `AutoResumeSuspendedHolds <#AutoResumeSuspendedHolds>`__ : If - you allow holds to be suspended decide if you want them to - automatically resume on the date entered by the staff and/or - patron - - - `OnSiteCheckouts <#OnSiteCheckouts>`__ : Decide if you want to - allow items to be checked out for use within the library - - - `RecordLocalUseOnReturn <#RecordLocalUseOnReturn>`__ : Set this to - record local use of items when you check them in - -- Customize your `Notices & Slips <#notices>`__ - -- Define your `Overdue Notice Triggers <#noticetriggers>`__ - -- Set up your `cron jobs <#cronjobs>`__ - - - Populate `your holds queue <#buildholdscron>`__ (every 1-4 hours) - - - Decide `when holds expire <#expiredholdscron>`__ (daily) - - - `Calculate fines due <#finescronjob>`__ (daily) - - - Fines on hourly loans will calculate when you check the items - in - - - `Mark long overdue items as lost <#longoverduecron>`__ (daily) - - - Decide when the system `sends out messages <#msgqueuecron>`__ (1-4 - hours) - - - Decide when the system `queues overdue - notices <#overduenoticecron>`__ (daily) - - - Set up `hold notices that didn't send for - printing <#printholdcron>`__ (daily after overdues and message - queue) - - - Decide when the system `queues the advanced notice of items - due <#advnoticecron>`__ (daily) - - - Find holds that need to be `resumed and remove - suspension <#unsuspendholdcron>`__ (daily) - - - If you're allowing automatic renewal of items `set them to - renew <#autorenewcron>`__ (nightly) - -`Patron Configuration <#imppratrons>`__ ---------------------------------------- - -You have already imported patron data from your old system, but there -are plenty of options available to you regarding patrons and their -accounts. - -- Enter your `staff members as patrons <#addstaffpatron>`__ - - - Define `staff members access permissions <#patronpermissions>`__ - -- Patron System Preferences - - - `autoMemberNum <#autoMemberNum>`__ : Decide if the patrons - barcodes are auto-generated or if you enter them yourself - - - `MaxFine <#MaxFine>`__ : Determine the maximum amount that people - can owe in fines - - - `NotifyBorrowerDeparture <#NotifyBorrowerDeparture>`__ : Decide - when to warn staff that the patron account is about to expire - - - `intranetreadinghistory <#intranetreadinghistory>`__ : Decide if - the staff can see the patron's reading/checkout history - - - `BorrowerMandatoryField <#BorrowerMandatoryField>`__ : List fields - that you want to appear as mandatory on the patron add/edit form - - - `BorrowersTitles <#BorrowersTitles>`__ : Add or change the titles - for your patrons - - - `borrowerRelationship <#borrowerRelationship>`__ : Add or change - borrower relationships (child to adult and professional to - organization) - - - `AutoEmailPrimaryAddress <#AutoEmailPrimaryAddress>`__ : Determine - if the patrons get an email confirming the creation of their - account - - - `EnhancedMessagingPreferences <#EnhancedMessagingPreferences>`__ : - Decide if staff can choose from a series of notices (other than - overdues) for patrons - - - `EnhancedMessagingPreferencesOPAC <#EnhancedMessagingPreferencesOPAC>`__: - Decide if patrons can choose from a series of notices (other than - ovedues) for themselves - - - `patronimages <#patronimages>`__ : Decide if you want to save - patron images in your system - - - `ExtendedPatronAttributes <#ExtendedPatronAttributes>`__ : Decide - if you want to enable custom patron fields - - - `minPasswordLength <#minPasswordLength>`__ : Enter the minimum - number of characters you want passwords to have - - - `BorrowerUnwantedField <#BorrowerUnwantedField>`__ : Decide what - fields your library doesn't need to see on the patron entry form - -- Set up your `cron jobs <#cronjobs>`__ - - - Decide if you would like `children to automatically be come - adults <#j2acron>`__ - -`Cataloging Configuration <#impcatalog>`__ ------------------------------------------- - -Before you start cataloging in Koha you'll want to set up your -preferences and other rules. - -- Define your cataloging templates aka `MARC Bibliographic - Frameworks <#marcbibframeworks>`__ - - - Run the `MARC Bibliographic Framework - Test <#marcbibframeworkstest>`__ to be sure your changes are valid - -- Define any `authorized values <#authorizedvalues>`__ you might want - to use in cataloging - -- Set up `custom classification sources <#classificationsources>`__ (if - you use something other than the defaults) - -- Set up `MARC matching rules <#recordmatchingrules>`__ for importing - records from mrc files or Z39.50 - -- Set up `Koha to Keyword mapping <#keywordmapping>`__ for deciding how - to display marc fields to the screen (still in beta - only one field) - -- Set up the `Z39.50 targets <#z3950admin>`__ you want to search for - cataloging (and acquisitions) - -- Cataloging System Preferences - - - `URLLinkText <#URLLinkText>`__ : Enter text to display when 856 - fields do not have pre-defined labels - - - `hide\_marc <#hide_marc>`__ : If you are unfamiliar with MARC you - can have the MARC fields number hidden - - - `LabelMARCView <#LabelMARCView>`__ : Choose how you want duplicate - fields to appear on the editor - - - `DefaultClassificationSource <#DefaultClassificationSource>`__ : - Choose which classification source is the default in your library - - - `advancedMARCeditor <#advancedMARCeditor>`__ : Decide if you need - labels to appear on your MARC editor - - - `marcflavour <#marcflavour>`__ : Choose your MARC format - - - `itemcallnumber <#itemcallnumber>`__ : Enter which field and - subfields to look into for the call number - - - `MARCOrgCode <#MARCOrgCode>`__ : Enter your MARC Organizational - Code (not the same as your OCLC number) - - - `autoBarcode <#autoBarcode>`__ : Decide if Koha generates item - barcodes for you - - - `OpacSuppression <#OpacSuppression>`__ : Decide if you want to - hide items marked as suppressed from the OPAC search results - -- Set up your `cron jobs <#cronjobs>`__ - - - Decide when the system `checks URLs in catalog - records <#checkurlcron>`__ to see if they are still valid - -`Authorities Configuration <#impauthorities>`__ ------------------------------------------------ - -Koha has the ability to keep track of your authority records and how -they're linked to your bibliographic records. Before using authorities -you should configure several preferences. - -- Set `Authority Frameworks <#authoritiesadmin>`__ aka templates - -- Authority System Preferences - - - `BiblioAddsAuthorities <#BiblioAddsAuthorities>`__ : Decide if - Koha creates authorities when cataloging - - - `dontmerge <#dontmerge>`__ : Decide if updates to authorities - trigger updates to the bibliographic records that link to them - - - `AutoCreateAuthorities <#AutoCreateAuthorities>`__ : Decide when - authorities are created - - - `LinkerModule <#LinkerModule>`__ : Decide which match the - authority linker should use - - - `LinkerOptions <#LinkerOptions>`__ : Decide if you want authority - linking to be broader or more specific - - - `CatalogModuleRelink <#CatalogModuleRelink>`__ : Decide if you - want to enable authority linking while cataloging - -- Set up your `cron jobs <#cronjobs>`__ - - - Choose when the system looks for authorities updates to `merge - changes into bibliographic records <#mergeauthcron>`__ - -`Searching Configuration <#impsearching>`__ -------------------------------------------- - -There are several system preferences related to searching, it is not -always recommended to make too many changes to these preferences since -they are set to get you the most relevant results. If you would like to -change the default way that Koha handles searching, view the `Searching -system preferences <#searchingprefs>`__ tab. - -- Set up your `cron jobs <#cronjobs>`__ - - - Decide how often your `system rebuilds the search - index <#rebuildsearchcron>`__ (4-10 min) - -- Searching System Preferences - - - `AdvancedSearchTypes <#AdvancedSearchTypes>`__ : Decide which - authorized value fields you want patrons and staff to be able to - limit their advanced searches by - - - `AdvancedSearchLanguages <#AdvancedSearchLanguages>`__ : Decide - which languages you want people to be able to limit to via the - search engine - - - `UseAuthoritiesForTracings <#UseAuthoritiesForTracings>`__ : - Decide how you want Koha to handle subject searches in the OPAC - - - `TraceCompleteSubfields <#TraceCompleteSubfields>`__ : Decide - how you want Koha to handle subject searches in the OPAC - - - `TraceSubjectSubdivisions <#TraceSubjectSubdivisions>`__ : - Decide how you want Koha to handle subject searches in the OPAC - - - `displayFacetCount <#displayFacetCount>`__ : Decide whether to - show facet counts on search results - -`OPAC Configuration <#impopac>`__ ---------------------------------- - -There are a lot of ways you can customize your OPAC in Koha. - -- Decide how you want your OPAC to look & what content you want on the - main page - -- Create a library branded stylesheet using CSS - - - **Important** - - Do not edit the default CSS files, instead create a new one, - that way the system can always fall back on the original CSS. - -- Create a custom XSLT stylesheet to change the way search results and - bib records appear in the OPAC - -- OPAC System preferences - - - `OPACBaseURL <#OPACBaseURL>`__ : Enter your library's url - - - `opacuserlogin <#opacuserlogin>`__ : Decide if you want to allow - patrons to login to the OPAC to access customized functionality - (searching will be allowed without logging in) - - - `RequestOnOpac <#RequestOnOpac>`__ : Decide if patrons can - place holds via the OPAC - - - `OpacPasswordChange <#OpacPasswordChange>`__ : Decide if - patrons can change their password (don't allow this if you're - using LDAP) - - - `OpacRenewalAllowed <#OpacRenewalAllowed>`__ : Decide if - patrons can renew their checked out items via the OPAC - - - `opacreadinghistory <#opacreadinghistory>`__ : Decide if - patrons can view their reading/checkout history via the OPAC - - - `reviewson <#reviewson>`__ : Decide if you want to allow - patrons to comment on bib records via the OPAC - - - `OpacStarRatings <#OpacStarRatings>`__ : Decide if patrons can - leave star ratings - - - `virtualshelves <#virtualshelves>`__ : Decide if you want - patrons to be able to create Lists - - - `OpacAllowPublicListCreation <#OpacAllowPublicListCreation>`__ - : If patrons can create lists then decide if they are allowed - to create public lists - - - `suggestion <#suggestionspref>`__ : Decide if you want patrons - to be able to submit purchase suggestions - - - `OPACViewOthersSuggestions <#OPACViewOthersSuggestions>`__ : - Decide if you want patrons to be able to see purchase - suggestions made by other patrons - - - `opacbookbag <#opacbookbag>`__ : Decide if patrons can save items - into their cart - - - `AnonSuggestions <#AnonSuggestions>`__ : Decide if you want non - logged in users to be able to make purchase suggestions - - - `LibraryName <#LibraryName>`__ : Enter your library name for - display in the tag and on the top of the OPAC - - - `opaccredits <#opaccredits>`__ : Enter HTML to appear at the - bottom of every page in the OPAC - - - `OpacMainUserBlock <#OpacMainUserBlock>`__ : Enter HTML that will - appear in the center of the main OPAC page - - - `OpacNav <#OpacNav>`__ : Enter HTML that will appear to the left - on the main OPAC page - - - `OpacNavBottom <#OpacNavBottom>`__ : Enter HTML that will appear - below OpacNav - - - `OpacNavRight <#OpacNavRight>`__ : Enter HTML that will appear - below the login box on the right - - - `opacheader <#opacheader>`__ : Enter the HTML that will appear - above the search box on the OPAC - - - `OPACNoResultsFound <#OPACNoResultsFound>`__ : Enter the HTML that - will appear when no results are found - - - `OPACResultsSidebar <#OPACResultsSidebar>`__ : Enter the HTML that - will appear below the facets on your search results - - - `OPACMySummaryHTML <#OPACMySummaryHTML>`__ : Enter the HTML that - will appear in the far right of the circulation summary in the - OPAC - - - Customize your stylesheets: - - - `OPACUserCSS <#OPACUserCSS>`__ : Enter any additional fields - you want to define styles for - - - `opaclayoutstylesheet <#opaclayoutstylesheet>`__ : Point to a - CSS file on your Koha server - - - `OpacHighlightedWords <#OpacHighlightedWords>`__ : Decide if you - want search terms to be highlighted on the search results - - - `hidelostitems <#hidelostitems>`__ : Decide if you want to show - patrons items you have marked as lost - - - `BiblioDefaultView <#BiblioDefaultView>`__ : Decide what view is - the default for bib records on the OPAC - - - `OPACShelfBrowser <#OPACShelfBrowser>`__ : Decide if you want to - enable the shelf browse functionality - - - `OPACURLOpenInNewWindow <#OPACURLOpenInNewWindow>`__ : Decide if - URLs clicked in the OPAC are opened in a new window - - - `SearchMyLibraryFirst <#SearchMyLibraryFirst>`__ : If you have a - multi-branch system decide if you want patrons to search their - library first - - - `OpacAuthorities <#OpacAuthorities>`__ : Decide if you want - patrons to be able to search your authority file - - - `OpacBrowser <#OpacBrowser>`__ : Decide if you want patrons to - browse your authority file (French libraries only) - - - `OPACSearchForTitleIn <#OPACSearchForTitleIn>`__ : Choose which - libraries you want patrons to be able to re-run their search in - - - `OpacAddMastheadLibraryPulldown <#OpacAddMastheadLibraryPulldown>`__ - : If you're a multi-branch system you can add a pull down to the - search bar for patrons to search which library to search - - - `EnableOpacSearchHistory <#EnableOpacSearchHistory>`__ : Decide if - you want the system to keep a search history - -- Set up your `cron jobs <#cronjobs>`__ - - - If you have the `OpacBrowser <#OpacBrowser>`__ preference set - decide `when you want the contents to - rebuild <#authbrowsercron>`__ (French libraries only) - - - If you have `custom RSS feeds <#customrss>`__, decide when you - want the `feed to be populated <#customrssfeedcron>`__ - -`Editable OPAC Regions <#editableopac>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Using the OPAC system preferences you can customize various regions, the -following graphic will define what preferences update each of the -regions in the Bootstrap theme. - -OPAC Editable Regions -|image1068| - -`Enhanced Content Configuration <#impenhanced>`__ -------------------------------------------------- - -Koha allows you to pull in content from outside sources to enhance your -bib records. All of this content can be toggled on and off using the -enhanced content system preferences. - -- `FRBR/Editions <#frbrenhancedprefs>`__ - - - If you would like to have your OPAC and/or staff client show an - 'Editions' tab on the bib record, you want to enable one or the - other FRBR preferences and then either one or both of the ISBN - services (XISBN and ThingISBN). - -- `Amazon <#amazonprefs>`__ : This service is free and just requires - that you visit http://aws.amazon.com to sign up - - - Using the Amazon preferences you can choose to show cover images - from Amazon. - -- `Babelthèque <#Babelthequeprefs>`__ - - - This is a pay service. Contact Babelthèque to learn how to enable - this content in the OPAC. - -- `Baker and Taylor <#btcontentprefs>`__ - - - This is a pay service from Baker & Taylor. Contact Baker & Taylor - for the information to enter into these preferences. - -- `HTML5 Media <#html5>`__ - - - This allows libraries to embed streaming media in their catalog - -- `Google <#googleprefs>`__ - - - This service is free and does not require registration, simply - enable GoogleJackets and you're set to go. - -- `I Deam Books <#IDreamLibraries>`__ - - - This is a free service that compiles reviews for popular titles - from many different sources. - -- `LibraryThing <#librarythingprefs>`__ - - - With the exception of ThingISBN, you will need to contact - LibraryThing for the information to enter into these preferences - - - Enabling ThingISBN will help to populate the editions tab on the - bib record display if you have enabled FRBR. - -- `Novelist <#novelistselect>`__ - - - This is a pay service from Ebsco. Contact Ebsco for the - information to enter into these preferences - -- `OCLC <#oclcprefs>`__ - - - XISBN is used to populate the editions tab on the bib record - display if you have enabled FRBR. This service is free for up to - 999 queries a day. - -- `Open Library <#OpenLibraryPrefs>`__ - - - Open Library project is an open system that you can pull cover - images (and in the future additional content) from - -- `Overdrive <#overdriveprefs>`__ - - - This is a pay service that libraries can subscribe to for ebook - content. If the library subscribes to Overdrive they can integrate - that content in to Koha for free. - -- `Syndetics <#Syndeticsprefs>`__ - - - This is a pay service from Syndetics to add content for your bib - records. Contact Syndetics for the information to enter into these - preferences. - -- `Tagging <#taggingprefs>`__ - - - Choose whether or not you want to allow patrons to add tags to - records in Koha. - -`Acquisitions Configuration <#impacq>`__ ----------------------------------------- - -When using acquisitions in Koha you first need to define some defaults. - -- Set up your `funds & budgets <#budgetplanning>`__ - -- Choose your `default currency <#currexchangeadmin>`__ and enter - others if you order from multiple countries - -- Enter in your `vendor information <#acqvendors>`__ - -- Create an `Framework with the code ACQ <#marcbibframeworks>`__ (if - you're going to enter item records at the time of ordering or - receiving) - -- Acquisitions System preferences - - - `AcqCreateItem <#AcqCreateItem>`__ : Decide if an item record is - created during acquisition - - - `CurrencyFormat <#CurrencyFormat>`__ : Decide how you want - monetary amounts to display - - - `gist <#gist>`__ : Enter your sales tax (if you are billed for - tax) - - - `OrderPdfFormat <#OrderPdfFormat>`__ : Decide what format you want - your print orders to use - -`Serials Configuration <#impserials>`__ ---------------------------------------- - -When you use serials there are a few options you can set before hand. - -- Serials System Preferences - - - `RenewSerialAddsSuggestion <#RenewSerialAddsSuggestion>`__ : - Decide if you want renewing serials to add a suggestion for easy - purchasing - - - `RoutingSerials <#RoutingSerials>`__ : Decide if you want to route - serials around your library - - - `RoutingListAddReserves <#RoutingListAddReserves>`__ : Decide if - holds are placed on serials when there is a routing list in place - -- Cataloging System Preferences - - - `StaffSerialIssueDisplayCount <#StaffSerialIssueDisplayCount>`__ : - Decide how many of the most recent issues to display in the staff - client - - - `OPACSerialIssueDisplayCount <#OPACSerialIssueDisplayCount>`__ : - Decide how many of the most recent issues to display in the OPAC - - - `SubscriptionHistory <#SubscriptionHistory>`__ : Decide how you - want the subscription information to display in the OPAC - -`Planning for Go-Live <#impgolive>`__ -------------------------------------- - -Once you have all of your settings ready, you need to prepare for making -your system live: - -- Decide if you need training by an outside service or if your staff - can do the training themselves. - -- Make sure that there is time for your staff to play with your test - system and get comfortable with it - -- If this is a migration, work with your previous company to extract - data right before you go live - -- Come up with URLs for your new Koha OPAC & Staff Client - -- Make sure that if you're hosting your own system you have a backup - plan - -SOPAC2 Installation -=================== - -`Introduction <#sopacintro>`__ ------------------------------- - -This is an installation guide for SOPAC2 and its Koha connector. It has -been tested on Debian Lenny and Ubuntu Jaunty with Drupal 6.12 and Koha -3.0.x. It does not cover the installation of Koha and Drupal, only -SOPAC, its dependencies and the connector. - -`Installation of Locum and Insurge <#sopacinstall>`__ ------------------------------------------------------ - -Locum and Insurge are the two libraries used primarily by SOPAC. They -serve as a layer of abstraction to the data. Insurge manages the social -aspect (tags, reviews, ratings), while Locum manages the connection to -the ILS via the connector. Both libraries use a different database from -that of Drupal. - -`Dependencies <#sopacdepend>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -There are no packages for Debian MDB2 yet, you can install it via pear: - -:: - - # apt-get install php-pear - # pear install MDB2 - # pear install MDB2#mysql - -`Download <#sopacdownload>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Download the Locum and Insurge libraries from SVN: - -:: - - # cd /usr/local/lib - # svn co http://dobby.darienlibrary.org/svn/locum/trunk/ locum - # svn co http://dobby.darienlibrary.org/svn/insurge/trunk/ insurge - -`Creation of the Database <#sopaccreatedb>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -:: - - $ mysql -u root - mysql> create database scas; - mysql> grant all privileges on scas.* to scas_user@'localhost' identified by 'scas_pass'; - mysql> flush privileges; - mysql> exit - -`Sync DSN <#sopacdsn>`__ -~~~~~~~~~~~~~~~~~~~~~~~~ - -This file will provide the connection information to a DB libraries: - -:: - - # nano /usr/local/etc/locum_insurge_dsn.php - -It should contain: - -:: - - <?php - $dsn = 'mysql://scas_user:scas_pass@localhost/scas'; - -`Installation of Insurge <#sopacinstallinsurge>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -If you customize the name of the database, remember to edit the sql -file: - -:: - - # nano /usr/local/lib/insurge/sql/scas_insurge.sql - -Import Insurge: - -:: - - $ mysql -u root -p < /usr/local/lib/insurge/sql/scas_insurge.sql - -Configure Insurge: - -:: - - # nano /usr/local/lib/insurge/config/insurge.ini - -The variables in insurge.ini are empty. The default values are too long -and cause MySQL errors. - -Here is a sample of insurge.ini - -:: - - ; This is the Locum configuration file - ; General configuration options for your installation of Insurge. - [insurge_config] - dsn_file = "/usr/local/etc/locum_insurge_dsn.php" - ; This is where you configure your repository membership information. - ; - ; parent_server is the server name of the repository parent server you have been - ; told to use. - ; group_id = The group ID you have been given by your repository admin. - ; These configuration points are OPTIONAL and are only necessary if you are - ; participating in a repository relationship. - [repository_info] - parent_server = "" - group_id = "" - group_key = "" - -`Installation of Locum <#sopacinstallocum>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The same procedure applies to Locum - -:: - - # nano /usr/local/lib/locum/sql/scas_locum.sql - # mysql < /usr/local/lib/locum/sql/scas_locum.sql - # nano /usr/local/lib/locum/sql/locum_init.sql - # mysql < /usr/local/lib/locum/sql/locum_init.sql - # nano /usr/local/lib/locum/config/locum.ini - # mkdir /usr/local/var - # mkdir /usr/local/var/log - -Configure the DSN: - -:: - - [locum_config] - dsn_file = "/usr/local/etc/locum_insurge_dsn.php" - -And the information for your Koha installation: - -:: - - [ils_config] - ils = "koha"; - ils_version = "30x" - ils_server = "localhost" - ils_harvest_port = "80" - -The rest depends on your Koha configuration. - -`Installation of Koha Connector <#sopackoha>`__ ------------------------------------------------ - -Download the Koha connector using SVN: - -:: - - # cd /usr/local/lib/locum/connectors/ - # svn co http://dobby.darienlibrary.org/svn/connectors/koha/ locum_koha_30x - -`Harvest Records <#sopacharvest>`__ ------------------------------------ - -Now that the connector is in place, we will be able to launch -harvest.php, a tool that will reap Locum DB Koha and fill the locum. - -Start by configuring harvest.php: - -:: - - # nano /usr/local/lib/locum/tools/harvest.php - -Here are the variables you must change: - -:: - - $first_record = 1; - $last_record = 30; - -These are the minimum and maximum biblionumbers from your Koha install. - -Then start the harvest: - -:: - - # chmod +x /usr/local/lib/locum/tools/harvest.php - $ /usr/local/lib/locum/tools/harvest.php - -`Installation of Sphinx <#sopacphinx>`__ ----------------------------------------- - -Sphinx is the indexer for the database used by Locum and Insurge. - -`Dependencies <#sphinxdepend>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -There is no Debian package for Sphinx so you'll have to compile the -source directly: - -:: - - # apt-get install g++ make libmysql++-dev - -`Download and Compile <#sphinxdownload>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -:: - - $ wget http://sphinxsearch.com/downloads/sphinx-0.9.8.tar.gz - $ tar zxvf sphinx-0.9.8.tar.gz - $ cd sphinx-0.9.8 - $ ./configure --prefix=/usr/local/sphinx - $ make - # make install - # mkdir /usr/local/sphinx - # mkdir /usr/local/sphinx/lib - # cp api/sphinxapi.php /usr/local/sphinx/lib/ - $ rm -R sphinx-0.9.8* - -`Creation of User and Group <#sphinxuser>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Creating a Sphinx user and change the owner: - -:: - - # adduser sphinx - # addgroup sphinx - # usermod -G sphinx sphinx - # mkdir /usr/local/sphinx/var/run - # chown -R sphinx.sphinx /usr/local/sphinx/var - -`The Sphinx daemon <#demonsphinx>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Download: - -:: - - # cd /etc/init.d - # wget http://www.thesocialopac.net/sites/thesocialopac.net/files/sphinx - # chmod +x /etc/init.d/sphinx - -Add Sphinx to the default boot services: - -:: - - # update-rc.d sphinx defaults - -`Configuration <#sphinxconfig>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Copy the configuration file supplied with the source of Sphinx before -the change: - -:: - - # cp /usr/local/lib/locum/sphinx/sphinx.conf /usr/local/sphinx/etc/ - # sed 's/locum_db_user/scas_user/g' /usr/local/sphinx/etc/sphinx.conf > tmpfile; - mv tmpfile /usr/local/sphinx/etc/sphinx.conf - # sed 's/locum_db_pass/scas_pass/g' /usr/local/sphinx/etc/sphinx.conf > tmpfile; mv tmpfile /usr/local/sphinx/etc/sphinx.conf - -And if you personalize the name of the database: - -:: - - # sed 's/scas/MY_DB/g' /usr/local/sphinx/etc/sphinx.conf > tmpfile; mv tmpfile /usr/local/sphinx/etc/sphinx.conf - -`Indexing documents <#sphinxindexing>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Indexing is necessary if you want to use the search features of SOPAC. - -You must first complete the Insurge table index - -:: - - # chmod +x /usr/local/lib/insurge/tools/update-index.php - $ /usr/local/lib/insurge/tools/update-index.php - -Then start indexing Sphinx - -:: - - $ /usr/local/sphinx/bin/indexer --all - -Finally, we must start the daemon: - -:: - - # /etc/init.d/sphinx start - -When the daemon is running, you can update the index with: - -:: - - $ /usr/local/sphinx/bin/indexer --all --rotate - -`Installation of SOPAC2 <#installsopac>`__ ------------------------------------------- - -Now to the SOPAC software itself: - -`Download <#downloadsopac>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Download from SVN: - -:: - - $ cd /chemin/vers/drupal/sites/all/ - $ mkdir modules - $ cd modules/ - $ svn co http://dobby.darienlibrary.org/svn/sopac/trunk/ sopac - -`Installation <#sopacinstallation>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -In Drupal's administration settings, activate the module. Also, enable -the dependencies: - -- Profile - -- PHP Filter - -- Path - -The Drupal menu should now list these entries. - -`Configuration <#configsopac>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Then go into the settings of SOPAC. - -- Configure the paths to the Locum and Insurge libraries - -- Choose a URL prefix SOPAC, in my "catalog". Create a node with - content like: - -:: - - <?php - print sopac_search_form('both'); - print theme('pages_catalog'); - -- Check the Input Format "PHP Code" - -- Check Move to front page - -- In URL path settings, set the SOPAC URL prefix you have chosen. - -Go to the root of Drupal, a search form will appear. - -Remember to empty Drupal's cache when something does not work. - -Drupal offers a few blocks, which are not configured by default. You -must specify on which page they should appear. - -Cron Jobs -========= - -A cron job is a Linux command for scheduling a command or script on your -server to complete repetitive tasks automatically. Scripts executed as a -cron job are typically used to modify files or databases; however, they -can perform other tasks that do not modify data on the server, like -sending out email notifications. Koha has many cron jobs in place that -you can enable (search engine indexing, overdue notice generation, data -cleanup and more), this chapter will explain those for you. - -`Cron Jobs <#cronjobs>`__ -------------------------- - -The locations below assume a dev install which puts the crons in misc/, -if you have a standard install you may want to look in bin/ for these -files if you cannot find them in misc/ - -`Search <#searchcron>`__ -~~~~~~~~~~~~~~~~~~~~~~~~ - -`Rebuild Index <#rebuildsearchcron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/migration\_tools/rebuild\_zebra.pl - -Does: Updates Zebra indexes with recently changed data. - -Required by: Zebra - -Frequency suggestion: every x minutes, (between 5-15 minutes) depending -on performance needs - -`Circulation <#circcron>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -`Holds Queue <#buildholdscron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/holds/build\_holds\_queue.pl - -Does: Updates holds queue report - -Required by: `Holds Queue Report <#holdsqueue>`__ - -Frequency suggestion: every 1-4 hours - -Description: - -- A script that should be run periodically if your library system - allows borrowers to place on-shelf holds. This script decides which - library should be responsible for fulfilling a given hold request. - - It's behavior is controlled by the system preferences - `StaticHoldsQueueWeight <#holdqueueweight>`__ and - `RandomizeHoldsQueueWeight <#holdqueueweight>`__. - - If you do not want all of your libraries to participate in the - on-shelf holds fulfillment process, you should list the the libraries - that \*do\* participate in the process here by inputting all the - participating library's branchcodes, separated by commas ( e.g. - "MPL,CPL,SPL,BML" etc. ). - - By default, the holds queue will be generated such that the system - will first attempt to hold fulfillment using items already at the - pickup library if possible. If there are no items available at the - pickup library to fill a hold, build\_holds\_queue.pl will then use - the list of libraries defined in StaticHoldsQueueWeight. If - RandomizeHoldsQueueWeight is disabled ( which it is by default ), the - script will assign fulfillment requests in the order the branches are - placed in the StaticHoldsQueueWeight system preference. - - For example, if your system has three libraries, of varying sizes ( - small, medium and large ) and you want the burden of holds - fulfillment to be on larger libraries before smaller libraries, you - would want StaticHoldsQueueWeight to look something like - "LRG,MED,SML". - - If you want the burden of holds fulfillment to be spread out equally - throughout your library system, simply enable - RandomizeHoldsQueueWeight. When this system preference is enabled, - the order in which libraries will be requested to fulfill an on-shelf - hold will be randomized each time the list is regenerated. - - Leaving StaticHoldsQueueWeight empty is contraindicated at this time. - Doing so will cause the build\_holds\_queue script to ignore - RandomizeHoldsQueueWeight, causing the script to request hold - fulfillment not randomly, but by alphabetical order. - -`Perl Documentation <#buildholdscronperl>`__ -'''''''''''''''''''''''''''''''''''''''''''' - -**GetBibsWithPendingHoldRequests** - -my $biblionumber\_aref = GetBibsWithPendingHoldRequests(); - -Return an arrayref of the biblionumbers of all bibs that have one or -more unfilled hold requests. - -**GetPendingHoldRequestsForBib** - -my $requests = GetPendingHoldRequestsForBib($biblionumber); - -Returns an arrayref of hashrefs to pending, unfilled hold requests on - -the bib identified by $biblionumber. The following keys are present in -each hashref: - -- biblionumber - -- borrowernumber - -- itemnumber - -- priority - -- branchcode - -- reservedate - -- reservenotes - -- borrowerbranch - -The arrayref is sorted in order of increasing priority. - -**GetItemsAvailableToFillHoldRequestsForBib** - -my $available\_items = - -GetItemsAvailableToFillHoldRequestsForBib($biblionumber); - -Returns an arrayref of items available to fill hold requests for the bib -identified by $biblionumber. An item is available to fill a hold - -request if and only if: - -- it is not on loan - -- it is not withdrawn - -- it is not marked notforloan - -- it is not currently in transit - -- it is not lost - -- it is not sitting on the hold shelf - -**MapItemsToHoldRequests** - -MapItemsToHoldRequests($hold\_requests, $available\_items); - -**CreatePickListFromItemMap** - -**AddToHoldTargetMap** - -**\_get\_branches\_to\_pull\_from** - -Query system preferences to get ordered list of branches to use to fill -hold requests. - -`Expired Holds <#expiredholdscron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/holds/cancel\_expired\_holds.pl - -Does: By default, this cron job will only automatically cancel holds -where the user has set an expiration date. If the library is using the -`ExpireReservesMaxPickUpDelay <#ExpireReservesMaxPickUpDelay>`__ and -`ExpireReservesMaxPickUpDelayCharge <#ExpireReservesMaxPickUpDelayCharge>`__ -preferences then this script will also cancel holds that have been -sitting on the hold shelf for too long and will (if the library does) -charge the patron for not picking up the hold. - -Frequency suggestion: daily - -`Unsuspend Holds <#unsuspendholdcron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/holds/auto\_unsuspend\_holds.pl - -Does: This script checks to find holds that should no longer be -suspended and removes the suspension if the -`AutoResumeSuspendedHolds <#AutoResumeSuspendedHolds>`__ preference is -set to 'allow'. This puts the patron back in to the queue where they -were when the hold was suspended. - -Frequency suggestion: daily - -`Fines <#finescronjob>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/fines.pl - -Does: Calculates and posts fines to patron accounts. - -Required by: `finesMode <#finesMode>`__ system preference - -Frequency suggestion: nightly - -`Long Overdues <#longoverduecron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/longoverdue.pl - -Does: allows one to specify delays for changing items to different lost -statuses, and optionally charge for them using the replacement price -listed on the item record. - -Frequency suggestion: nightly - - **Note** - - Staff can control some of the parameters for the longoverdue cron - job with the - `DefaultLongOverdueLostValue <#DefaultLongOverdueLostValue>`__ and - `DefaultLongOverdueChargeValue <#DefaultLongOverdueChargeValue>`__ - preferences. - -`Perl Documentation <#longoverduecronperl>`__ -''''''''''''''''''''''''''''''''''''''''''''' - -**NAME** - -longoverdue.pl cron script to set lost statuses on overdue materials. -Execute without options for help. - -**DESCRIPTION** - ---lost \| -l - -This option takes the form of n=lv, where n is num days overdue, and lv -is the lost value. See warning below. - ---charge \| -c - -This specifies what lost value triggers Koha to charge the account for -the lost item. Replacement costs are not charged if this is not -specified. - ---verbose \| v - -verbose. - ---confirm - -confirm. without this option, the script will report the number of -affected items and return without modifying any records. - ---quiet - -suppress summary output. - ---maxdays - -Specifies the end of the range of overdue days to deal with (defaults to -366). This value is universal to all lost num days overdue passed. - ---mark-returned - -When an item is marked lost, remove it from the borrowers issued items. - -`Track total checkouts <#updateissuescron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/update\_totalissues.pl - -Does: updates the biblioitems.totalissues field in the database with the -latest tally of checkouts. - -Frequency suggestion: nightly - -`Perl Documentation <#updateissuesperldoc>`__ -''''''''''''''''''''''''''''''''''''''''''''' - -**NAME** - -update\_totalissues.pl - -**SYNOPSIS** - -update\_totalissues.pl --use-stats - -update\_totalissues.pl --use-items - -update\_totalissues.pl --commit=1000 - -update\_totalissues.pl --since='2012-01-01' - -update\_totalissues.pl --interval=30d - -**DESCRIPTION** - -This batch job populates bibliographic records' total issues count based -on historical issue statistics. - ---help Prints this help - --v\|--verbose - -Provide verbose log information (list every bib modified). - ---use-stats - -Use the data in the statistics table for populating total issues. - ---use-items - -Use items.issues data for populating total issues. Note that issues data -from the items table does not respect the --since or --interval options, -by definition. Also note that if both --use-stats and --use-items are -specified, the count of biblios processed will be misleading. - --s\|--since=DATE - -Only process issues recorded in the statistics table since DATE. - --i\|--interval=S - -Only process issues recorded in the statistics table in the last N units -of time. The interval should consist of a number with a one- letter unit -suffix. The valid suffixes are h (hours), d (days), w (weeks), m -(months), and y (years). The default unit is days. - ---incremental - -Add the number of issues found in the statistics table to the existing -total issues count. Intended so that this script can be used as a cron -job to update popularity information during low-usage periods. If -neither --since or --interval are specified, incremental mode will -default to processing the last twenty-four hours. - ---commit=N - -Commit the results to the database after every N records are processed. - ---test - -Only test the popularity population script. - -**WARNING** - -If the time on your database server does not match the time on your Koha -server you will need to take that into account, and probably use the ---since argument instead of the --interval argument for incremental -updating. - -**CREDITS** - -This patch to Koha was sponsored by the Arcadia Public Library and the -Arcadia Public Library Foundation in honor of Jackie Faust-Moreno, late -director of the Arcadia Public Library. - -**AUTHOR** - -Jared Camins-Esakov <jcamins AT cpbibliography DOT com> - -`Generate Patron File for Offline Circulation <#offlinecirccron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/create\_koc\_db.pl - -Does: Generates the borrowers.db file for use with the `Koha Offline -Circulation <#windowsofflinecirc>`__ tool - -Frequency suggestion: weekly - -`Automatic renewal <#autorenewcron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/automatic\_renewals.pl - -Does: Will automatically renew items if you're allowing automatic -renewal with your `circulation and fine rules <#circfinerules>`__. - -Frequency suggestion: nightly - -`Perl Documentation <#autorenewcronperl>`__ -''''''''''''''''''''''''''''''''''''''''''' - -**NAME** - -automatic\_renewals.pl - cron script to renew loans - -**SYNOPSIS** - -./automatic\_renewals.pl - -or, in crontab: 0 3 \* \* \* automatic\_renewals.pl - -**DESCRIPTION** - -This script searches for issues scheduled for automatic renewal -(issues.auto\_renew). If there are still renews left (Renewals allowed) -and the renewal isn't premature (No Renewal before) the issue is -renewed. - -**OPTIONS** - -No options. - -`Patrons <#patroncrons>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -`Unverified Registrations <#deleteexpiredregistrationcron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/delete\_expired\_opac\_registrations.pl - -Does: Deletes patron registrations that were submitted via the OPAC but -not reviewed by the library within the number of days entered in the -`PatronSelfRegistrationExpireTemporaryAccountsDelay <#PatronSelfRegistrationExpireTemporaryAccountsDelay>`__ -preference. - -Frequency suggestion: nightly - -`Unconfirmed Registrations <#deleteunverifiedcron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/delete\_unverified\_opac\_registrations.pl - -Does: Deletes patron self registrations that were submitted via the OPAC -but not confirmed via email within 24 hours. This is only necessary if -you are requiring patrons to confirm their registrations via email with -the -`PatronSelfRegistrationVerifyByEmail <#PatronSelfRegistrationVerifyByEmail>`__ -preference. - -Frequency suggestion: hourly - -`Anonymize Patron Data <#anonymizecron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/batch\_anonymise.pl - -Does: Used to anonymize patron data. This will remove borrowernumbers -from circulation history so that the stats are kept, but the patron -information is removed for privacy reasons. - -`Update Child to Adult Patron Type <#j2acron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/j2a.pl - -Does: Convert juvenile/child patrons from juvenile patron category and -category code to corresponding adult patron category and category code -when they reach the upper age limit defined in the Patron Categories. - -Frequency suggestion: nightly - -`Perl Documentation <#j2aperldoc>`__ -'''''''''''''''''''''''''''''''''''' - -**NAME** - -juv2adult.pl - convert juvenile/child patrons from juvenile patron -category and category code to corresponding adult patron category and -category code when they reach the upper age limit defined in the Patron -Categories. - -**SYNOPSIS** - -juv2adult.pl [ -b=<branchcode> -f=<categorycode> -t=<categorycode> ] - -Options: - ---help brief help message - ---man full documentation - --v verbose mode - --n take no action, display only - --b <branchname> only deal with patrons from this library/branch - --f <categorycode> change patron category from this category - --t <categorycode> change patron category to this category - -=head1 OPTIONS - ---help Print a brief help message and exits. - ---man Prints the manual page and exits. - --v Verbose. Without this flag set, only fatal errors are reported. - --n No Action. With this flag set, script will report changes but not -actually execute them on the database. - --b changes patrons for one specific branch. Use the value in the -branches.branchcode table. - --f \*required\* defines the juvenile category to update. Expects the -code from categories.categorycode. - --t \*required\* defines the category juvenile patrons will be converted -to. Expects the code from categories.categorycode. - -**DESCRIPTION** - -This script is designed to update patrons from juvenile to adult patron -types, remove the guarantor, and update their category codes -appropriately when they reach the upper age limit defined in the Patron -Categories. - -**USAGE EXAMPLES** - -"juv2adult.pl" - Suggests that you read this help. :) - -"juv2adult.pl" -b=<branchcode> -f=<categorycode> -t=<categorycode> - -Processes a single branch, and updates the patron categories from -fromcat to tocat. - -"juv2adult.pl" -f=<categorycode> -t=<categorycode> -v -n - Processes all -branches, shows all messages, and reports the patrons who would be -affected. Takes no action on the database. - -`Notices <#noticescron>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -`Message Queue <#msgqueuecron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/process\_message\_queue.pl - -Does: processes the message queue to send the check out, check in and -hold filled emails and SMS message to users and sends outgoing emails to -patrons. requires -`EnhancedMessagingPreferences <#EnhancedMessagingPreferences>`__ to be -on - -Frequency suggestion: 1-4 hours - - **Important** - - Item due and Advanced due notices are controlled by the - `advance\_notices cron <#advnoticecron>`__. - -`Advanced Notice <#advnoticecron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/advance\_notices.pl - -Does: prepares "pre-due" notices and "item due" notices for patrons who -request them prepares notices for patrons for items just due or coming -due soon. requires -`EnhancedMessagingPreferences <#EnhancedMessagingPreferences>`__ to be -on - -Frequency suggestion: nightly - - **Note** - - This script does not actually send the notices. It queues them in - the `message queue <#msgqueuecron>`__ for later - -`Perl Documentation <#advnoticecronperl>`__ -''''''''''''''''''''''''''''''''''''''''''' - -**NAME** - -advance\_notices.pl - cron script to put item due reminders into message -queue - -**SYNOPSIS** - -./advance\_notices.pl -c - -or, in crontab: 0 1 \* \* \* advance\_notices.pl -c - -**DESCRIPTION** - -This script prepares pre-due and item due reminders to be sent to -patrons. It queues them in the message queue, which is processed by the -process\_message\_queue.pl cronjob. The type and timing of the messages -can be configured by the patrons in their "My Alerts" tab in the OPAC. - -**METHODS** - -parse\_letter - -`Overdue Notice <#overduenoticecron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/overdue\_notices.pl - -Does: prepares messages to alert patrons of overdue messages (both via -email and print) - -Frequency suggestion: nightly - - **Note** - - This script does not actually send the notices. It queues them in - the `message queue <#msgqueuecron>`__ for later or generates the - HTML for later printing - -`Perl Documentation <#overduenoticecronperl>`__ -''''''''''''''''''''''''''''''''''''''''''''''' - -**NAME** - -overdue\_notices.pl - prepare messages to be sent to patrons for overdue -items - -**SYNOPSIS** - -overdue\_notices.pl [ -n ] [ -library <branchcode> ] [ -library -<branchcode>...] [ -max <number of days> ] [ -csv [ <filename> ] ] -[-itemscontent <field list> ] - -Options: - --help brief help message - --man full documentation - --n No email will be sent - --max <days> maximum days overdue to deal with - --library <branchname> only deal with overdues from this library -(repeatable : several libraries can be given) - --csv <filename> populate CSV file - --html <filename> Output html to file - --itemscontent <list of fields> item information in templates - --borcat <categorycode> category code that must be included - --borcatout <categorycode> category code that must be excluded - -**OPTIONS** - --help Print a brief help message and exits. - --man Prints the manual page and exits. - --v Verbose. Without this flag set, only fatal errors are reported. - --n Do not send any email. Overdue notices that would have been sent to -the patrons or to the admin are printed to standard out. CSV data (if -the -csv flag is set) is written to standard out or to any csv filename -given. - --max Items older than max days are assumed to be handled somewhere else, -probably the longoverdues.pl script. They are therefore ignored by this -program. No notices are sent for them, and they are not added to any CSV -files. Defaults to 90 to match longoverdues.pl. - --library - -select overdues for one specific library. Use the value in the -branches.branchcode table. This option can be repeated in order to -select overdues for a group of libraries. - --csv Produces CSV data. if -n (no mail) flag is set, then this CSV data -is sent to standard out or to a filename if provided. Otherwise, only -overdues that could not be emailed are sent in CSV format to the admin. - --itemscontent - -comma separated list of fields that get substituted into templates in -places of the <<items.content>> placeholder. This defaults to -issuedate,title,barcode,author - -Other possible values come from fields in the biblios, items, and issues -tables. - --borcat Repetable field, that permit to select only few of patrons -categories. - --borcatout - -Repetable field, permis to exclude some patrons categories. - --t \| --triggered - -This option causes a notice to be generated if and only if an item is -overdue by the number of days defined in a notice trigger. - -By default, a notice is sent each time the script runs, which is -suitable for less frequent run cron script, but requires syncing notice -triggers with the cron schedule to ensure proper behavior. Add the ---triggered option for daily cron, at the risk of no notice being -generated if the cron fails to run on time. - --list-all - -Default items.content lists only those items that fall in the range of -the currently processing notice. Choose list-all to include all overdue -items in the list (limited by -max setting). - -**DESCRIPTION** - -This script is designed to alert patrons and administrators of overdue -items. - -Configuration - -This script pays attention to the overdue notice configuration performed -in the "Overdue notice/status triggers" section of the "Tools" area of -the staff interface to Koha. There, you can choose which letter -templates are sent out after a configurable number of days to patrons of -each library. More information about the use of this section of Koha is -available in the Koha manual. - -The templates used to craft the emails are defined in the "Tools: -Notices" section of the staff interface to Koha. - -Outgoing emails - -Typically, messages are prepared for each patron with overdue items. -Messages for whom there is no email address on file are collected and -sent as attachments in a single email to each library administrator, or -if that is not set, then to the email address in the -"KohaAdminEmailAddress" system preference. - -These emails are staged in the outgoing message queue, as are messages -produced by other features of Koha. This message queue must be processed -regularly by the misc/cronjobs/process\_message\_queue.pl program. - -In the event that the "-n" flag is passed to this program, no emails are -sent. Instead, messages are sent on standard output from this program. -They may be redirected to a file if desired. - -Templates - -Templates can contain variables enclosed in double angle brackets like -<<this>>. Those variables will be replaced with values specific to the -overdue items or relevant patron. Available variables are: - -<<bib>> - -the name of the library - -<<items.content>> - -one line for each item, each line containing a tab separated list of -title, author, barcode, issuedate - -<<borrowers.\*>> - -any field from the borrowers table - -<<branches.\*>> - -any field from the branches table - -CSV output - -The "-csv" command line option lets you specify a file to which overdues -data should be output in CSV format. - -With the "-n" flag set, data about all overdues is written to the file. -Without that flag, only information about overdues that were unable to -be sent directly to the patrons will be written. In other words, this -CSV file replaces the data that is typically sent to the administrator -email address. - -**USAGE EXAMPLES** - -"overdue\_notices.pl" - In this most basic usage, with no command line -arguments, all libraries are processed individually, and notices are -prepared for all patrons with overdue items for whom we have email -addresses. Messages for those patrons for whom we have no email address -are sent in a single attachment to the library administrator's email -address, or to the address in the KohaAdminEmailAddress system -preference. - -"overdue\_notices.pl -n -csv /tmp/overdues.csv" - sends no email and -populates /tmp/overdues.csv with information about all overdue items. - -"overdue\_notices.pl -library MAIN max 14" - prepare notices of overdues -in the last 2 weeks for the MAIN library. - -**SEE ALSO** - -The misc/cronjobs/advance\_notices.pl program allows you to send -messages to patrons in advance of their items becoming due, or to alert -them of items that have just become due. - -**INTERNAL METHODS** - -These methods are internal to the operation of overdue\_notices.pl. - -parse\_letter - -parses the letter template, replacing the placeholders with data -specific to this patron, biblio, or item - -named parameters: - -letter - required hashref - -borrowernumber - required integer - -substitute - optional hashref of other key/value pairs that should be -substituted in the letter content - -returns the "letter" hashref, with the content updated to reflect the -substituted keys and values. - -prepare\_letter\_for\_printing - -returns a string of text appropriate for printing in the event that an -overdue notice will not be sent to the patron's email address. Depending -on the desired output format, this may be a CSV string, or a -human-readable representation of the notice. - -required parameters: - -letter - -borrowernumber - -optional parameters: - -outputformat - -`Print Hold Notices <#printholdcron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/gather\_print\_notices.pl - -Does: looks through the message queue for hold notices that didn't go -through because the patron didn't have an email address and generates a -print notice - -Frequency suggestion: nightly - -`Talking Tech <#talkingtechcrons>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -To learn more about setting up this third party product view the -`Talking Tech Appendix <#talkingtechappendix>`__. - -`Sending Notices File <#talkingtechsendcron>`__ -''''''''''''''''''''''''''''''''''''''''''''''' - -Script path: misc/cronjobs/thirdparty/TalkingTech\_itiva\_outbound.pl - -Does: Script to generate Spec C outbound notifications file for Talking -Tech i-tiva phone notification system. - -Required by: -`TalkingTechItivaPhoneNotification <#TalkingTechItivaPhoneNotification>`__ - -Frequency suggestion: nightly - -`Perl Documentation <#talkingsendcronperl>`__ - - -**USAGE** - -TalkingTech\_itiva\_outbound.pl - -TalkingTech\_itiva\_outbound.pl --type=OVERDUE -w 0 -w 2 -w 6 ---output=/tmp/talkingtech/outbound.csv - -TalkingTech\_itiva\_outbound.pl --type=RESERVE --type=PREOVERDUE ---lang=FR - -Script to generate Spec C outbound notifications file for Talking Tech -i-tiva phone notification system. - ---help -h - -Prints this help - --v Provide verbose log information. - ---output -o - -Destination for outbound notifications file (CSV format). If no value is -specified, output is dumped to screen. - ---lang - -Sets the language for all outbound messages. Currently supported values -are EN, FR and ES. If no value is specified, EN will be used by default. - ---type - -REQUIRED. Sets which messaging types are to be used. Can be given -multiple times, to specify multiple types in a single output file. -Currently supported values are RESERVE, PREOVERDUE and OVERDUE. If no -value is given, this script will not produce any outbound notifications. - ---waiting-hold-day -w - -OPTIONAL for --type=RESERVE. Sets the days after a hold has been set to -waiting on which to call. Use switch as many times as desired. For -example, passing "-w 0 -w 2 -w 6" will cause calls to be placed on the -day the hold was set to waiting, 2 days after the waiting date, and 6 -days after. See example above. If this switch is not used with ---type=RESERVE, calls will be placed every day until the waiting reserve -is picked up or canceled. - ---library-code --code -c - -OPTIONAL The code of the source library of the message. The library code -is used to group notices together for consortium purposes and apply -library specific settings, such as prompts, to those notices. This field -can be blank if all messages are from a single library. - -`Receiving Notices File <#talkingtechreceivecron>`__ -'''''''''''''''''''''''''''''''''''''''''''''''''''' - -Script path: misc/cronjobs/thirdparty/TalkingTech\_itiva\_inbound.pl - -Does: Script to process received Results files for Talking Tech i-tiva -phone notification system. - -Required by: -`TalkingTechItivaPhoneNotification <#TalkingTechItivaPhoneNotification>`__ - -Frequency suggestion: nightly - -`Perl Documentation <#talkingreceivecronperl>`__ - - -**USAGE** - -TalkingTech\_itiva\_inbound.pl - -TalkingTech\_itiva\_inbound.pl -v --input=/tmp/talkingtech/results.csv - -Script to process received Results files for Talking Tech i-tiva phone -notification system. - ---help -h - -Prints this help - --v Provide verbose log information. - ---input -i - -REQUIRED. Path to incoming results file. - -`Notify Patrons of Expiration <#patronexpirycron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/membership\_expiry.pl - -Does: Sends messages to warn patrons of their card expiration to the -`messaage queue <#msgqueuecron>`__ cron. - -Requires: `MembershipExpiryDaysNotice <#MembershipExpiryDaysNotice>`__ - -Frequency: nightly - -`In Processing/Book Cart <#proccartcron>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Script path: misc/cronjobs/cart\_to\_shelf.pl - -Does: Updates all items with a location of CART to the item's permanent -location. - -Required by: `NewItemsDefaultLocation <#NewItemsDefaultLocation>`__, -`InProcessingToShelvingCart <#InProcessingToShelvingCart>`__, & -`ReturnToShelvingCart <#ReturnToShelvingCart>`__ system preferences - -Frequency suggestion: hourly - -`Perl Documentation <#proccartcronperl>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**NAME** - -cart\_to\_shelf.pl cron script to set items with location of CART to -original shelving location after X hours. Execute without options for -help. - -`Catalog <#catalogcron>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -`Check URLs <#checkurlcron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/check-url.pl - -Does: checks URLs in 856$u field. Script output can now be formatted in -CSV or HTML. The HTML version links directly to MARC biblio record -editor. - -Frequency suggestion: monthly - -Learn more: http://wiki.koha-community.org/wiki/Check-url_enhancements - -`Perl Documentation <#checkurlcronperl>`__ -'''''''''''''''''''''''''''''''''''''''''' - -**NAME** - -C4::URL::Checker - base object for checking URL stored in Koha DB - -**SYNOPSIS** - -:: - - use C4::URL::Checker; - - my $checker = C4::URL::Checker->new( ); - $checker->{ host_default } = 'http://mylib.kohalibrary.com'; - my $checked_urls = $checker->check_biblio( 123 ); - foreach my $url ( @$checked_urls ) { - print "url: ", $url->{ url A }, "\n", - "is_success: ", $url->{ is_success }, "\n", - "status: ", $url->{ status }, "\n"; - } - -**FUNCTIONS** - -new - -Create a URL Checker. The returned object can be used to set default -host variable : - -:: - - my $checker = C4::URL::Checker->new( ); - $checker->{ host_default } = 'http://mylib.kohalibrary.com'; - -check\_biblio - -Check all URL from a biblio record. Returns a pointer to an array -containing all URLs with checking for each of them. - -:: - - my $checked_urls = $checker->check_biblio( 123 ); - -With 2 URLs, the returned array will look like that: - -:: - - [ - { - 'url' => 'http://mylib.tamil.fr/img/62265_0055B.JPG', - 'is_success' => 1, - 'status' => 'ok' - }, - { - 'url' => 'http://mylib.tamil.fr//img/62265_0055C.JPG', - 'is_success' => 0, - 'status' => '404 - Page not found' - } - ], - -**NAME** - -check-url.pl - Check URLs from 856$u field. - -**USAGE** - -check-url.pl [--verbose\|--help] [--host=http://default.tld] - -Scan all URLs found in 856$u of bib records and display if resources are -available or not. - -**PARAMETERS** - ---host=http://default.tld - -Server host used when URL doesn't have one, ie doesn't begin with -'http:'. For example, if --host=http://www.mylib.com, then when 856$u -contains 'img/image.jpg', the url checked is: -http://www.mylib.com/image.jpg'. - ---verbose\|-v - -Outputs both successful and failed URLs. - ---html - -Formats output in HTML. The result can be redirected to a file -accessible by http. This way, it's possible to link directly to biblio -record in edit mode. With this parameter --host-pro is required. - ---host-pro=http://koha-pro.tld - -Server host used to link to biblio record editing page. - ---help\|-h - -Print this help page. - -`Update Authorities <#mergeauthcron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/migration\_tools/merge\_authority.pl - -Does: Updates biblio data with changes to authorities records - - **Note** - - The name of this script is misleading. This script does not merge - authorities together it instead merges authority data with linked - bib records. Edits to authority records will be applied to - bibliographic records that use that authority when this script is - run. - -Required by: `dontmerge <#dontmerge>`__ system preference - -Frequency suggestion: nightly - -`Serials Update <#serialscron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/serialsUpdate.pl - -Does: checks if there is a "late" issue on active subscriptions, and if -there is, the script will set it as late, and add the next one as -expected. - -Frequency suggestion: nightly - -`Automatic item update <#autoitemupdatecron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/automatic\_item\_modification\_by\_age.pl - -Does: updates items based on the list of rules set forth in the -`Automatic item modifications by age <#autoitemagemod>`__ tool - -Required by: `Automatic item modifications by age <#autoitemagemod>`__ - -Frequency suggestions: nightly - -`Perl Documentation <#autoitemupdatecrondoc>`__ -''''''''''''''''''''''''''''''''''''''''''''''' - -**NAME** - -automatic\_item\_modification\_by\_age.pl - -**SYNOPSIS** - -./automatic\_item\_modification\_by\_age.pl -h - -Toggle recent acquisitions status. Use this script to delete "new" -status for items. - -**OPTIONS** - --h\|--help Prints this help message. - --v\|--verbose Set the verbose flag. - --c\|--confirm The script will modify the items. - -**AUTHOR** - -Jonathan Druart <jonathan.druart@biblibre.com> - -**COPYRIGHT** - -Copyright 2013 BibLibre - -**LICENSE** - -This file is part of Koha. - -Koha is free software; you can redistribute it and/or modify it under -the terms of the GNU General Public License as published by the Free -Software Foundation; either version 3 of the License, or (at your -option) any later version. - -Koha is distributed in the hope that it will be useful, but WITHOUT ANY -WARRANTY; without even the implied warranty of MERCHANTABILITY or -FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for -more details. - -You should have received a copy of the GNU General Public License along -with Koha; if not, see <http://www.gnu.org/licenses>. - -`OPAC <#opaccrons>`__ -~~~~~~~~~~~~~~~~~~~~~ - -`RSS Feeds <#customrssfeedcron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/rss/rss.pl - -Does: Produces an RSS XML document for any SQL query (not used for -search results RSS feed). `Learn more <#customrss>`__. - -Frequency suggestion: hourly - -`Authorities Browser <#authbrowsercron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/build\_browser\_and\_cloud.pl - -Does: Generate content for authorities browse in OPAC - -Required by: `OpacBrowser <#OpacBrowser>`__ system preference - - **Important** - - This preference and cron job should only be used on French systems. - -`Subject/Author Clouds <#keywordclouds>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/cloud-kw.pl - -Does: Generates HTML keywords clouds from Koha Zebra indexes. -misc/cronjobs/cloud-sample.conf has a sample of how this script -operates. - -Frequency: This is the type of script you can run once a month or so, -the content generated isn't going to change very much over time. - -`Perl Documentation <#keywordcloudsperl>`__ -''''''''''''''''''''''''''''''''''''''''''' - -**NAME** - -cloud-kw.pl - Creates HTML keywords clouds from Koha Zebra Indexes - -**USAGE** - -cloud-kw.pl [--verbose\|--help] --conf=cloud.conf - -Creates multiple HTML files containing keywords cloud with top terms -sorted by their logarithmic weight. cloud.conf is a YAML configuration -file driving cloud generation process. - -**PARAMETERS** - ---conf=configuration file - -Specify configuration file name - ---verbose\|-v - -Enable script verbose mode. - ---help\|-h - -Print this help page. - -**CONFIGURATION** - -Configuration file looks like that: - -:: - - --- - # Koha configuration file for a specific installation - # If not present, defaults to KOHA_CONF - KohaConf: /home/koha/mylibray/etc/koha-conf.xml - # Zebra index to scan - ZebraIndex: Author - # Koha index used to link found kewords with an opac search URL - KohaIndex: au - # Number of top keyword to use for the cloud - Count: 50 - # Include CSS style directives with the cloud - # This could be used as a model and then CSS directives are - # put in the appropriate CSS file directly. - Withcss: Yes - # HTML file where to output the cloud - Output: /home/koha/mylibrary/koharoot/koha-tmpl/cloud-author.html - --- - KohaConf: /home/koha/yourlibray/etc/koha-conf.xml - ZebraIndex: Subject - KohaIndex: su - Count: 200 - Withcss: no - Output: /home/koha/yourlibrary/koharoot/koha-tmpl/cloud-subject.html - -**IMPROVEMENTS** - -Generated top terms have more informations than those outputted from the -time being. Some parameters could be easily added to improve this -script: - -WithCount - -In order to output terms with the number of occurrences they have been -found in Koha Catalogue by Zebra. - -CloudLevels - -Number of levels in the cloud. Now 24 levels are hardcoded. - -Weighting - -Weighting method used to distribute terms in the cloud. We could have -two values: Logarithmic and Linear. Now it's Logarithmic by default. - -Order - -Now terms are outputted in the lexical order. They could be sorted by -their weight. - -`System Administration <#systemcron>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -`Clean up Database <#cleandbcron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/cleanup\_database.pl - -Does: Truncates the sessions table, cleans out old zebraqueue entries, -action logs and staged MARC files. - -Perl Documentation -'''''''''''''''''' - -**USAGE** - -kohaclone/misc/cronjobs/cleanup\_database.pl [-h\|--help] [--sessions] -[--sessdays DAYS] [-v\|--verbose] [--zebraqueue DAYS] [-m\|--mail] -[--merged] [--import DAYS] [--logs DAYS] [--searchhistory DAYS] - -**PARAMETERS** - --h --help - -prints this help message, and exits, ignoring all other options - ---sessions - -purge the sessions table. If you use this while users are logged into -Koha, they will have to reconnect. - ---sessdays DAYS - -purge only sessions older than DAYS days - --v --verbose - -will cause the script to give you a bit more information about the run. - ---zebraqueue DAYS - -purge completed zebraqueue entries older than DAYS days. Defaults to 30 -days if no days specified. - --m --mail DAYS - -purge items from the mail queue that are older than DAYS days. Defaults -to 30 days if no days specified. - ---merged - -purged completed entries from need\_merge\_authorities. - ---import DAYS - -purge records from import tables older than DAYS days. Defaults to 60 -days if no days specified - ---z3950 - -purge records from import tables that are the result of Z39.50 searches - ---logs DAYS - -purge entries from action\_logs older than DAYS days. Defaults to 180 -days if no days specified - ---searchhistory DAYS - -purge entries from search\_history older than DAYS days. Defaults to 30 -days if no days specified - ---list-invites DAYS - -purge (unaccepted) list share invites older than DAYS days. Defaults to -14 days if no days specified. - ---restrictions DAYS - -purge patrons restrictions expired since more than DAYS days. Defaults -to 30 days if no days specified. - -`Share Usage Stats <#usagecron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/share\_usage\_with\_koha\_community.pl - -Does: If you're sharing information via the `UsageStats <#UsageStats>`__ -feature this will send your info to the `Hea -website <http://hea.koha-community.org/>`__. - -Frequency: monthly - -`Perl Documentation <#usagecronperl>`__ -''''''''''''''''''''''''''''''''''''''' - -**NAME** - -share\_usage\_with\_koha\_community.pl - Share your library's usage with -the Koha community - -**SYNOPSIS** - -share\_usage\_with\_koha\_community.pl [-h\|--help] [-v\|--verbose] - -If the `UsageStats <#UsageStats>`__ system preference is set, you can -launch this script to share your usage data anonymously with the Koha -community. - -Collecting Koha usage statistics will help developers to know how Koha -is used across the world. - -This script will send the usage data for the bibliographic and authority -records, checkouts, holds, orders, and subscriptions. - -Only the total number is retrieved. In no case will private data be -shared! - -In order to know which parts of Koha modules are used, this script will -collect some system preference values. - -If you want to tell us who you are, you can fill the -`UsageStatsLibraryName <#UsageStatsLibraryName>`__ system preference -with your library name, -`UsageStatsLibraryUrl <#UsageStatsLibraryUrl>`__, -`UsageStatsLibraryType <#UsageStatsLibraryType>`__ and/or -`UsageStatsCountry <#UsageStatsCountry>`__. - -All these data will be analyzed on the http://hea.koha-community.org -Koha community website. - -IMPORTANT : please do NOT run the cron on the 1st, but on another day. -The idea is to avoid all Koha libraries sending their data at the same -time ! So choose any day between 1 and 28 ! - -**OPTIONS** - --h\|--help - -Print a brief help message - --v\|--verbose - -Verbose mode. - --f\|--force - -Force the update. - -**AUTHOR** - -Alex Arnaud <alex.arnaud@biblibre.com> - -Jonathan Druart <jonathan.druart@biblibre.com> - -**COPYRIGHT** - -Copyright 2014 BibLibre - -**LICENSE** - -This file is part of Koha. - -Koha is free software; you can redistribute it and/or modify it under -the terms of the GNU General Public License as published by the Free -Software Foundation; either version 3 of the License, or (at your -option) any later version. - -You should have received a copy of the GNU General Public License along -with Koha; if not, write to the Free Software Foundation, Inc., 51 -Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. - -`Acquisitions <#acqcrons>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -`Clean up old suggestions <#cleansuggcron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/purge\_suggestions.pl - -Does: Removes old (defined by you) suggestions from the suggestion -management area. - -`Email suggestions to process <#emailsuggestfund>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/notice\_unprocessed\_suggestions.pl - -Does: Generates a notice to the fund owner that there are suggestions in -need of processing - -`Perl Documentation <#emailsuggestfundperl>`__ -'''''''''''''''''''''''''''''''''''''''''''''' - -**NAME** - -notice\_unprocessed\_suggestions.pl - Generate notification for -unprocessed suggestions. - -The budget owner will be notified. - -The letter template 'TO\_PROCESS' will be used. - -**SYNOPSIS** - -notice\_unprocessed\_suggestions.pl [-h\|--help] [-v\|--verbose] -[-c\|--confirm] [--days=NUMBER\_OF\_DAYS] - -**OPTIONS** - --h\|--help Print a brief help message - --c\|--confirm This flag must be provided in order for the script to -actually generate notices. If it is not supplied, the script will only -report on the patron it would have noticed. - ---days This parameter is mandatory. It must contain an integer -representing the number of days elapsed since the last modification of -suggestions to process. - --v\|--verbose Verbose mode. - -`EDI Message Processing <#edicron>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Script path: misc/cronjobs/edi\_cron.pl - -Does: Sends and received EDI messages - -Frequency: Every 15 minutes - -`Deprecated scripts <#deprecatedcrons>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -These should not be run without modification: - -Script path: misc/cronjobs/update\_items.pl - -Script path:misc/cronjobs/smsoverdues.pl - -Script path:misc/cronjobs/notifyMailsOp.pl - -Script path:misc/cronjobs/reservefix.pl - -Script path:misc/cronjobs/zebraqueue\_start.pl - -Web Services -============ - -`OAI-PMH <#OAI-PMHservice>`__ ------------------------------ - -For the Open Archives Initiative-Protocol for Metadata Harvesting -(OAI-PMH) there are two groups of 'participants': Data Providers and -Service Providers. Data Providers (open archives, repositories) provide -free access to metadata, and may, but do not necessarily, offer free -access to full texts or other resources. OAI-PMH provides an easy to -implement, low barrier solution for Data Providers. Service Providers -use the OAI interfaces of the Data Providers to harvest and store -metadata. Note that this means that there are no live search requests to -the Data Providers; rather, services are based on the harvested data via -OAI-PMH. - -Koha at present can only act as a Data Provider. It can not harvest from -other repositories. The biggest stumbling block to having Koha harvest -from other repositories is that MARC is the only metadata format that -Koha indexes natively. Visit -http://www.oaforum.org/tutorial/english/page3.htm for diagrams of how -OAI-PMH works. - -Learn more about OAI-PMH at: http://www.openarchives.org/pmh/ - -To enable OAI-PMH in Koha edit the `OAI-PMH <#OAI-PMH>`__ preference. -Once enabled you can visit http://YOURKOHACATALOG/cgi-bin/koha/oai.pl to -see your file. - -`Sample OAI Conf File <#oaiconfsample>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -:: - - format: - vs: - metadataPrefix: vs - metadataNamespace: http://veryspecial.tamil.fr/vs/format-pivot/1.1/vs - schema: http://veryspecial.tamil.fr/vs/format-pivot/1.1/vs.xsd - xsl_file: /usr/local/koha/xslt/vs.xsl - marcxml: - metadataPrefix: marxml - metadataNamespace: http://www.loc.gov/MARC21/slim - http://www.loc.gov/standards/marcxml/schema/MARC21slim - schema: http://www.loc.gov/MARC21/slim - http://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd - oai_dc: - metadataPrefix: oai_dc - metadataNamespace: http://www.openarchives.org/OAI/2.0/oai_dc/ - schema: http://www.openarchives.org/OAI/2.0/oai_dc.xsd - xsl_file: - /usr/local/koha/koha-tmpl/intranet-tmpl/xslt/UNIMARCslim2OAIDC.xsl - -`REST services <#Rest-services>`__ ----------------------------------- - -Koha can now be requested by REST http requests. BibLibre wrotes an -external module to adds more possibilities than ILS-DI can provide.There -is no authentication process, but authorized ips are listed in the -config file. Services have been tested in 3.10, 3.12 and 3.14 koha -versions. You can find more information about it into README file and -opac/rest.pl documentation on http://git.biblibre.com. If you want to -add features, send us a patch at dev\_patches AT biblibre DOT com. - -Services provided in 1.4 version are: - -:: - - GET branches - GET user/byid/:borrowernumber/holds - GET user/:user_name/holds - GET user/byid/:borrowernumber/issues - GET user/:user_name/issues - GET user/:user_name/issues_history - GET user/byid/:borrowernumber/issues_history - GET user/today - GET user/all - POST user - PUT user/:user_name - GET biblio/:biblionumber/items - GET biblio/:biblionumber/holdable - GET biblio/:biblionumber/items_holdable_status - GET item/:itemnumber/holdable - PUT auth/change_password - GET /suggestions - GET /suggestions/:suggestionid - POST /suggestions - PUT /suggestions/:suggestionid - DELETE /suggestions/:suggestionid - - -Using the SRU server -==================== - -`Using the SRU server <#usingsru>`__ ------------------------------------- - -Koha implements the Search/Retrieve via URL (SRU) protocol. More -information about the protocol itself can be found at -http://www.loc.gov/standards/sru/. The version implemented is version -1.1. - -`Explain <#sru_explain>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -If you want to have information about the implementation of SRU on a -given server, you should have access to the Explain file using a request -to the server without any parameter. Like -<http://myserver.com:9999/biblios/>. The response from the server is an -XML file that should look like the following and will give you -information about the default settings of the SRU server. - -:: - - <zs:explainResponse> - <zs:version>1.1</zs:version> - <zs:record> - <zs:recordSchema>http://explain.z3950.org/dtd/2.0/</zs:recordSchema> - <zs:recordPacking>xml</zs:recordPacking> - <zs:recordData> - <explain xml:base="zebradb/explain-biblios.xml"> - <!-- - try stylesheet url: http://./?stylesheet=docpath/sru2.xsl - --> - <serverInfo protocol="SRW/SRU/Z39.50"> - <host>biblibre</host> - <port>9999</port> - <database>biblios</database> - </serverInfo> - <databaseInfo> - <title lang="en" primary="true">Koha 3 Bibliographic SRU/SRW/Z39.50 server - Koha 3 Bibliographic Server - - http://biblibre:9999 - - - - - CQL Standard Set - - - CQL Server Choice - - serverChoice - - - text - - - - CQL All - - all - - - text - - - - - Record ID - - id - - - rec:id - 3 - - - - -`Search <#sru_search>`__ -~~~~~~~~~~~~~~~~~~~~~~~~ - -This url : -http://myserver.com:9999/biblios?version=1.1&operation=searchRetrieve&query=reefs -is composed of the following elements: - -- base url of the SRU server : http://myserver.com:9999/biblios? - -- search part with the 3 required parameters : version, operation and - query. The parameters within the search part should be of the - key=value form, and can be combined with the & character. - -One can add optional parameters to the query, for instance -maximumRecords indicating the maximum number of records to be returned -by the server. So -http://myserver.com:9999/biblios?version=1.1&operation=searchRetrieve&query=reefs&maximumRecords=5 -will only get the first 5 results results from the server. - -http://www.loc.gov/standards/sru/sru1-1archive/search-retrieve-operation.html -gives more details about the search operations and in particular the -list of optional parameters for searching. - -`More details about Search <#sru_search_more_details>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -The "operation" key can take two values: scan or searchRetrieve. - -If operation=searchRetrieve, then the search key should be query. As in -: operation=searchRetrieve&query=reefs - -If operation=scan, then the search key should be scanClause. As in : -operation=scan&scanClause=reefs - -etc/zebradb/biblios/etc/bib1.att defines Zebra/3950 indexes that exist -on your system. For instance you'll see that we have indexes for Subject -and for Title: att 21 Subject and att 4 Title respectively. - -In the pqf.properties file located under etc/zebradb/pqf.properties I -see that an access point already uses my Subject index (index.dc.subject -= 1=21) while another uses my Title index (index.dc.title = 1=4) I know -this is my Subject index because as I've seen just before in my bib1.att -file, it's called with =1=21 in Z3950: so index.dc.subject = 1=21 -correctly points to my Subject index. And Title was called with 1=4 so -index.dc.title = 1=4 correctly points to my Title index. I can now -construct my query just like I would in a search box, just preceding it -with the "query" key: query=Subject=reefs and Title=coral searches -"reefs" in the subject and "coral" in the title. The full url would be -http://myserver.com:9999/biblios?version=1.1&operation=searchRetrieve&query=Subject=reefs -and Title=coral If I want to limit the result set to just 5 records, I -can do -http://myserver.com:9999/biblios?version=1.1&operation=searchRetrieve&query=Subject=reefs -and Title=coral&maximumRecords=5 - -I can also play with truncate, relations, etc. Those are also defined in -my pqf.properties file. I can see for instance the position properties -defined as: - -:: - - position.first = 3=1 6=1 - # "first in field" - position.any = 3=3 6=1 - # "any position in field" - - -So as an example if I want "coral" to be at the beginning of the title, -I can do this query : -http://myserver.com:9999/biblios?version=1.1&operation=searchRetrieve&query=Title=coral -first - -`Retrieve <#sru_retrieve>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -My search for -http://univ\_lyon3.biblibre.com:9999/biblios?version=1.1&operation=searchRetrieve&query=coral -reefs&maximumRecords=1 retrieves just on record. The response looks like -this: - -:: - - - 1.1 - 1 - - - xml - - - cam a22 4500 - - 2-603-01193-6 - rel. - 159 F - - - FR - 00065351 - - - ita - - - a z 00|y| - - - r - - - 20091130 frey50 - - - Guide des récifs coralliens / A Guide to Coral Reefs - Texte imprimé - la faune sous-marine des coraux - A. et A. Ferrari - - - Lausanne - Paris - Delachaux et Niestlé - cop. 2000 - impr. en Espagne - - - 287 p. - ill. en coul., couv. ill. en coul. - 20 cm - - ...... - - 4725 - 2 - /tmp/nw10BJv9Pk/upd_biblio/exported_records - - - - 1 - - - - - - -New titles slider for OPAC -========================== - -Often times libraries will want to add a flowing widget with new -materials at the library to their main public catalog page. To do this -you can use a widget from any number of services (usually for a cost) or -you can `enable plugins <#pluginsystem>`__ in Koha and use the `Cover -Flow -plugin `__ -which is based on the -`Flipster `__, a responsive -jQuery coverflow plugin. - -Once the plugin is installed, the steps to get your coverflow to show up -are as follows: - -First, you need to create one or more public reports for your coverflow -widget or widgets to be based on. This is how the plugin knows what the -content of your widget should contain. Each report needs only three -columns; title, biblionumber, and isbn. It is important that you have a -good and valid isbn, as that is the datum used to actually fetch the -cover. In the iteration of the plugin, we are using Amazon cover images, -but I believe in the end I will make the cover image fetcher -configurable so we can use any data source for cover image fetching. - -Second, we need to configure the plugin. The plugin configuration is a -single text area that uses YAML ( actually, it’s JSON, whcih is a subset -of YAML ) to store the configuration options. In this example it looks -like this: - -:: - - - id: 42 - selector: #coverflow - options: - style: coverflow - -In this example, we are telling the plugin to use the report with id 42, -and use it to create a coverflow widget to replace the HTML element with -the id “coverflow”. The options list is passed directly to Flipster, so -any options supported by Flipster can be set from the plugin -configuration! In fact, in addition to the traditional coverflow, -Flipster has a “carousel” mode which is a much more compact version of -the coverflow. You can also configure which cover the widget will start -on, among other options. - -At the time the plugins options are saved or updated, the plugin will -then generate some minified JavaScript code that is automatically stored -in the Koha system preference OPACUserJS. Here is an example of the -output: - -:: - - /* JS for Koha CoverFlow Plugin - This JS was added automatically by installing the CoverFlow plugin - Please do not modify */$(document).ready(function(){$.getScript("/plugin/Koha/Plugin/Com/ByWaterSolutions/CoverFlow/jquery-flipster/src/js/jquery.flipster.min.js",function(data,textStatus,jqxhr){$("head").append("");$('#coverflow').load("/coverflow.pl?id=42",function(){var opt={'items':'.item','minfactor':15,'distribution':1.5,'scalethreshold':0,'staticbelowthreshold':false,'titleclass':'itemTitle','selectedclass':'selectedItem','scrollactive':true,'step':{'limit':4,'width':10,'scale':true}};$('#coverflow').flipster({style:'coverflow',});});});}); - /* End of JS for Koha CoverFlow Plugin */ - -Why do this? For speed! Rather than regenerating this code each and -every time the page loads, we can generate it once, and use it over and -over again. - -If you inspect the code closely, you’ll notice it references a script -“coverflow.pl”. This is a script that is included with the coverflow -plugin. Since we need to access this from the OPAC ( and we don’t want -to set off any XSS attack alarms ), we need to modify the web server -configuration for the public catalog and add the followup to it: - -:: - - ScriptAlias /coverflow.pl "/var/lib/koha/mykoha/plugins/Koha/Plugin/Com/ByWaterSolutions/CoverFlow/coverflow.pl" - -This line gives us access to the coverflow.pl script from the OPAC. This -script retrieves the report data and passes it back to the public -catalog for creating the coverflow widget. Koha::Cache is supported in -order to make the widget load as quickly as possible! - -The final step is to put your selector element somewhere in your public -catalog. In this example, I put the following in the system preference -OpacMainUserBlock: - -:: - - Loading... - -Once that is in place, you need only refresh your OPAC page, and there -you have it, your very own catalog coverflow widget! Not only do these -coverflows look great on a computer screen, but they look great on -mobile platforms as well, and are even touch responsive!Coverflow Widget - -System Preference Defaults -========================== - -`ISBD Defaults <#isbddefaults>`__ ---------------------------------- - -Default values for the `ISBD <#isbdpref>`__ preference. - -`MARC Default <#isbddefault>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -#100\|\|{ 100a }{ 100b }{ 100c }{ 100d }{ 110a }{ 110b }{ 110c }{ 110d -}{ 110e }{ 110f }{ 110g }{ 130a }{ 130d }{ 130f }{ 130g }{ 130h }{ 130k -}{ 130l }{ 130m }{ 130n }{ 130o }{ 130p }{ 130r }{ 130s }{ 130t -}\|

- -#245\|\|{ 245a }{ 245b }{245f }{ 245g }{ 245k }{ 245n }{ 245p }{ 245s }{ -245h }\| - -#246\|\|{ : 246i }{ 246a }{ 246b }{ 246f }{ 246g }{ 246n }{ 246p }{ 246h -}\| - -#242\|\|{ = 242a }{ 242b }{ 242n }{ 242p }{ 242h }\| - -#245\|\|{ 245c }\| - -#242\|\|{ = 242c }\| - -#250\| - \|{ 250a }{ 250b }\| - -#254\|, \|{ 254a }\| - -#255\|, \|{ 255a }{ 255b }{ 255c }{ 255d }{ 255e }{ 255f }{ 255g }\| - -#256\|, \|{ 256a }\| - -#257\|, \|{ 257a }\| - -#258\|, \|{ 258a }{ 258b }\| - -#260\| - \|{ 260a }{ 260b }{ 260c }\| - -#300\| - \|{ 300a }{ 300b }{ 300c }{ 300d }{ 300e }{ 300f }{ 300g }\| - -#306\| - \|{ 306a }\| - -#307\| - \|{ 307a }{ 307b }\| - -#310\| - \|{ 310a }{ 310b }\| - -#321\| - \|{ 321a }{ 321b }\| - -#340\| - \|{ 3403 }{ 340a }{ 340b }{ 340c }{ 340d }{ 340e }{ 340f }{ -340h }{ 340i }\| - -#342\| - \|{ 342a }{ 342b }{ 342c }{ 342d }{ 342e }{ 342f }{ 342g }{ -342h }{ 342i }{ 342j }{ 342k }{ 342l }{ 342m }{ 342n }{ 342o }{ 342p }{ -342q }{ 342r }{ 342s }{ 342t }{ 342u }{ 342v }{ 342w }\| - -#343\| - \|{ 343a }{ 343b }{ 343c }{ 343d }{ 343e }{ 343f }{ 343g }{ -343h }{ 343i }\| - -#351\| - \|{ 3513 }{ 351a }{ 351b }{ 351c }\| - -#352\| - \|{ 352a }{ 352b }{ 352c }{ 352d }{ 352e }{ 352f }{ 352g }{ -352i }{ 352q }\| - -#362\| - \|{ 362a }{ 351z }\| - -#440\| - \|{ 440a }{ 440n }{ 440p }{ 440v }{ 440x }\|. - -#490\| - \|{ 490a }{ 490v }{ 490x }\|. - -#800\| - \|{ 800a }{ 800b }{ 800c }{ 800d }{ 800e }{ 800f }{ 800g }{ -800h }{ 800j }{ 800k }{ 800l }{ 800m }{ 800n }{ 800o }{ 800p }{ 800q }{ -800r }{ 800s }{ 800t }{ 800u }{ 800v }\|. - -#810\| - \|{ 810a }{ 810b }{ 810c }{ 810d }{ 810e }{ 810f }{ 810g }{ -810h }{ 810k }{ 810l }{ 810m }{ 810n }{ 810o }{ 810p }{ 810r }{ 810s }{ -810t }{ 810u }{ 810v }\|. - -#811\| - \|{ 811a }{ 811c }{ 811d }{ 811e }{ 811f }{ 811g }{ 811h }{ -811k }{ 811l }{ 811n }{ 811p }{ 811q }{ 811s }{ 811t }{ 811u }{ 811v -}\|. - -#830\| - \|{ 830a }{ 830d }{ 830f }{ 830g }{ 830h }{ 830k }{ 830l }{ -830m }{ 830n }{ 830o }{ 830p }{ 830r }{ 830s }{ 830t }{ 830v }\|. - -#500\|

\|{ 5003 }{ 500a }\| - -#501\|

\|{ 501a }\| - -#502\|

\|{ 502a }\| - -#504\|

\|{ 504a }\| - -#505\|

\|{ 505a }{ 505t }{ 505r }{ 505g }{ 505u }\| - -#506\|

\|{ 5063 }{ 506a }{ 506b }{ 506c }{ 506d }{ 506u }\| - -#507\|

\|{ 507a }{ 507b }\| - -#508\|

\|{ 508a }{ 508a }\| - -#510\|

\|{ 5103 }{ 510a }{ 510x }{ 510c }{ 510b }\| - -#511\|

\|{ 511a }\| - -#513\|

\|{ 513a }{513b }\| - -#514\|

\|{ 514z }{ 514a }{ 514b }{ 514c }{ 514d }{ 514e }{ 514f -}{ 514g }{ 514h }{ 514i }{ 514j }{ 514k }{ 514m }{ 514u }\| - -#515\|

\|{ 515a }\| - -#516\|

\|{ 516a }\| - -#518\|

\|{ 5183 }{ 518a }\| - -#520\|

\|{ 5203 }{ 520a }{ 520b }{ 520u }\| - -#521\|

\|{ 5213 }{ 521a }{ 521b }\| - -#522\|

\|{ 522a }\| - -#524\|

\|{ 524a }\| - -#525\|

\|{ 525a }\| - -#526\|

\|{\\n510i }{\\n510a }{ 510b }{ 510c }{ 510d }{\\n510x -}\| - -#530\|

\|{\\n5063 }{\\n506a }{ 506b }{ 506c }{ 506d }{\\n506u -}\| - -#533\|

\|{\\n5333 }{\\n533a }{\\n533b }{\\n533c }{\\n533d -}{\\n533e }{\\n533f }{\\n533m }{\\n533n }\| - -#534\|

\|{\\n533p }{\\n533a }{\\n533b }{\\n533c }{\\n533d -}{\\n533e }{\\n533f }{\\n533m }{\\n533n }{\\n533t }{\\n533x }{\\n533z -}\| - -#535\|

\|{\\n5353 }{\\n535a }{\\n535b }{\\n535c }{\\n535d }\| - -#538\|

\|{\\n5383 }{\\n538a }{\\n538i }{\\n538u }\| - -#540\|

\|{\\n5403 }{\\n540a }{ 540b }{ 540c }{ 540d }{\\n520u -}\| - -#544\|

\|{\\n5443 }{\\n544a }{\\n544b }{\\n544c }{\\n544d -}{\\n544e }{\\n544n }\| - -#545\|

\|{\\n545a }{ 545b }{\\n545u }\| - -#546\|

\|{\\n5463 }{\\n546a }{ 546b }\| - -#547\|

\|{\\n547a }\| - -#550\|

\|{ 550a }\| - -#552\|

\|{ 552z }{ 552a }{ 552b }{ 552c }{ 552d }{ 552e }{ 552f -}{ 552g }{ 552h }{ 552i }{ 552j }{ 552k }{ 552l }{ 552m }{ 552n }{ 562o -}{ 552p }{ 552u }\| - -#555\|

\|{ 5553 }{ 555a }{ 555b }{ 555c }{ 555d }{ 555u }\| - -#556\|

\|{ 556a }{ 506z }\| - -#563\|

\|{ 5633 }{ 563a }{ 563u }\| - -#565\|

\|{ 5653 }{ 565a }{ 565b }{ 565c }{ 565d }{ 565e }\| - -#567\|

\|{ 567a }\| - -#580\|

\|{ 580a }\| - -#581\|

\|{ 5633 }{ 581a }{ 581z }\| - -#584\|

\|{ 5843 }{ 584a }{ 584b }\| - -#585\|

\|{ 5853 }{ 585a }\| - -#586\|

\|{ 5863 }{ 586a }\| - -#020\|

\|{ 020a }{ 020c }\| - -#022\|

\|{ 022a }\| - -#222\| = \|{ 222a }{ 222b }\| - -#210\| = \|{ 210a }{ 210b }\| - -#024\|

\|{ 024a }{ 024c }{ 024d }{ -0242 }\| - -#027\|

\|{ 027a }\| - -#028\|

\|{ 028a }{ 028b }\| - -#013\|

\|{ 013a }{ 013b }{ 013c }{ -013d }{ 013e }{ 013f }\| - -#030\|

\|{ 030a }\| - -#037\|

\|{ 037a }{ 037b }{ 037c }{ 037f -}{ 037g }{ 037n }\| - -#010\|

\|{ 010a }\| - -#015\|

\|{ 015a }{ 0152 }\| - -#016\|

\|{ 016a }{ -0162 }\| - -#600\|

\|{\\n6003 -}{\\n600a}{ 600b }{ 600c }{ 600d }{ 600e }{ 600f }{ 600g }{ 600h -}{--600k}{ 600l }{ 600m }{ 600n }{ 600o }{--600p}{ 600r }{ 600s }{ 600t -}{ 600u }{--600x}{--600z}{--600y}{--600v}\| - -#610\|

\|{\\n6103 -}{\\n610a}{ 610b }{ 610c }{ 610d }{ 610e }{ 610f }{ 610g }{ 610h -}{--610k}{ 610l }{ 610m }{ 610n }{ 610o }{--610p}{ 610r }{ 610s }{ 610t -}{ 610u }{--610x}{--610z}{--610y}{--610v}\| - -#611\|

\|{\\n6113 -}{\\n611a}{ 611b }{ 611c }{ 611d }{ 611e }{ 611f }{ 611g }{ 611h -}{--611k}{ 611l }{ 611m }{ 611n }{ 611o }{--611p}{ 611r }{ 611s }{ 611t -}{ 611u }{--611x}{--611z}{--611y}{--611v}\| - -#630\|

\|{\\n630a}{ -630b }{ 630c }{ 630d }{ 630e }{ 630f }{ 630g }{ 630h }{--630k }{ 630l }{ -630m }{ 630n }{ 630o }{--630p}{ 630r }{ 630s }{ 630t -}{--630x}{--630z}{--630y}{--630v}\| - -#648\|

\|{\\n6483 -}{\\n648a }{--648x}{--648z}{--648y}{--648v}\| - -#650\|

\|{\\n6503 -}{\\n650a}{ 650b }{ 650c }{ 650d }{ 650e -}{--650x}{--650z}{--650y}{--650v}\| - -#651\|

\|{\\n6513 -}{\\n651a}{ 651b }{ 651c }{ 651d }{ 651e -}{--651x}{--651z}{--651y}{--651v}\| - -#653\|

\|{ 653a }\| - -#654\|

\|{\\n6543 -}{\\n654a}{--654b}{--654x}{--654z}{--654y}{--654v}\| - -#655\|

\|{\\n6553 -}{\\n655a}{--655b}{--655x }{--655z}{--655y}{--655v}\| - -#656\|

\|{\\n6563 -}{\\n656a}{--656k}{--656x}{--656z}{--656y}{--656v}\| - -#657\|

\|{\\n6573 -}{\\n657a}{--657x}{--657z}{--657y}{--657v}\| - -#658\|

\|{\\n658a}{--658b}{--658c}{--658d}{--658v}\| - -#050\|

\|{ 050a }{ / 050b }\| - -#082\|

\|{ 082a }{ / 082b }\| - -#080\|

\|{ 080a }{ -080x }{ / 080b }\| - -#070\|

\|{ 070a }{ / 070b }\| - -#060\|

\|{ 060a }{ / 060b }\| - -#074\|

\|{ 074a }\| - -#086\|

\|{ 086a }\| - -#088\|

\|{ 088a }\| - -`UNIMARC Default <#unimarcdefault>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -#200\|

Title : \|{200a}{. 200c}{ : 200e}{200d}{. 200h}{. 200i}\|

- -#461\|\|{461t}{N∞ -461h} {v. 461v}{(461d)}
\| - -#200b\|\| {200b -}\|
- -#101a\|\|{101a}\|
- -#200f\|\|{200f -; }\|
- -#200g\|\|{200g -; }\|
- -#210a\|
\|{210a}\|
- -#210c\|\|{210c -; }\|
- -#210d\|\|{ -210d}\|
- -#215\|\|{215a}{ : 215c}{ ; -215d}{ + 215e}\|
- -#225a\|\|{225a -;} \| - -#225\|\|{ = 225d}{ : 225e}{. 225h}{. 225i}{ / 225f}{, 225x}{ ; -225v}\|
- -#686\|\|{ 686a }\|
- -#608\|\|{ 608a}\|

- -#200\|\|
\|\| - -#856\|\|click here to go to the external resource
- -#010\|\|{010a ;}\|
- -#011\|\|{011a ;}\|
- -#200\|\|\|
    - -#300\|\|
  • {300a}
    • \| - -#307\|\|
  • {307a}
    • \| - -#310\|\|
  • {310a}
    • \| - -#326\|\|
  • {326a}
    • \| - -#327\|\|
  • {327a}
    • \| - -#333\|
  • Public : \|{333a}
    • \| - -#200\|\|
\| - -#330\|\|\|
- -#330\|\|{330a}\|
- -#200\|\|

Items

\| - -#200\|\|\| - -#995\|\|\|
Call numberCopy -noteFondsGenre detailCirculation -typeBarcode
{995k} {995u} -{995y}{995e}   -{995o}{995f}
- -`OPACISBD Defaults <#opacisbddefaults>`__ ------------------------------------------ - -Default values for the `OPACISBD <#OPACISBD>`__ preference. - -`MARC <#opacisbdmarcdefault>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -#100\|\|{ 100a }{ 100b }{ 100c }{ 100d }{ 110a }{ 110b }{ 110c }{ 110d -}{ 110e }{ 110f }{ 110g }{ 130a }{ 130d }{ 130f }{ 130g }{ 130h }{ 130k -}{ 130l }{ 130m }{ 130n }{ 130o }{ 130p }{ 130r }{ 130s }{ 130t -}\|

- -#245\|\|{ 245a }{ 245b }{245f }{ 245g }{ 245k }{ 245n }{ 245p }{ 245s }{ -245h }\| - -#246\|\|{ : 246i }{ 246a }{ 246b }{ 246f }{ 246g }{ 246n }{ 246p }{ 246h -}\| - -#242\|\|{ = 242a }{ 242b }{ 242n }{ 242p }{ 242h }\| - -#245\|\|{ 245c }\| - -#242\|\|{ = 242c }\| - -#250\| - \|{ 250a }{ 250b }\| - -#254\|, \|{ 254a }\| #255\|, \|{ 255a }{ 255b }{ 255c }{ 255d }{ 255e }{ -255f }{ 255g }\| #256\|, \|{ 256a }\| - -#257\|, \|{ 257a }\| - -#258\|, \|{ 258a }{ 258b }\| - -#260\| - \|{ 260a }{ 260b }{ 260c }\| - -#300\| - \|{ 300a }{ 300b }{ 300c }{ 300d }{ 300e }{ 300f }{ 300g }\| - -#306\| - \|{ 306a }\| #307\| - \|{ 307a }{ 307b }\| - -#310\| - \|{ 310a }{ 310b }\| - -#321\| - \|{ 321a }{ 321b }\| - -#340\| - \|{ 3403 }{ 340a }{ 340b }{ 340c }{ 340d }{ 340e }{ 340f }{ -340h }{ 340i }\| - -#342\| - \|{ 342a }{ 342b }{ 342c }{ 342d }{ 342e }{ 342f }{ 342g }{ -342h }{ 342i }{ 342j }{ 342k }{ 342l }{ 342m }{ 342n }{ 342o }{ 342p }{ -342q }{ 342r }{ 342s }{ 342t }{ 342u }{ 342v }{ 342w }\| - -#343\| - \|{ 343a }{ 343b }{ 343c }{ 343d }{ 343e }{ 343f }{ 343g }{ -343h }{ 343i }\| - -#351\| - \|{ 3513 }{ 351a }{ 351b }{ 351c }\| - -#352\| - \|{ 352a }{ 352b }{ 352c }{ 352d }{ 352e }{ 352f }{ 352g }{ -352i }{ 352q }\| - -#362\| - \|{ 362a }{ 351z }\| - -#440\| - \|{ 440a }{ 440n }{ 440p }{ 440v }{ 440x }\|. #490\| - \|{ 490a -}{ 490v }{ 490x }\|. - -#800\| - \|{ 800a }{ 800b }{ 800c }{ 800d }{ 800e }{ 800f }{ 800g }{ -800h }{ 800j }{ 800k }{ 800l }{ 800m }{ 800n }{ 800o }{ 800p }{ 800q }{ -800r }{ 800s }{ 800t }{ 800u }{ 800v }\|. - -#810\| - \|{ 810a }{ 810b }{ 810c }{ 810d }{ 810e }{ 810f }{ 810g }{ -810h }{ 810k }{ 810l }{ 810m }{ 810n }{ 810o }{ 810p }{ 810r }{ 810s }{ -810t }{ 810u }{ 810v }\|. - -#811\| - \|{ 811a }{ 811c }{ 811d }{ 811e }{ 811f }{ 811g }{ 811h }{ -811k }{ 811l }{ 811n }{ 811p }{ 811q }{ 811s }{ 811t }{ 811u }{ 811v -}\|. - -#830\| - \|{ 830a }{ 830d }{ 830f }{ 830g }{ 830h }{ 830k }{ 830l }{ -830m }{ 830n }{ 830o }{ 830p }{ 830r }{ 830s }{ 830t }{ 830v }\|. - -#500\|

\|{ 5003 }{ 500a }\| - -#501\|

\|{ 501a }\| - -#502\|

\|{ 502a }\| - -#504\|

\|{ 504a }\| - -#505\|

\|{ 505a }{ 505t }{ 505r }{ 505g }{ 505u }\| - -#506\|

\|{ 5063 }{ 506a }{ 506b }{ 506c }{ 506d }{ 506u }\| - -#507\|

\|{ 507a }{ 507b }\| #508\|

\|{ 508a }{ 508a -}\| - -#510\|

\|{ 5103 }{ 510a }{ 510x }{ 510c }{ 510b }\| - -#511\|

\|{ 511a }\| - -#513\|

\|{ 513a }{513b }\| - -#514\|

\|{ 514z }{ 514a }{ 514b }{ 514c }{ 514d }{ 514e }{ 514f -}{ 514g }{ 514h }{ 514i }{ 514j }{ 514k }{ 514m }{ 514u }\| - -#515\|

\|{ 515a }\| - -#516\|

\|{ 516a }\| - -#518\|

\|{ 5183 }{ 518a }\| - -#520\|

\|{ 5203 }{ 520a }{ 520b }{ 520u }\| - -#521\|

\|{ 5213 }{ 521a }{ 521b }\| - -#522\|

\|{ 522a }\| - -#524\|

\|{ 524a }\| - -#525\|

\|{ 525a }\| - -#526\|

\|{\\n510i }{\\n510a }{ 510b }{ 510c }{ 510d }{\\n510x -}\| - -#530\|

\|{\\n5063 }{\\n506a }{ 506b }{ 506c }{ 506d }{\\n506u -}\| - -#533\|

\|{\\n5333 }{\\n533a }{\\n533b }{\\n533c }{\\n533d -}{\\n533e }{\\n533f }{\\n533m }{\\n533n }\| - -#534\|

\|{\\n533p }{\\n533a }{\\n533b }{\\n533c }{\\n533d -}{\\n533e }{\\n533f }{\\n533m }{\\n533n }{\\n533t }{\\n533x }{\\n533z -}\| - -#535\|

\|{\\n5353 }{\\n535a }{\\n535b }{\\n535c }{\\n535d }\| - -#538\|

\|{\\n5383 }{\\n538a }{\\n538i }{\\n538u }\| - -#540\|

\|{\\n5403 }{\\n540a }{ 540b }{ 540c }{ 540d }{\\n520u -}\| - -#544\|

\|{\\n5443 }{\\n544a }{\\n544b }{\\n544c }{\\n544d -}{\\n544e }{\\n544n }\| - -#545\|

\|{\\n545a }{ 545b }{\\n545u }\| -#546\|

\|{\\n5463 }{\\n546a }{ 546b }\| - -#547\|

\|{\\n547a }\| #550\|

\|{ 550a }\| - -#552\|

\|{ 552z }{ 552a }{ 552b }{ 552c }{ 552d }{ 552e }{ 552f -}{ 552g }{ 552h }{ 552i }{ 552j }{ 552k }{ 552l }{ 552m }{ 552n }{ 562o -}{ 552p }{ 552u }\| - -#555\|

\|{ 5553 }{ 555a }{ 555b }{ 555c }{ 555d }{ 555u }\| - -#556\|

\|{ 556a }{ 506z }\| #563\|

\|{ 5633 }{ 563a }{ -563u }\| - -#565\|

\|{ 5653 }{ 565a }{ 565b }{ 565c }{ 565d }{ 565e }\| - -#567\|

\|{ 567a }\| - -#580\|

\|{ 580a }\| - -#581\|

\|{ 5633 }{ 581a }{ 581z }\| - -#584\|

\|{ 5843 }{ 584a }{ 584b }\| - -#585\|

\|{ 5853 }{ 585a }\| - -#586\|

\|{ 5863 }{ 586a }\| - -#020\|

\|{ 020a }{ 020c }\| - -#022\|

\|{ 022a }\| - -#222\| = \|{ 222a }{ 222b }\| - -#210\| = \|{ 210a }{ 210b }\| - -#024\|

\|{ 024a }{ 024c }{ 024d }{ -0242 }\| - -#027\|

\|{ 027a }\| - -#028\|

\|{ 028a }{ 028b }\| - -#013\|

\|{ 013a }{ 013b }{ 013c }{ -013d }{ 013e }{ 013f }\| - -#030\|

\|{ 030a }\| - -#037\|

\|{ 037a }{ 037b }{ 037c }{ 037f -}{ 037g }{ 037n }\| - -#010\|

\|{ 010a }\| - -#015\|

\|{ 015a }{ 0152 }\| - -#016\|

\|{ 016a }{ -0162 }\| - -#600\|

\|{\\n6003 -}{\\n600a}{ 600b }{ 600c }{ 600d }{ 600e }{ 600f }{ 600g }{ 600h -}{--600k}{ 600l }{ 600m }{ 600n }{ 600o }{--600p}{ 600r }{ 600s }{ 600t -}{ 600u }{--600x}{--600z}{--600y}{--600v}\| - -#610\|

\|{\\n6103 -}{\\n610a}{ 610b }{ 610c }{ 610d }{ 610e }{ 610f }{ 610g }{ 610h -}{--610k}{ 610l }{ 610m }{ 610n }{ 610o }{--610p}{ 610r }{ 610s }{ 610t -}{ 610u }{--610x}{--610z}{--610y}{--610v}\| - -#611\|

\|{\\n6113 -}{\\n611a}{ 611b }{ 611c }{ 611d }{ 611e }{ 611f }{ 611g }{ 611h -}{--611k}{ 611l }{ 611m }{ 611n }{ 611o }{--611p}{ 611r }{ 611s }{ 611t -}{ 611u }{--611x}{--611z}{--611y}{--611v}\| - -#630\|

\|{\\n630a}{ -630b }{ 630c }{ 630d }{ 630e }{ 630f }{ 630g }{ 630h }{--630k }{ 630l }{ -630m }{ 630n }{ 630o }{--630p}{ 630r }{ 630s }{ 630t -}{--630x}{--630z}{--630y}{--630v}\| - -#648\|

\|{\\n6483 -}{\\n648a }{--648x}{--648z}{--648y}{--648v}\| -#650\|

\|{\\n6503 -}{\\n650a}{ 650b }{ 650c }{ 650d }{ 650e -}{--650x}{--650z}{--650y}{--650v}\| - -#651\|

\|{\\n6513 -}{\\n651a}{ 651b }{ 651c }{ 651d }{ 651e -}{--651x}{--651z}{--651y}{--651v}\| - -#653\|

\|{ 653a }\| - -#654\|

\|{\\n6543 -}{\\n654a}{--654b}{--654x}{--654z}{--654y}{--654v}\| - -#655\|

\|{\\n6553 -}{\\n655a}{--655b}{--655x }{--655z}{--655y}{--655v}\| - -#656\|

\|{\\n6563 -}{\\n656a}{--656k}{--656x}{--656z}{--656y}{--656v}\| - -#657\|

\|{\\n6573 -}{\\n657a}{--657x}{--657z}{--657y}{--657v}\| - -#658\|

\|{\\n658a}{--658b}{--658c}{--658d}{--658v}\| - -#050\|

\|{ 050a }{ / 050b }\| - -#082\|

\|{ 082a }{ / 082b }\| - -#080\|

\|{ 080a }{ -080x }{ / 080b }\| - -#070\|

\|{ 070a }{ / 070b }\| - -#060\|

\|{ 060a }{ / 060b }\| - -#074\|

\|{ 074a }\| - -#086\|

\|{ 086a }\| - -#088\|

\|{ 088a }\| - -Configuring Receipt Printers -============================ - -The following instructions are for specific receipt printers, but can -probably be used to help with setup of other brands as well. - -`For Epson TM-T88III (3) & TM-T88IV (4) Printers <#epsonprinters>`__ --------------------------------------------------------------------- - -`In the Print Driver <#epsonprintdriver>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -For these instructions, we are using version 5,0,3,0 of the Epson -TM-T88III print driver; the EPSON TM-T88IV version is ReceiptE4. -Register at the `EpsonExpert Technical Resource Center -website `__ to gain access to the -drivers; go to Technical Resources, then choose the printer model from -the Printers drop-down list. - -Click Start > Printers and Faxes > Right click the receipt printer > -Properties: - -- Advanced Tab, click Printing Defaults button - -- Layout Tab: Paper size: Roll Paper 80 x 297mm - -- TM-T88III: Layout Tab: Check Reduce Printing and Fit to Printable - Width - -- TM-T88IV: Check Reduced Size Print; Click OK on the popup window that - appears. Fit to Printable Width should be automatically selected. - -- OK your way out of there. - -`In Firefox <#epsonfirefox>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Under File > Page Setup: - -- Shrink to fit page on Format & Options tab - -- 0,0,0,0 for Margins on Margins & Header/Footer Tab. This makes the - receipts use all available space on the paper roll. - -- Set all Headers/Footers to -blank-. This removes all of the gunk you - might normally find on a print from Firefox, such as the URL, number - of pages, etc. - -- Click OK - -Set the default printer settings in Firefox so you don't see a "Print" -dialog: - -- Go to File > Print - -- Set the Printer to the receipt printer. - -- Click the Advanced (or Properties) button - -- Layout Tab: Paper size: Roll Paper 80 x 297mm - -- TM-T88III: Layout Tab: Check Reduce Printing and Fit to Printable - Width - -- TM-T88IV: Check Reduced Size Print; click OK on the popup window that - appears. Fit to Printable Width should be automatically selected. - -- OK your way out, go ahead and print whatever page you are on. - -- Type about:config, in the address bar. Click "I'll be careful, I - promise!" on the warning message. - -- Type, print.always in Filter. - -- Look for print.always\_print\_silent. - - - If the preference is there then set the value to true. - -- If the preference is not there (and it shouldn't be in most browsers) - you have to add the preference. - - - Right click the preference area and select New > Boolean - - - Type print.always\_print\_silent in the dialog box and set the - value to True. This sets the print settings in Firefox to always - use the same settings and print without showing a dialog box. - - **Warning** - - Setting the print.always\_print\_silent setting in about:config - DISABLES the ability to choose a printer in Firefox. - -`For Epson TM-T88II (2) Printers <#epson2>`__ ---------------------------------------------- - -Register at the `EpsonExpert Technical Resource Center -website `__ to gain access to the -drivers; go to Technical Resources, then choose the printer model from -the Printers drop-down list. - -`In Firefox <#epson2firefox>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Under File > Page Setup: - -- Shrink to fit page on Format & Options tab - -- 0,0,0,0 for Margins on Margins & Header/Footer Tab. This makes the - receipts use all available space on the paper roll. - -- Set all Headers/Footers to -blank-. This removes all of the gunk you - might normally find on a print from Firefox, such as the URL, number - of pages, etc. - -- Click OK - -Set the default printer settings in Firefox so you don't see a "Print" -dialog: - -- Go to File > Print - -- Set the Printer to the receipt printer. - -- Print whatever page you are on. - -- Type about:config, in the address bar. Click "I'll be careful, I - promise!" on the warning message. - -- Type, print.always in Filter. - -- Look for, print.always\_print\_silent. - - - If the preference is there then set the value to true. - -- If the preference is not there (and it shouldn't be in most browsers) - you have to add the preference. - - - Right click the preference area and select New > Boolean - - - Type, print.always\_print\_silent in the dialog box and set the - value to True. This sets the print settings in Firefox to always - use the same settings and print without showing a dialog box. - - **Warning** - - Setting the print.always\_print\_silent setting in about:config - DISABLES the ability to choose a printer in Firefox. - -`For Star SP542 Printers <#starprinter>`__ ------------------------------------------- - -`Installing the Printer <#installstarprinter>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -While the following comments are based on the Star SP542 receipt -printer, they probably apply to all printers in the SP5xx series. - -The Star SP542 receipt printer works well with Koha and **Firefox on -Windows XP SP3**. This printer, with either the parallel or USB -interface, is fairly easy to install and configure. You will need the -following executable file which is available from numerous places on the -Internet: - -linemode\_2k-xp\_20030205.exe - -This executable actually does all of the installation; you will not need -to use the Microsoft Windows "Add Printer" program. We recommend that -when installing, the option for the software monitor not be selected; we -have experienced significant pauses and delays in printing with it. -Instead, simply choose to install the receipt printer without the -monitor. - -Additionally, the install program may not put the printer on the correct -port, especially if using the USB interface. This is easily corrected by -going to "Start -> Printers and Faxes -> Properties for the SP542 -printer -> Ports", then check the appropriate port. - -A reboot may be required, even if not indicated by the installation -software or the operating system. - -**Windows 7** users should refer to this page: -http://www.starmicronics.com/supports/win7.aspx. - -`Configuring Firefox to Print to Receipt Printer <#firefoxreceipt>`__ ---------------------------------------------------------------------- - -- Open File > Page Setup - -- Make all the headers and footers blank - -- Set the margins to 0 (zero) - -- In the address bar of Firefox, type about:config - -- Search for print.always\_print\_silent and double click it - -- Change it from false to true - - - This lets you skip the Print pop up box that comes up, as well as - skipping the step where you have to click OK, automatically - printing the right sized slip. - -- If print.always\_print\_silent does not come up - - - Right click on a blank area of the preference window - - - Select new > Boolean - - - Enter "print.always\_print\_silent" as the name (without quotes) - - - Click OK - - - Select true for the value - -- You may also want to check what is listed for print.print\_printer - - - You may have to choose Generic/Text Only (or whatever your receipt - printer might be named) - -Notice & Slips Guides -===================== - -`Field Guide for Notices & Slips <#noticesfieldguide>`__ --------------------------------------------------------- - -This guide will break down the notices and slips information in 3 ways. -First it will tell you what file generates the notice, then how you will -present the item info in that notice and finally if the notice can be -branch specific or not. - -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| Letter Code | Used In | Detail tag | Can be branch specific | -+=====================+============================+=======================================+==========================+ -| DUE | advance\_notices.pl | <> | No | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| DUEDGST | advance\_notices.pl | <> | No | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| PREDUE | advance\_notices.pl | <> | No | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| PREDUEDGST | advance\_notices.pl | <> | No | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| ODUE\* | overdue\_notices.pl | <> or | Yes | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| CHECKOUT | C4/Circulation.pm | N/A | Yes | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| RENEWAL | C4/Circulation.pm | N/A | Yes | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| TRANSFERSLIP | C4/Circulation.pm | N/A | Yes | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| ISSUESLIP | C4/Members.pm | | Yes | -| | | | | -| | | | | -| | | | | -| | | | | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| ISSUEQSLIP | C4/Members.pm | | Yes | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| HOLDPLACED | C4/Reserves.pm | N/A | Yes | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| RESERVESLIP | C4/Reserves.pm | N/A | Yes | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| ASKED | C4/Suggestions.pm | N/A | Yes | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| CHECKED | C4/Suggestions.pm | N/A | Yes | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| ACCEPTED | C4/Suggestions.pm | N/A | Yes | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| REJECTED | C4/Suggestions.pm | N/A | Yes | -+---------------------+----------------------------+---------------------------------------+--------------------------+ -| OPAC\_REG\_VERIFY | opac/opac-memberentry.pl | N/A | No | -+---------------------+----------------------------+---------------------------------------+--------------------------+ - -Example Notice -============== - -Nicole Engard - -410 Library Rd. - -Philadelphia, PA 19107 - -Dear Nicole Engard (23529000035726), - -According to our records, at the time of this notice, you have items -that are overdue. Please return or renew them as soon as possible to -avoid increasing late fines. - -If you have registered a password with the library, you may use it with -your library card number to renew online. - -If you believe you have returned the items below please call at and -library staff will be happy to help resolve the issue. - -The following item(s) are currently overdue: - -07/08/2008 Creating drug-free schools and communities : 502326000054 -Fox, C. Lynn. - -06/27/2008 Eating fractions / 502326000022 McMillan, Bruce. - -Sincerely, Library Staff - -Sample Serials -============== - -`Reader's Digest (0034-0375) <#readersdigestsample>`__ ------------------------------------------------------- - -- Published 12 times a year (monthly) - -- The Volume number changes every 6 months and the numbers continues on - (requires an advanced pattern). - - Sample Reader's Digest Subscription - |image1069| - -`People Weekly (1076-0091) <#peoplesample>`__ ---------------------------------------------- - -- Published weekly - - - The website says "on Saturday except the first week of August, - Thanksgiving week, the first and last weeks of the year" but this - does not match the pattern for 2007 or 2008 - -- In the Jul-Dec there are 26 issues - -- In the Jan-Jun there are 25 issues (no issue for the first week of - January) - -Since the irregularity on the first # 26 does not skip a week, this -would be set up as to roll over on issue 25. The 26th issue in the -second half of the year would have to be received as a supplemental. - -The irregularity check will complain that 52 issues were expected, but -25 entered. The current irregularity check can only check that the first -position of the numbering pattern matches the expected issue count of -the periodicity. But we do need to trigger the rollover on the volume, -so we need to define the last two weeks of the year as irregularities. -So we receive 50 issues the first 50 weeks, then one supplemental issue -in week 51, which we have to define the enumeration for, then the next -predicted issue will be the following year's first week. - -`Et-Mol <#hebrewserialsample>`__ --------------------------------- - -This journal is published with the following rules: - -- 6 issues a year (every 2 months) - -- year changes every 6 issues - -- we start in 2011 - -- the issue number goes up indefinitely - -- starting from issue 215 - -The planning would look like this: - -Sample for this Hebrew Journal -|image1070| - -`Backpacker (0277-867X) <#backpackerserial>`__ ----------------------------------------------- - -Published 9 times a year irregularly. The issues continues while the -volume and number rolls over every 9 issues. If you're holding Volume -41, Number 3, Issue 302 in your hand the prediction would look like -this: - -Backpacker numbering pattern -|image1071| - -And the received issues would number like this: - -v. 41, no. 3, iss. 302   - -v. 41, no. 4, iss. 303 - -v. 41, no. 5, iss. 304 - -v. 41, no. 6, iss. 305 - -v. 41, no. 7, iss. 306 - -v. 41, no. 8, iss. 307 - -v. 41, no. 9, iss. 308 - -v. 42, no. 1, iss. 309 - -v. 42, no. 2, iss. 310 - -v. 42, no. 3, iss. 311 - -v. 42, no. 4, iss. 312 - -`Keats-Shelley Journal (0453-4387) <#keatsserial>`__ ----------------------------------------------------- - -This journal is published once per year in July.  The numbering follows -this pattern:   - -- Vol. 61 2013 - -- Vol. 62 2014 - -- Vol. 63 2015 - -Setup should look like this (if you're starting in July 2014): - -Serial planning -|image1072| - -`Computers in Libraries (1041-7915) <#cilserial>`__ ---------------------------------------------------- - -Computers in Libraries is published ten times per year (monthly with -January/February and July/August combined issues). - -Subscription details -|image1073| - -Serial Planning -|image1074| - -Received details -|image1075| - -Sample List & Cart Emails -========================= - -`Example Email from List <#examplelistemail>`__ ------------------------------------------------ - -Below is an example of an email from a list in Koha. - -:: - - Hi, - - Here is your list called If You Like Jodi Picoult, sent from our online catalog. - - Please note that the attached file is a MARC bibliographic records file - which can be imported into a Personal Bibliographic Software like EndNote, - Reference Manager or ProCite. - --------------------------------------------- - - Home safe : a novel / - - by Berg, Elizabeth. - - Published by: Random House,, 260 p. ;, 25 cm. - Copyright year: 2009 - LCCN: 2008049247 - In the online catalog: - http://MYCATALOG/cgi-bin/koha/opac-detail.pl?biblionumber=12113 - Items : - North Branch FIC (FIC Ber) TVSN500088894O - Main Library FIC (FIC Boh) TVSN5000921548 - South Branch FIC (FIC Boh) TVSN500092156A - West Branch FIC (FIC Boh) TVSN5000921559 - - --------------------------------------------- - - Half a heart / - - by Brown, Rosellen. - - Published by: Farrar, Straus, and Giroux,, 402 p. ;, 24 cm. - Copyright year: 2000 - LCCN: 00022926 - In the online catalog: - http://MYCATALOG/cgi-bin/koha/opac-detail.pl?biblionumber=12501 - Items : - East Branch (813/.54) - South Branch FIC (FIC Bro) TVSN5000451333 - -`Example Email from Cart <#examplecartemail>`__ ------------------------------------------------ - -Below is a sample of what an email from the Cart in Koha will look like: - -:: - - Hi, - - Joaquin D'Planque sent you a cart from our online catalog. - - Please note that the attached file is a MARC bibliographic records - file which can be imported into personal bibliographic software like - EndNote, Reference Manager or ProCite. - - --------------------------------------------------------------------- - - - 1. Book / - Author(s): Brookfield, Karen. ; - Published by: Knopf : | Distributed by Random House, , 63 p. : , - 29 cm. - Copyright year: 1993 - Notes : Includes index. - LCCN: 93018833 /AC - - In online catalog: - http://MYCATALOG/cgi-bin/koha/opac-detail.pl?biblionumber=31644 - - Items: - - * East Branch (JNF 002 Bro) TVSN500017618A - - ----------------------------------------------------------------- - - 2. The 1965 World book year book : - - Published by: Field Enterprises Educational Corp., , 628 p. : , 26 - cm. - Copyright year: 1965 - Notes : Includes index. | Spine title: Year book, 1965. | Cover - title: The World book year book, 1965. - URL: - http://www.archive.org/details/1965worldbookyea00chic%20%7C%20http://www.openlibrary.org/books/OL24199089M - - In online catalog: - http://MYCATALOG/cgi-bin/koha/opac-detail.pl?biblionumber=88666 - - ----------------------------------------------------------------- - -Using Koha as a Content Management System (CMS) -=============================================== - -`Setup <#kohacmssetup>`__ -------------------------- - -These are instructions for taking a default install of Koha and allowing -it to function as a little content management system. This will allow a -library to publish an arbitrary number of pages based on a template. -This example uses the template for the main opac page, but you could -just as well use any template you wish with a bit more editing. This may -be appropriate if you have a small library, want to allow librarians to -easily add pages, and do not want to support a complete CMS. - -- Copy /usr/share/koha/opac/cgi-bin/opac/opac-main.pl to - /usr/share/koha/opac/cgi-bin/opac/pages.pl (in the same directory) - -- Edit pages.pl in an editor - -- At approximately line 33 change this code: - - :: - - template_name => "opac-main.tmpl", - -- To this code: - - :: - - template_name => "pages.tmpl", - -- At approximately line 62 after this code: - - :: - - $template->param( - koha_news => $all_koha_news, - koha_news_count => $koha_news_count, - display_daily_quote => C4::Context->preference('QuoteOfTheDay'), - daily_quote => $quote, - ); - -- Add these lines: - - :: - - my $page = "page_" . $input->param('p'); # go for "p" value in URL and do the concatenation - my $preference = C4::Context->preference($page); # Go for preference - $template->{VARS}->{'page_test'} = $preference; # pass variable to template pages.tt - -- Note pages.pl file must have Webserver user execution permissions, - you can use `chmod `__ command if - you are actually logged in as such user: - - :: - - $chmod 755 pages.pl - -- In the browser go to Home > Administration > System Preferences > - Local Use and add a New Preference called "page\_test" - -- Fill it out as so - - - Explanation: test page for pages tiny cms - - - Variable: page\_test - - - Value: Lorem ipsum - - - Click the TextArea link (or enter "TextArea" into the input field - below it) - - - variable options (last field): 80\|50 - -- In a browser go to http://youraddress/cgi-bin/koha/pages.pl?p=test - The page should come up with the words "Lorem ipsum" in the main - content area of the page. (replace "youraddress" with localhost, - 127.0.0.1, or your domain name depending on how you have Apache set - up.) - -- To add more pages simply create a system preference where the title - begins with "page\_" followed by any arbitrary letters. You can add - any markup you want as the value of the field. Reference the new page - by changing the value of the "p" parameter in the URL. - -To learn more visit the Koha wiki page on this topic: -http://wiki.koha-community.org/wiki/Koha_as_a_CMS - -`Editing the pages template <#kohacmstmpl>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The file to create / edit for the pages template will depend on your -`opacthemes <#opacthemes>`__ system preference setting - -`Editing 'bootstrap' theme template (current) <#kohacmstmplboot>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -- Copy - /usr/share/koha/opac/htdocs/opac-tmpl/bootstrap/en/modules/opac-main.tt - to - /usr/share/koha/opac/htdocs/opac-tmpl/bootstrap/en/modules/pages.tt - -- Edit - /usr/share/koha/opac/htdocs/opac-tmpl/bootstrap/en/modules/pages.tt - -- At approximately line 61, change this: - - :: - - [% IF ( OpacMainUserBlock ) %]
[% OpacMainUserBlock %]
[% END %] - -- To this: - - :: - - [% IF ( page_test ) %]
[% page_test %]
[% END %] - -Remark: You may wish to disable your News block of these CMS style pages -e.g. when you do not want it displayed on the CMS style pages or where -the News block is long enough that it actually makes the 'page\_test' -include scroll outside the default viewport dimensions. In that case, -remove the following code from your pages.tt template. - -:: - - [% IF ( koha_news_count ) %] -
- - [% FOREACH koha_new IN koha_news %] - - - [% END %] -
[% koha_new.title %]

[% koha_new.new %]

-

(published on [% koha_new.newdate %])

-
- [% END %] - - -`Troubleshooting <#kohacmstrouble>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -If you have problems check file permissions on pages.pl and pages.tmpl. -They should have the same user and group as other Koha files like -opac-main.pl. - -`Bonus Points <#kohacmsbonus>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Instead of using the address -http://youraddress/cgi-bin/koha/pages.pl?p=test you can shorten it to -http://youraddress/pages.pl?p=test Just open up -/etc/koha/koha-httpd.conf and add the follow at about line 13: - -:: - - ScriptAlias /pages.pl "/usr/share/koha/opac/cgi-bin/opac/pages.pl" - -Then restart Apache. - -`Usage <#kohacmsusage>`__ -------------------------- - -After setting up Koha as a CMS you can create new pages following these -instructions: - -`Adding Pages <#kohacmspages>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -To add a new page you need to add a system preference under Local Use. - -- Get there: More > Administration > Global System Preferences > Local - Use - -- Click 'New Preference' - -- Enter in a description in the Explanation field - -- Enter a value that starts with 'page\_' in the Variable field - -- Enter starting HTML in the Value field - - Add a new preference - |image1076| - -- Set the Variable Type to Textarea - -- Set the Variable options to something like 20\|20 for 20 rows and 20 - columns - - Settings for the new preference - |image1077| - -`Viewing your page <#kohacmsview>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -You can view your new page at -http://YOUR-OPAC/cgi-bin/koha/pages.pl?p=PAGENAME where PAGENAME is the -part you entered after 'page\_' in the Variable field. - -`Example <#kohacmsexpage>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -This process can be used to create recommended reading lists within -Koha. So once the code changes have been made per the instructions on -'Koha as a CMS' you go through the 'Adding a New Page' instructions -above to great a page for 'Recommended Reading Lists' - -Create page by modifying a system preference -|image1078| - -Next we need to create pages for our various classes (or categories). To -do this, return to the 'Adding a New Page' section and create a -preference for the first class. - -Add a new sys pref for another page -|image1079| - -Next you'll want to link your first page to your new second page, go to -the page\_recommend preference and click 'Edit.' Now you want to edit -the HTML to include a link to your newest page: - -Edit original preference to add new page -|image1080| - -`Live Examples <#examplecms>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -- The Crawford Library at Dallas Christian College is using this method - for their recommended reading lists: http://opac.dallas.edu/ - -Resetting the Koha Database -=========================== - -These notes on how to reset the database for Koha were derived from the -following email thread: -http://lists.koha-community.org/pipermail/koha-devel/2009-January/008939.html -and http://lists.katipo.co.nz/public/koha/2014-June/039701.html - -Resetting the database may be useful if you install Koha with the sample -data, and then wish to use real data without reinstalling the software. - -`Delete sample data from Tables <#deletetables>`__ --------------------------------------------------- - -Use your preferred MySQL client to -`delete `__ the -following tables: - -- bibio - -- biblioitems - -- items - -- auth\_header - -- sessions - -- zebraqueue - -You may need to disable foreign key checks to delete data from same -tables. For instructions follow this thread: -https://lists.katipo.co.nz/pipermail/koha/2013-July/036853.html. - -`Reset the Zebra Index <#resetzebra>`__ ---------------------------------------- - -Run the following commands to reset the authorities and biblios Zebra -indices. - -:: - - $ zebraidx -c /etc/koha/zebradb/zebra-authorities-dom.cfg -g iso2709 -d authorities init - $ zebraidx -c /etc/koha/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init - -If you are running a package install then you'll want to run the -following commands to reset the authorities and biblios Zebra indices -instead: - -:: - - $ sudo zebraidx -c /etc/koha/sites/YOURLIBRARY/zebra-authorities-dom.cfg  -g iso2709 -d authorities init - $ sudo zebraidx -c /etc/koha/sites/YOURLIBRARY/zebra-biblios.cfg  -g iso2709 -d biblios init - -Replacing YOURLIBRARY with your Koha installation name. - -Important Links -=============== - -`Koha Related <#koharelatedlinks>`__ ------------------------------------- - -- Report Koha Bugs - http://bugs.koha-community.org - -- Koha Versioning Control - http://git.koha-community.org/ - -- Database Structure - http://schema.koha-community.org - -- Koha Community Statistics - http://hea.koha-community.org - -- Koha as a CMS - http://wiki.koha-community.org/wiki/Koha_as_a_CMS - -- Kyles's Koha Tools - http://kylehall.info/index.php/projects/koha/ - -- Koha Bibliography - http://www.zotero.org/groups/koha - -- Koha Shared Links - http://groups.diigo.com/group/everything-koha - -`Circulation Related <#circrelatedlinks>`__ -------------------------------------------- - -- Koha Desktop Offline Circulation: - https://github.com/bywatersolutions/koha-offline-circulation/releases - -- Koha Firefox Offline Circulation: - https://addons.mozilla.org/en-US/firefox/addon/koct/ - -`Cataloging Related <#catalogrelatedlinks>`__ ---------------------------------------------- - -- Koha MARC Tutorials - http://www.pakban.net/brooke/ - -- IRSpy Open Z39.50 Server Search - http://irspy.indexdata.com/ - -- Z39.50 Server List - - http://staff.library.mun.ca/staff/toolbox/z3950hosts.htm - -- Open Koha Z39.50 Targets - - http://wiki.koha-community.org/wiki/Koha_Open_Z39.50_Sources - -- Library of Congress Authorities - http://authorities.loc.gov/ - -- MARC Country Codes - http://www.loc.gov/marc/countries/ - -- Search the MARC Code List for Organizations - - http://www.loc.gov/marc/organizations/org-search.php - -- Search for Canadian MARC Codes - - http://www.collectionscanada.gc.ca/illcandir-bin/illsear/l=0/c=1 - -- Z39.50 Bib-1 Attribute - - http://www.loc.gov/z3950/agency/defns/bib1.html - -`Enhanced Content Related <#enhancedcontentlinks>`__ ----------------------------------------------------- - -- Amazon Associates - - `https://affiliate-program.amazon.com `__ - -- Amazon Web Services - http://aws.amazon.com - -- WorldCat Affiliate Tools - - http://www.worldcat.org/wcpa/do/AffiliateUserServices?method=initSelfRegister - -- XISBN - http://www.worldcat.org/affiliate/webservices/xisbn/app.jsp - -- LibraryThing for Libraries - http://www.librarything.com/forlibraries - -`Design Related <#opaclinks>`__ -------------------------------- - -- JQuery Library - http://wiki.koha-community.org/wiki/JQuery_Library - -- HTML & CSS Library - - http://wiki.koha-community.org/wiki/HTML_%26_CSS_Library - -- Owen Leonard's Koha Blog - http://www.myacpl.org/koha - -`Reports Related <#reportlinks>`__ ----------------------------------- - -- SQL Reports Library - - http://wiki.koha-community.org/wiki/SQL_Reports_Library - -- Database Schema - http://schema.koha-community.org - -- Sample reports from NEKLS - - http://www.nexpresslibrary.org/training/reports-training/ - -`Installation Guides <#installlinks>`__ ---------------------------------------- - -- Installing Koha 3 on Ubuntu - - http://www.blazingmoon.org/guides/k3-on-u810-1.html - -- Koha on Debian installation documentation - - http://openlib.org/home/krichel/courses/lis508/doc/koha_installation_overview.html - -- Koha 3.2 on Debian Squeeze - - http://wiki.koha-community.org/wiki/Koha_3.2_on_Debian_Squeeze - -`Misc <#misclinks>`__ ---------------------- - -- Zotero - http://zotero.org - -- SOPAC - `http://thesocialopac.net `__ - -Koha XSLT Item Types -==================== - -When you have any of the XSLT system preferences -(`OPACXSLTDetailsDisplay <#OPACXSLTDetailsDisplay>`__, -`OPACXSLTResultsDisplay <#OPACXSLTResultsDisplay>`__, -`XSLTDetailsDisplay <#XSLTDetailsDisplay>`__, and/or -`XSLTResultsDisplay <#XSLTResultsDisplay>`__) along with the -`DisplayOPACiconsXSLT <#DisplayOPACiconsXSLT>`__ and -`DisplayIconsXSLT <#DisplayIconsXSLT>`__ preferences turned on you will -see item type icons on the related screen. - - **Important** - - These images are coming from values found in your leader, if your - leader is not cataloged properly it might be best to turn off the - `DisplayOPACiconsXSLT <#DisplayOPACiconsXSLT>`__ preference (which - can be done while leaving the other XSLT preferences turned on). - -Book image -|image1081| - -- Book [BK] - - - leader6 = a (and one of the leader7 values below) - - - leader7 = a - - - leader7 = c - - - leader7 = d - - - leader7 = m - - - leader6 = t - -Computer Image -|image1082| - -- Computer File [CF] - - - leader6 = m - -Continuing Resource Image -|image1083| - -- Continuing Resource [CR] - - - leader7 = b - - - leader7 = i - - - leader7 = s - -Map Image -|image1084| - -- Map [MP] - - - leader6 = e - - - leader6 = f - -Mixed Materials Image -|image1085| - -- Mixed [MX] - - - leader6 = p - -Sound Image -|image1086| - -- Sound [MU] - - - leader6 = c - - - leader6 = d - - - leader6 = i - - - leader6 = j - -Visual Material Image -|image1087| - -- Visual Material [VM] - - - leader6 = g - - - leader6 = k - - - leader6 = r - -Kit Image -|image1088| - -- Kit - - - leader6 = o - -MarcEdit -======== - -Many libraries like to use MarcEdit for modifications or data cleanup. -If you'd like to do this you will need to download it at: -http://marcedit.reeset.net/ - - **Important** - - Many of the actions described in this chapter can be done in Koha - using `Marc Modification Templates <#marcmodtemplates>`__, but this - section is here for those who are used to MarcEdit. - -`Adding a prefix to call numbers <#marceditprefix>`__ ------------------------------------------------------ - -When bringing data into Koha, you may want to first clean it up. One -common action among Koha users is to add a prefix to the call number. - -- Open MarcEdit - - MarcEdit - |image1089| - -- Click 'MarcEditor' - -- Go to Tools > Edit Subfield Data - - Edit subfield data - |image1090| - -- To prepend data the special character is: ^b  To simply prepend data - to the beginning of a subfield, add ^b to the Field Data: textbox and - the data to be appended in the Replace - - Prepend data to a field - |image1091| - - - To prepend data to the beginning of the subfield while replacing a - text string, add ^b[string to replace] to the Field Data textbox - and the data to be appended in the Replace With textbox. - -`Importing Excel data into Koha <#marceditexcel>`__ ---------------------------------------------------- - -Suppose you have records of your library in excel data sheet format and -want them to import into Koha. But how will you do this? Koha will not -let you import excel records directly. Well here is a very simple -solution for you which will let you import your excel records in Koha -easily. First, we will convert excel file into Marc file and then will -import it into Koha. - -Follow the given steps to import your excel records into Koha - -`Converting from Excel format into .mrk format <#convertexcel>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -First, we will convert excel format into .mrk format. For this we will -use MarcEdit. You can download it from http://marcedit.reeset.net/ - -Now open it and select Add-ins-->Delimited Text Translator. - -Delimited Text Translator -|image1092| - -Click Next when the following window appears. - -Delimited Text Translator -|image1093| - -Browse for your excel file. - -Delimited Text Translator -|image1094| - -Locate your excel file by choosing the format Excel File(\*.xls). - -Delimited Text Translator -|image1095| - -Similarly, fill all the other entries such as Output File, Excel Sheet -Name and check UTF-8 Encoded (if required) and Click Next. - -Delimited Text Translator -|image1096| - -Now you will be prompted for mapping the fields to recognise the fields -by standard marc format. - -Suppose for Field 0 that is first column I entered Map to: 022$a( Valid -ISSN for the continuing resource) and then click on Apply. - -Delimited Text Translator -|image1097| - - **Note** - - You can customize Indicators and all other things, for more - information on marc21 format visit the `official library of congress - site `__. - -Similarly map all other fields and then Click on Finish. - -Delimited Text Translator -|image1098| - -And then a window will appear indicating that your Marc Text -File(\*.mrk) has been created. - -Delimited Text Translator -|image1099| - -Click Close and we have created a .mrk file from .xls file in this step. -You can view the file by double clicking on it. - -`Convert .mrk file to .mrc <#convertmrk>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -We will convert .mrk file that we have created in the above step into -raw Marc format that can be directly imported into Koha. - -For this again open MarcEdit and Select MARC Tools. - -MARC Tools -|image1100| - -Next Select MarcMaker to convert .mrk file into .mrc format. - -MarcMaker -|image1101| - -Locate your input file and name your output file. Then Click Execute. - -MarcMaker -|image1102| - -And it will show you the Result. - -MarcMaker -|image1103| - -Click Close and now we have raw Marc records with us (.mrc file). - -`Import .mrc into Koha <#importmrc>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -More information on importing records into Koha can be found in the -'`Stage MARC Records for Import <#stagemarc>`__' section of this manual. - -Finally we will import above created .mrc file into Koha. - -Click on Tools in your Koha staff client. - -Koha Staff Client -|image1104| - -Next Click on Stage MARC Records for Import. - -Stage MARC Records for Import -|image1105| - -After this, choose your previously created .mrc file and click on -Upload. - -Stage File -|image1106| - -You can also add comment about file and finally click on Stage For -Import. - -Stage for Import -|image1107| - -When the import is done, you will get a result something like this - -Staged Records Summary -|image1108| - -Next, click on Manage staged records. - -Here you can even change matching rules. - -Manage Staged Records -|image1109| - -Click on Import this batch into catalog when you are done. - -Thats it. After all the records get imported, check Status and it should -read "imported" - -Finalize Import -|image1110| - -You can even undo the Import operation. - -And within few minutes, we have imported around 10,000 records in Koha - -Talking Tech -============ - -Talking Tech I-tiva is a third party, proprietary, product that -libraries can subscribe to. Learn more here: -http://www.talkingtech.com/solutions/library. - -`Installation and Setup Instructions <#talkingtechinstall>`__ -------------------------------------------------------------- - -Be sure you've run -installer/data/mysql/atomicupdate/Bug-4246-Talking-Tech-itiva-phone-notifications.pl -to install the required data pack (new syspref, notice placeholders and -messaging transport preferences) - -To use, -`TalkingTechItivaPhoneNotification <#TalkingTechItivaPhoneNotification>`__ -syspref must be turned on. - -If you wish to process PREOVERDUE or RESERVES messages, you'll need the -`EnhancedMessagingPreferences <#EnhancedMessagingPreferences>`__ system -preference turned on, and patrons to have filled in a preference for -receiving these notices by phone. - -For OVERDUE messages, overdue notice triggers must be configured under -Koha -> Tools -> `Overdue Notice Triggers <#noticetriggers>`__. Either -branch-specific triggers or the default level triggers may be used -(script will select whichever is appropriate). - -`Sending Notices File <#talkingtechsend>`__ -------------------------------------------- - -1. Add the `TalkingTech\_itiva\_outbound.pl <#talkingtechsendcron>`__ - script to your crontab - -2. Add an FTP/SFTP or other transport method to send the output file to - the I-tiva server - -3. If you wish, archive the sent notices file in another directory after - sending - -Run TalkingTech\_itiva\_outbound.pl --help for more information - -`Receiving Results File <#talkingtechreceive>`__ ------------------------------------------------- - -1. Add an FTP/SFTP or other transport method to send the Results file to - a known directory on your Koha server - -2. Add the `TalkingTech\_itiva\_inbound.pl <#talkingtechreceivecron>`__ - script to your crontab, aimed at that directory - -3. If you wish, archive the results file in another directory after - processing - -Run TalkingTech\_itiva\_inbound.pl --help for more information - -OCLC Connexion Gateway -====================== - -Koha can be set to work with the OCLC Connextion Gateway. This allows -libraries to use OCLC Connexion as their cataloging tool and simply send -those records to Koha with a single click. The following instructions -will help you set up the OCLC Connexion Gateway, if you have a system -administrator you will want to consult with them on this process. - -`Setting up OCLC service on Koha <#oclckohasetup>`__ ----------------------------------------------------- - -First, you'll need to create a file somewhere on your system with -configuration information.  You could put this anywhere that is visible -to the account that will be running the service. - -The file contains 11 lines. The first 6 will be about your Koha system: - -:: - - host: The IP address of your Koha server - port: The port you want to use for the Connexion service. This port must be different from your SIP port, or any other service - koha: The full URL of your staff client - log: The location (full file specification) of your log for the service - user: The default Koha username to use for importing - password: The password that goes with that username - -The remaining lines describe how to do the staging: - -:: - - match: The name of the matching rule from your system to use - overlay_action: "replace", "create_new", or "ignore"-- what to do if there is a match - nomatch_action: "create_new" or "ignore"-- what to do if there is no match - item_action: "always_add","add_only_for_matches","add_only_for_new", or "ignore" -- what to do with embedded 952 item data - import_mode: "direct" or "stage" - -A sample file would look like this: - -:: - - host: 1.2.3.4 - port: 8000 - log: /home/koha/koha-dev/var/log/connexion.log - koha: http://kohastaff.myuniversity.edu - user: koha_generic_staff - password: password - match: 001 - overlay_action: replace - nomatch_action: create_new - item_action: ignore - import_mode: direct - -When choosing an 'import\_mode' if you use "direct" then the staged -record will be immediately imported into Koha, and should be searchable -after your indexes catch up.  If you choose "stage", then the record -will be placed in a staged batch for you to later go the `Manage Staged -MARC Records <#managestaged>`__ tool to finish the import. - -If you import multiple records, they'll be in the same batch, until that -batch is imported, then a new batch will be created. - -In "direct" mode, each record will be in its' own batch. - -To start the service, run the script: - -:: - - /location/of/connexion/import/daemon/connexion_import_daemon.pl -d -c /location/of/config/file.cnf - -`Setting up your OCLC desktop client <#oclcdesktopsetup>`__ ------------------------------------------------------------ - - **Note** - - Screenshots are OCLC Connexion Client v.2.50, Koha v.3.12 - -To set up the OCLC Connexion desktop client to connect to Koha, go to -Tools > Options, then choose the Export tab. Connexion Export Tab - -- Click the "Create..." button to set up a new destination, then choose - "OCLC Gateway Export" and click OK. - - - Enter the following information: - - - "Host Name:" Your catalog’s appropriate IP address (from your - `config file above <#oclckohasetup>`__) - - - "Port:" Your catalog's appropriate port number (from your - `config file above <#oclckohasetup>`__) - - - "Login ID:" The cataloger's Koha login - - - "Password:" The cataloger's Koha password - - - "Notify Host Before Disconnect" = checked, - - - "Timeout" = 100, "Retries" = 3, "Delay" = 0 (zero), - - - "Send Local System Logon ID Password" = checked. - - OCLC Gateway Export Settings - |image1111| - -- Select "OK" when finished, and you should see your new "Gateway - Export" option listed (The catalog's IP address and port are blacked - out in the following screenshot) - - Gateway Export Added - -- Click on "Record Characteristics" and make sure that the - bibliographic records are using MARC21, UTF-8 Unicode, and click OK - to save. - - Record Characteristics - -You should be ready to go!  To export a record from OCLC Connexion -Client to Koha, just press F5 while the record is on-screen.  The export -dialog will pop up, and you'll see Connexion attempting to talk to Koha. - You should get a message that the record was added or overlaid, -including its biblio number, and a URL that you can copy into your web -browser to jump straight to the record. - -`Using the OCLC Connexion Gateway <#oclcgateway>`__ ---------------------------------------------------- - -Records can be exported from Connexion either in a batch or one by one. - -`Exporting records one by one <#oclconeexport>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -To export bibliographic records one by one, be sure your "Batch" options -are correct: from the "Tools" menu, select "Options", and select the -"Batch" tab. In the "Perform local actions in batch" area, -"Bibliographic Record Export" should be uncheckedConnexion batch options - -When ready to export, from the "Action" menu, select "Export" or use the -F5 key. You will see a screen similar to the following if the import is -successful and if the record is new to the Catalog; you may copy & paste -the resulting URL into your Koha catalog to see the new record.Connexion -Export - -If the record was overlaid, you will see a message to that effect in the -"OCLC Gateway Export Status" windowOverlay confirmation - -`Exporting records in a batch <#oclcbatchexport>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -To export bibliographic records in a batch, be sure your "Batch" options -are correct: from the "Tools" menu, select "Options", and select the -"Batch" tab. In the "Perform local actions in batch" area, -"Bibliographic Record Export" should be checkedOCLC Batch Export Options - -When a record is ready to export, from the "Action" menu, select -"Export" or use the F5 key, and it’s export status will be "ready." - -When ready to export the batch, from the "Batch" menu, select "Process -batch" and check the appropriate "Path" and "Export" boxesBatch import -process - -The export will begin, and the bib records will be exported & imported -into Koha one by one; you will see "OCLC Gateway Export Status" windows, -as above, showing you the results of each export. That window will stay -there until you select "Close," and then the next record’s export/import -will begin. The process will continue until all records in the batch are -completed. Then you may or may not see the Connexion Client export -report (depending on your Client options for that). - -`Items in OCLC <#oclcitems>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -If you'd like to create your item records in OCLC you can do so by -addding a 952 for each item to the bib record you're cataloging. The -`Item/Holdings Cataloging Guide <#itemcatguide>`__ will break down what -subfields you can use in the 952, but at the minimum you want to have -subfield 2, a, b, and y on your items. - -952 -\\\\$2CLASSIFICATION$aHOMEBRANCHCODE$bHOLDINGBRANCHCODE$yITEMTYPECODE - -- The subfield 2 holds the classification code. This can be ddc for - Dewey or lcc for Library of Congress or z for Custom. Other - classification sources can be found in the `Classification - Sources <#classificationsources>`__ area in administration - -- Subfield a is your home library and needs to be the code for your - home library, not the library name. You can find these codes in the - `Libraries & Groups <#libsgroups>`__ administration area. - -- Subfield b is your holding library and needs to be the code for your - holding library, not the library name. You can find these codes in - the `Libraries & Groups <#libsgroups>`__ administration area. - -- Subfield y is your item type code. It needs to be the code, not the - item type name. You can find these codes in the `Item - Types <#itemtypeadmin>`__ administration area. - -952 \\\\$2ddc$aMAIN$bMAIN$yBOOK - -In addition to these required fields you can enter any other subfield -you'd like. Most libraries will enter a call number in subfield o and a -barcode in subfield p as well. Review the `Item/Holdings Cataloging -Guide <#itemcatguide>`__ for a full list of subfields and values. - -FAQs -==== - -`Display <#displayfaq>`__ -------------------------- - -`Custom Item Type/Authorized Value Icons <#customicons>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question:** Can I have my own set of item type images (or authorized -value icons)? - -**Answer:**\ Absolutely. To add additional icons to your system you -simply add a new directory to -koha-tmpl/intranet-tmpl/prog/img/itemtypeimg/ and to -koha-tmpl/opac-tmpl/prog/itemtypeimg and put your icons in the new -directory. Your icons will show up in a new tab as soon as they are in -the folders. - -- **Note** - - Remember to put the icons in both places (on the OPAC and the - intranet). - -`Customizing Koha Images <#customkohaimages>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Can I customize the images in the OPAC? - -**Answer**: Absolutely. Koha comes with a series of original images that -you can alter to meet your needs. The originals can be found in the -misc/interface\_customization/ directory. - -`OPAC Display Fields <#opacdisplayfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: What MARC fields print to the different OPAC screens in -Koha? - -**Answer**: The XSLT preference must be set as follows for the following -fields to show - -- `OPACXSLTResultsDisplay <#OPACXSLTResultsDisplay>`__ = using XSLT - stylesheets - -- `OPACXSLTDetailsDisplay <#OPACXSLTDetailsDisplay>`__ = using XSLT - stylesheets - -- `DisplayOPACiconsXSLT <#DisplayOPACiconsXSLT>`__ = show - -The OPAC Results page shows: - -- 245 - -- 100, 110, 111 - -- 700, 710, 711 - -- 250 - -- 260 - -- 246 - -- 856 - -The OPAC Details page shows: - -- 245 - -- 100, 110, 111 - -- 700, 710, 711 - -- 440, 490 - -- 260 - -- 250 - -- 300 - -- 020 - -- 022 - -- 246 - -- 130, 240 - -- 6xx - -- 856 - -- 505 - -- 773 - -- 520 - -- 866 - -- 775 - -- 780 - -- 785 - -- plus all of the 5xx fields in the Notes tab at the bottom - -`Subtitle Display on Bib Records <#displaysubtitle>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: How do I get the subtitle to display on the detail pages -for my bib records? - -**Answer**: Subtitle display now depends on there being a `keyword -mapping <#keywordmapping>`__ for the MARC field in question. Adding a -mapping for "subtitle" -> "245b" for an item's framework results in -display of the subtitle in OPAC and staff client search and detail pages -(although not in all instances where subtitles might be displayed, e.g. -the Cart). - -`Show patrons the barcodes of items they have checked out <#opacbarcodesfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Can patrons see the barcodes for the items they have -checked out. - -**Answer**: Not by default, but with a few edits to the patron record -you can make a barcode column appear on the patron's check out summary -in the OPAC. You can set up a `patron -attribute <#patronattributetypes>`__ with the value of SHOW\_BCODE and -`authorized value <#authorizedvalues>`__ of YES\_NO to make this happen. - -Add SHOW\_BCODE patron attribute -|image1112| - -Then on the `patron's record set the value <#editpatrons>`__ for -SHOW\_BCODE to yes. - -Setting value for SHOW\_BCODE on patron record -|image1113| - -This will add a column to the check out summary in the OPAC that shows -the patrons the barcodes of the items they have checked out. - -Barcode number on checkout list in OPAC -|image1114| - -Clicking on the 'Overdue' tab will show only the items that are overdue. - -`Circulation/Notices <#circfaq>`__ ----------------------------------- - -`Book drop Date <#dropboxfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: How is the book drop date is determined? Is it the last -open date for the checkout branch? Is it today's date minus one? Can the -book drop checkin date be set? - -**Answer**: If the library is closed for four days for renovations, for -example, there would be more than one day needed for the book drop date. -You will only have one book drop date and that will be the last day that -the library open (determined by the holiday calendar) because there is -no real way to know what day the books were dropped into the box during -the 4 closed days. The only way to change the effective checkin date in -book drop mode is to modify the calendar. - -`Holds to Pull and Holds Queue <#holdsreportsfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: What is the difference between the `Holds -Queue <#holdsqueue>`__ and `Holds to Pull <#holdspull>`__? - -**Answer**: The holds to pull report gives a simple list of what holds -need to be filled with available items. It should only be used in Koha -installations where there is only one library. - -The holds queue tries to do the same thing, but in a 'smarter' way. This -allows it to split up the list by library, consult the `transport cost -matrix <#transportcostmatrix>`__ and refresh regularly to provide -different pull lists to each library. - -`Duplicate Overdue Notices <#dupoverduefaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Why are patrons getting two overdue notices? - -**Answer**: This tool takes all branches in the overdue rules and sent -notifications to them. So, if you have a default rule & a branch rule, -the notification will be generated twice. A quick fix is to discard -"default rule" for instance. - -`Printing Overdue Notices <#printoverduefaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Can I print overdue notices for patrons without email -addresses on file? - -**Answer**: Yes. The `overdue notice cron job <#overduenoticecron>`__ -has a setting to generate the overdue notices as HTML for printing. An -example of this usage would be: - -:: - - overdue_notices.pl -t -html /tmp/noticedir -itemscontent issuedate,date_due,title,barcode,author - -In this example, we wanted to use only certain item fields in our -notices, so we specified itemscontent fields in the cron entry; that's -not a requirement for the feature. - -The command line needs to specify a web-accessible directory where the -print notices will go -- they get a filename like -notices-2009-11-24.html (or holdnotices-2009-11-24.html). The overdue -notice itself can be formatted to fit a Z-mailer. Within the notice -file, the text is spaced down or over to where it will print properly on -the form. The script has code that wraps around the notice file to tell -the HTML to obey the formatting, and to do a page break between notices. -That's so that when staff print it out, they get one per page. We had to -add an extra syspref (`PrintNoticesMaxLines <#PrintNoticesMaxLines>`__) -to specify page length because our client allows a \_lot\_ of checkouts -which meant some notices were running onto multiple pages. That syspref -says to truncate the print notice at that page length and put in a -message about go check your OPAC account for the full list. - -The print and email overdues use the same notice file. The print notices -for holds are different -- there's a separate HOLD\_PRINT notice file -and the system uses it if there's no email address. Then a nightly cron -job runs to gather those up from the message queue and put them in an -HTML file in the notice directory, as above. - -The cron entry is gather\_print\_notices.pl /tmp/noticedir - -`Unable to Renew Items <#renewfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: We're trying to renew some items for our patron. One of -the items is on hold and ineligible for renewal, but the other two items -refuse to renew even though they should be eligible. When I try to use -the override renewal limit, it just returns a little message that says -"renewal failed". Any idea what's going on here? - -**Answer**: At the very least you will need to set an absolute `default -circulation rule <#circfinerules>`__. This rule should be set for the -default itemtype, default branchcode and default patron category. That -will catch anyone who doesn't match a specific rule. Patrons who do not -match a specific rule will get blocked from placing holds or renewing -items, since there was no baseline number of holds or renewals to -utilize. - -`Unable to Place Holds <#holdsfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Why can't I place holds when I have all of the preferences -turned on. - -**Answer**: You probably need to set a default circulation rule. At the -very least you will need to set an default circulation rule. This rule -should be set for all item types, all branches and all patron -categories. That will catch all instances that do not match a specific -rule. When checking out if you do not have a rule for the default -branch, default item and default patron category then you may see -patrons getting blocked from placing holds. - -`Keyboard Shortcuts <#keyboardshort>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Do I have to use my mouse to access the checkout, checkin -and cataloging tabs at the top of the circulation pages? - -**Answer**: You can jump between the tabs on the quick search box at the -top of the screen by using the following hot keys (if the tab is -available): - -- jump to the catalog search with Alt+Q - -- jump to the checkout with Alt+U - - - this will not work for Mac user - -- jump to the checkin with Alt+R - - **Note** - - Mac users use the OPTION button in place of ALT - -`SMS Notices/Messages <#smsnoticefaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: I want Koha to send notices via SMS, what do I need to do? - -**Answer**: First you need to choose a SMS service to use with Koha. -There is a list available here: -http://search.cpan.org/search?query=sms%3A%3Asend&mode=all Not all SMS -services available to libraries have Perl drivers, so be sure to check -this list to see if the provider you're considering is listed. If not -you want to ask your provider if they have a Perl module, if not you -should consider another service. Some common options in the US (that -have Perl drivers) are: - -- AQL (`www.aql.com `__) - -- Wadja (`wadja.com `__) - -- Ipipi (`ipipi.com `__) - -- T-mobile - -- SMSDiscount (`smsdiscount.com `__) - -- Clickatell - -**Question**: What about in India? - -**Answer**: India does not yet have too many options here. This is -partly due to the Telecom regulatory authority's (TRAI) stipulations -about transactional SMSes and limits on the number of SMSes that may be -sent / received per users per day. India specific drivers include: - -- Unicel Technologies Pvt Ltd (`unicel.in `__) - -`Cataloging <#catfaq>`__ ------------------------- - -`Authority Fields <#authorityfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question:**\ Why can't I edit 1xx, 6xx, or 7xx fields in my catalog -record? - -**Answer:** These fields are authority controlled and you probably have -the `BiblioAddsAuthorities <#BiblioAddsAuthorities>`__ set to "Don't -allow". When it is set to "Don't allow" these fields will be locked and -require you to search for an existing authority record to populate the -field with. To allow typing in these authority fields set -`BiblioAddsAuthorities <#BiblioAddsAuthorities>`__ to 'Allow'. - - **Note** - - Fields affected by this preference will show a lock symbol in them - -Fields affected by this preference show a lock in the field -|image1115| - -`Koha to MARC Mapping <#kohamarcfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: What's the relationship between 'Koha to MARC Mapping' and -'MARC Bibliographic Frameworks'? - -**Answer**: Mapping can be defined through 'MARC Bibliographic -Frameworks' OR 'Koha to MARC Mapping'. 'Koha to MARC Mapping' is just a -shortcut to speed up linkage. If you change a mapping in one of these -modules, the mapping will change in the other as well. (In other words, -the two modules 'overwrite' each other in order to prevent conflicts -from existing in Koha). - -`Number of Items Per Bib Record <#itemsperbibfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Is there a limit on the number of items I can attach to a -bib record? - -**Answer**: There is no explicit limit to the number of items you can -attach to a bibliographic record, but if you attach enough of them, your -MARC record will exceed the maximum file size limit for the ISO 2709 -standard, which breaks indexing for that record. I've found this occurs -somewhere between 600 and 1000 items on a 'normal' bibliographic record. - -`Analytics <#analyticsfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: I am using the -`EasyAnalyticalRecords <#EasyAnalyticalRecords>`__ feature, but my links -in the OPAC and Staff Client to 'Show Analytics' are not working. - -**Answer**: If you plan on using -`EasyAnalyticalRecords <#EasyAnalyticalRecords>`__ you will want to make -sure to set your `UseControlNumber <#UseControlNumber>`__ preference to -"Don't use," this will prevent broken links. - -`Acquisitions <#acqfaq>`__ --------------------------- - -`Planning Categories <#planningcatfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: What is a planning category? - -**Answer**: When you plan in advance for the way your budget is going to -be spent, you initially plan for how it's going to be spent over time, -that's the most natural thing to do. - -So you plan for $1000 in Jan. $1000 in Feb., $3000 in March, etc. You -can basically do the same thing with a list of values in lieu of the -months. - -Say you have a list like this one: - -- < 1 month - -- < 6 months - -- < 1 year - -- < 3 years - -- < 10 years - -- > 10 years - -The list is meant to represent when the books acquired where published. -Then you plan for it, saying: we went to spend at list 40% of our -budgets on books published less than a year ago, 10% on books more than -10 years old, etc. - -Upon acquiring new material, you'll be able to select, for a given item, -a value from this list in a drop down. Then, after the material has been -acquired, at the end of the year, you'll be able to compare the goals -set, with what's been achieved. - -`Serials <#serialsfaq>`__ -------------------------- - -`Advanced Patterns <#advancedpatternfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: What is the 'inner counter' on the advanced serials -pattern interface? - -**Answer**: I think it is better to give an example to understand this : - -Example for a monthly subscription : - -- First issue publication date : April 2010 - -- Numbering : No {X}, year {Y} - -- First issue : No 4, year 2010 - -For the year Y : you will want the year change on January 2011 - -So, the advanced pattern for Y will be : - -- Add : 1 - -- once every : 12 - -- When more than 9999999 - -- inner counter : 3 - -- Set back to 0 - -- Begins with 2010 - -Year is going to change after 12 received issues from April 2010, that -is in April 2011 if you don't set inner counter. Set inner counter to 3 -will say to Koha : change year after 12-3 = 9 received issues. - -Inner counter says to Koha to take into account the first issues of the -year, even if they are not received with Koha. If you begin with first -issue of the year write nothing or 0. - -`Reports <#reportsfaq>`__ -------------------------- - -`Define Codes Stored in DB <#accounttypefaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -`Fines Table <#finescodefaq>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question:** What do the codes in the accounttype field in the -accountlines table stand for? - -**Answer:** - -- A = Account management fee - -- C = Credit - -- F = Overdue fine - -- FOR = Forgiven - -- FU = Overdue, still acccruing - -- L = Lost item - -- LR = Lost item returned/refunded - -- M = Sundry - -- N = New card - -- PAY = Payment - -- W = Writeoff - -`Statistics Table <#statscodefaq>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question:**\ What are the possible codes for the type field in the -statistics table? - -**Answer:** - -- localuse - - - Registers if an item that had been checked out to a statistics - patron (category type = 'X') is returned - -- issue - -- return - -- renew - -- writeoff - -- payment - -- CreditXXX - - - The XXX stores different types of fee credits, so a query to catch - them all would include a clause like "type LIKE 'Credit%'" - -`Reserves Table <#rescodefaq>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question**: What are the possible codes for the found field in the -reserves and old\_reserves tables? - -**Answer**: - -- NULL: means the patron requested the 1st available, and we haven't - chosen the item - -- T = Transit: the reserve is linked to an item but is in transit to - the pickup branch - -- W = Waiting: the reserve is linked to an item, is at the pickup - branch, and is waiting on the hold shelf - -- F = Finished: the reserve has been completed, and is done - -`Reports Dictionary Table <#reportdicfaq>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question**: What are the possible codes for the area field in the -reports\_dictionary table? - -**Answer**: - -- 1 = Circulation - -- 2 = Catalog - -- 3 = Patrons - -- 4 = Acquisitions - -- 5 = Accounts - -`Messages Table <#msgtablefaq>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question**: What are the possible codes for the message\_type field in -the messages table? - -**Answer**: - -- L = For Librarians - -- B = For Patrons/Borrowers - -`Serial Table <#serialtablefaq>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question**: What are the possible codes for the status field in the -serial table? - -**Answer**: - -- 1 = Expected - -- 2 = Arrived - -- 3 = Late - -- 4 = Missing - -- 5 = Not available - -- 6 = Delete - -- 7 = Claimed - -- 8 = Stopped - -- 41 = Missing (not received) - -- 42 = Missing (sold out) - -- 43 = Missing (damaged) - -- 44 = Missing (lost) - -`Borrowers Table <#borrowerprivacyvalues>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question**: What are the possible codes for the privacy field in the -borrowers table? - -**Answer**: - -- 0 = Forever - -- 1 = Default - -- 2 = Never - -`Messaging Preferences <#messpreffaq>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question**: What are the possible codes in the message\_attribute\_id -field in the borrower\_message\_preferences table? - -**Answer**: - -- 2 = advanced notice - -- 6 = item checkout - -- 4 = hold filled - -- 1 = item due - -- 5 = item check in - -`Runtime Parameters <#runtimefaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Is there a way to filter my custom SQL reports before they -run? - -**Answer**: If you feel that your report might be too resource intensive -you might want to consider using runtime parameters to your query. -Runtime parameters basically make a filter appear before the report is -run to save your system resources. - -There is a specific syntax that Koha will understand as 'ask for values -when running the report'. The syntax is <>. - -- The << and >> are just delimiters. You must put << at the beginning - and >> at the end of your parameter - -- The 'Question to ask' will be displayed on the left of the string to - enter. - -- The authorized\_value can be omitted if not applicable. If it - contains an authorized value category, or branches or itemtype or - categorycode or biblio\_framework, a list with the Koha authorized - values will be displayed instead of a free field Note that you can - have more than one parameter in a given SQL Note that entering - nothing at run time won't probably work as you expect. It will be - considered as "value empty" not as "ignore this parameter". For - example entering nothing for : "title=<>" will display - results with title='' (no title). If you want to have to have - something not mandatory, use "title like <>" and enter a - % at run time instead of nothing - -Examples: - -- SELECT surname,firstname FROM borrowers WHERE branchcode=<> AND surname like <> - -- SELECT \* FROM items WHERE homebranch = <> and barcode like <> - -- SELECT title , author FROM biblio WHERE frameworkcode=<> - - **Note** - - To generate a date picker calendar to the right of the field when - running a report you can use the 'date' keyword like this: <> - - Date Picker - |image1116| - - **Note** - - You have to put "%" in a text box to 'leave it blank'. Otherwise, it - literally looks for "" (empty string) as the value for the field. - - **Important** - - In addition to using any authorized value code to generate a - dropdown, you can use the following values as well: Framework codes - (biblio\_framework), Branches (branches), Item Types (itemtypes) and - Patron Categories (categorycode). For example a branch pull down - would be generated like this <> - - Branch pull down - |image1117| - -`Results Limited <#reportlimitfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: When I download my report it's limited to 10,000 results, -how do I get all of the results to download? - -**Answer**: There is a limit of 10,000 records put on SQL statements -entered in Koha. To get around this you want to add 'LIMIT 100000' to -the end of your SQL statement (or any other number above 10,000. - -`Searching <#searchfaq>`__ --------------------------- - -`Advanced Search <#advancedsearchfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -`Scan Indexes <#scanindexfaq>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question**: What does 'scan indexes' on the advanced search page mean? - -**Answer**: When you choose an index, enter a term, click 'scan indexes' -and do the search, Koha displays the searched term and the following -terms found in this index with the number of corresponding records That -is search is not made directly in the catalog, but first in the indexes -It works only for one index at once, and only with no limit in Location -(All libraries needed) - -`Searching for Terms that Start With a Character <#searchstartswith>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question**: How do I search for all titles that start with the letter -'C'? - -**Answer**: You can choose to search for things that start with a -character or series of characters by using the CCL 'first-in-subfield' - -- example: ti,first-in-subfield=C - -`Wildcard Searching <#wildcardsearchfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**:What is the difference between a keyword search using the -'\*' (asterisk) versus a keyword search using the '%' (percent)? Both -work in the catalog, but return different sets. Why? - -**Answer**: A wildcard is a character (\*,?,%,.) that can be used to -represent one or more characters in a word. Two of the wildcard -characters that can be used in Koha searches are the asterisk ('\*') and -the percent sign ('%'). However, these two characters act differently -when used in searching. - -The '\*' is going to force a more exact search of the first few -characters you enter prior to the '\*'. The asterisk will allow for an -infinite number of characters in the search as long as the first few -characters designated by your search remain the same. For example, -searching for authors using the term, Smi\*, will return a list that may -include Smith, Smithers, Smithfield, Smiley, etc depending on the -authors in your database. - -The '%' will treat the words you enter in the terms of "is like". So a -search of Smi% will search for words like Smi. This results in a much -more varied results list. For example, a search on Smi% will return a -list containing Smothers, Smith, Smelley, Smithfield and many others -depending on what is your database. - -The bottom line in searching with wildcards: '\*' is more exact while -'%' searches for like terms. - -`Title Searching <#titlesearchingfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Why does my Zebra title search for 'Help' not turn up 'The -help' in the first pages of results? - -**Answer**: When doing a title search, you actually want to search for -the title (i.e., 'the help' rather than just 'help'), and it will bubble -right up to the top. If you're just searching for 'help' then the -relevance ranking is going to affect the results you see. - -When it comes to relevance in Zebra, here's what's happening. First, the -search is done. If you search for the title "help", then any title that -has "help" in it comes back. Then from those records, separately, it -does relevance on the \*whole\* record. The more your word appears, the -more relevant, and some MARC tags are worth more points than others. So -a self-help book with 505 notes where "help" appears a \*lot\* will be -at the top, regardless of keyword or title. - -But when you add a \*second word\*, that helps it figure things out, as -it's weighing the relevance of both words and the phrase. Because of the -way relevance works, if you search "the help", then "the help" or "the -help I need" are more relevant than "the way to help", because they -appear together in order. Likewise, "help the girl" would be lower -relevance, because it's out of order, and "help for the homeless" would -be lower still, as they're out of order, and apart. - -The moral of the story is that single word searches, particularly on -common words, will always struggle a bit; it can't evaluate relevance -well, because you've not given it enough input. - -`Enhanced Content <#enhancedcontentfaq>`__ ------------------------------------------- - -`FRBRizing Content <#frbrfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question:**\ At our public library we are running a Koha installation -and we've tried to turn on all the nice functionalities in Koha such as -the frbrising tool, but do not get the same result as Nelsonville public -library. - -**Answer:**\ In fact, this feature is quite tricky to make that right. -First it looks at XISBN service. And then search in your database for -that ISBN. So both XISBN and your internal ISBN (in biblio table) have -to be normalized. You could therefore use the script -misc/batchupdateISBNs.pl (it removes all the - in your local ISBNs) - -`Amazon <#amzfaq>`__ -~~~~~~~~~~~~~~~~~~~~ - -`All Amazon Content <#amazonfaq>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question**: I have all of the Amazon preferences turned on and have -entered both of my keys, but none of the content appears in my system, -why is that? - -**Answer**: Amazon's API checks your server time on all requests and if -your server time is not set properly requests will be denied. To resolve -this issue be sure to set your system time appropriately. Once that -change in made Amazon content should appear immediately. - -On Debian the the command is *date -s "2010-06-30 17:21"* (with the -proper date and time for your timezone). - -`System Administration <#systemfaq>`__ --------------------------------------- - -`Errors in Zebra Cron <#zebracronfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: I am noticing some errors in the -koha-zebradaemon-output.log file. When new records are added it takes a -bit longer to index than we think they should. Running rebuild zebra is -often faster. Zebra ends up indexing and search works, but I am -concerned about the errors. Any ideas? - -**Answer**: Rebuild\_zebra.pl -r deletes all of the files in the Zebra -db directories (such as reci-0.mf) and then recreates them. Thus, -permissions will be lost, and the files will be owned by the user who -ran rebuild\_zebra.pl. If one rebuilds the zebra indexes as root, the -daemons, which typically run under the user Koha, will not be able to -update the indexes. Thus, it's important then that the zebra rebuilds -are put in the cronjob file of the user Koha, and not root. Also -important is that other users, such as root, don't manually execute -rebuilds. - -If one desires that another user be able to execute rebuild\_zebra.pl, -he should be given the permission to execute 'sudo -u Koha -.../rebuild\_zebra.pl,' (if you want to do this, you also have to edit -the sudoers file to pass the PERL5LIB variable with the env\_keep option -as by default sudo strips away almost all environment variables). Or, as -root user, one can use a simple 'su koha' and then the rebuild\_zebra.pl -command. - -I've also tried to set the sticky bit on rebuild\_zebra.pl, but for -whatever reason it didn't seem to work due to some problem with the -PERL5LIB variable that I wasn't able to figure. That seems to me the -easiest thing to do, if anybody has any idea how to make it work. If it -worked and were the default, I think it would help folks to avoid a -great deal of the problems that come up with zebra. - -`Making Z39.50 Target Public <#publicztarget>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Could someone tell me the exact steps I need to take to -configure Zebra to expose my Koha 3 db as a public Z39.50 service? - -**Answer**: Edit the KOHA\_CONF file that your Koha is using. Uncomment -the publicserver line like: - - - -to be: - -tcp:@:9999 - -Then restart zebasrv and connect on the port specified (9999). - -`Shelving Location Authorized Values <#authvalfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: When editing an item, the new shelving location I created -is not showing up by default in the items where I assigned it to. - -**Answer**: This is because you created the new shelving location with a -code value of 0 (zero) Just FYI the system interprets authorized values -of 0 as equaling a null so when you edit a record in cataloging where -the authorized value in a field was assigned where the code was 0, the -value displays as null in the item editor (or MARC editor) instead of -the value the library meant it to be. - -`Why do I need Authorized Values? <#whyauthvals>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Why would I want to define authorized values for MARC -tags? - -**Answer**: Authorized Values create a 'controlled vocabulary' for your -staff. As an example, let us assume that your Koha installation is used -by several libraries, and you use MARC 21. You might want to restrict -the 850a MARC subfield to the institution codes for just those -libraries. In that case, you could define an authorized values category -(perhaps called "INST") and enter the institution codes as the -authorized values for that category. - - **Note** - - Koha automatically sets up authorized value categories for your item - types and branch codes, and you can link these authorized values to - MARC subfields when you set up your MARC tag structure. - -`How do I clean up the sessions table? <#sessionstblfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: Is there a periodic job that can be run to cull old -sessions from the table? We don't want to backup all the useless session -data every night. - -**Answer**: You can run `cleanup database cron job <#cleandbcron>`__. - -Or just before doing a backup command (mysqldump), you can truncate -session table:   - -:: - - mysql -u`__ ---------------------------- - -`Barcode Scanners <#barcodefaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Question**: What barcode scanners have been known to work with Koha? - -**Answer**: The simple rule of thumb is, does it act like a keyboard -device?, if so, it will work. (i.e. can you take the scanner, scan a -barcode and have it show up in a text editor, if so, it will work.) - -The main points to check are that it connects to your PC conveniently -(can be USB or "keyboard wedge" which means it connects in line with the -keyboard, which is useful with older computers), and that it scans the -barcode type that you are using. - -It is a good idea to test some 'used' barcodes if you have any, to see -whether the scanner can read scuffed or slightly wrinkled ones -successfully. Most scanners are capable of reading several barcode types -- there are many, and the specification should list the ones it can -read. You may need to adjust settings slightly, such as prefix and -suffix characters, or whether you want to send an 'enter' character or -not. - -One more tip - some can be set 'always on' and may come with a stand, -some have triggers under the handle, some have buttons on top, some are -held like a pen. Think about the staff working with the hardware before -choosing, as a button in the wrong place can be very awkward to use. - -`Printers <#printersfaq>`__ -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -`Printers used by Koha libraries <#kohaprinters>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -- POS-X receipt printer - -- Star Micronics printer (exact model unknown) with a generic/plain - text driver. - -- Star SP2000 (Nelsonville) - -- Star TSP-100 futurePRINT (Geauga) - - - "I know there have been a lot of questions on receipt printers so - I thought I'd pass on my findings. We have been testing the Star - TSP-100 futurePRINT. I found this print to be VERY easy to - configure for Koha. I was even able to customize the print job by - adding our system logo (a .gif) to the top of every receipt. Also - with a bitmap created in Paint was able to add a message at the - bottom of each receipt with the contact information, hours and - website for the library that the materials were checked out at." - -- Epson TM 88 IIIP thermal receipt printers - -- Epson TM-T88IV - -- 1x1 labels using a Dymolabelwriter printer - -`Braille Support <#braillefaq>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -**Question**: Are there any braille embosser or printer which has -inbuilt braille converter and it is accessible with UNIX environment? - -**Answer**: You may want to look into BRLTTY -(http://www.emptech.info/product_details.php?ID=1232). - -`Additional Support <#hardwaresupport>`__ -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -- http://www.nexpresslibrary.org/go-live/configure-your-receipt-printers/ - -Extending Koha -============== - -`Amazon lookup script for Koha libraries <#amzlookup>`__ --------------------------------------------------------- - -We order most of our materials from Amazon, so I've been looking for a -convenient way to tell if a book under consideration is in our catalog -already. - -Greasemonkey & a custom user script fit the bill nicely: - -- https://addons.mozilla.org/en-US/firefox/addon/748 - -- http://userscripts.org/scripts/show/56847 - -A few caveats: - -- Like most scripts, this one was designed to work with Firefox; I - haven't explored getting it to work with other browsers. - -- I'm not a JavaScript programmer -- this was adapted from others' - work. Just a few lines would have to be changed to get the script to - work with your catalog. - -- It depends on the existence of ISBN for the item in question, so - movies, older books, etc. would not work. - -Others have added all sorts of bells & whistles: XISBN lookups to search -for related titles, custom messages based on the status of items (on -order, on hold, etc.), ... just search the UserScripts site for Amazon + -library. For a later date! - -`Keyword Clouds <#extendkeywordclouds>`__ ------------------------------------------ - -In addition to the traditional tag cloud available in Koha, there is a -way to generate clouds for popular subjects within Koha. - -The `Author/Subject Cloud cron job <#keywordclouds>`__ is used to help -with this process. This cron job sends its output to files. - -- /home/koha/mylibrary/koharoot/koha-tmpl/cloud-author.html - -- /home/koha/yourlibrary/koharoot/koha-tmpl/cloud-subject.html - -This means that you can produce clouds for authors, collective author, -all kind of subjects, classifications, etc. And since it works on zebra -indexes, it is quick, even on large DBs. Tags clouds are sent to files. -It's up to library webmaster to deal with those files in order to -include them in `OPACMainUserBlock <#OpacMainUserBlock>`__, or include -them into their library CMS. - -Some libraries even send the file into a Samba shared folder where -webmaster take them, eventually clean them a little bit before -integrating them into navigation widgets or pages. - -`Newest Titles Pulldown <#newtitlesoption>`__ ---------------------------------------------- - -Often we want to add a way for our patrons to do searches for the newest -items. In this example I'll show you how to create a pull down menu of -the newest items by item type. These tips will work (with a couple -changes) for collection codes or shelving locations as well. - -First, it's important to note that every link in Koha is a permanent -link. This means if I do a search for everything of a specific item type -sorted by the acquisitions date and bookmark that URL, whenever I click -it I'll see the newest items of that type on the first few pages of the -results. - -I took this knowledge and wrote a form takes this functionality in to -consideration. It basically just does a search of your Koha catalog for -a specific item type and sorts the results by acquisitions date. - -The first thing I did was write a MySQL statement to generate a list of -item types for me - why copy and paste when you can use the power of -MySQL? - -:: - - select concat('') from itemtypes - -The above looks at the itemtypes table and slaps the necessary HTML -around each item type for me. I then exported that to CSV and opened it -in my text editor and added the other parts of the form. - -:: - -

New Items

-

- - - - -
-

- -Now, what does all of that mean? The important bits are these: - -First the starting of the form. - -:: - -

- -This tells the browser to take any value selected and put it at the end -of this http://YOURSITE/cgi-bin/koha/opac-search.pl. If you want to -embed this form on your library website (and not on your OPAC) you can -put the full OPAC URL in there. - -Next, there is a hidden value that is telling the search to sort by -acquisitions date descending (newest items at the top): - -:: - - - -And finally you have an option for each item type you want people to -search. - -:: - - - -These options each include the string "mc-itype:" which tells Koha to do -an item type search. - -Once you have all of that in place you can copy and paste the form to -somewhere on your OPAC. The `Farmington Public Libraries -OPAC `__ has a few examples of -this on the left. - -`Cataloging and Searching by Color <#colorsearch>`__ ----------------------------------------------------- - -One of the icon sets installed in Koha includes a series of colors. This -set can be used to catalog and search by color if you'd like. This guide -will walk you use changing collection code to color in Koha so that you -can do this. - -The following SQL could be used to add these colors to the CCODE -authorized value category in a batch. If you wanted to use these colors -for another authorized value you'd have to edit this to use that -category: - -:: - - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','000000','Black','','colors/000000.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','66cc66','Bright Green','','colors/66cc66.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','99cc33','Olive','','colors/99cc33.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','3333cc','Dark Blue','','colors/3333cc.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','006600' ,'Dark Green','','colors/006600.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','6600cc','Plum','','colors/6600cc.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','6666cc','Purple','','colors/6666cc.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','9999cc','Light Purple','','colors/9999cc.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','660000' ,'Burgundy','','colors/660000.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','663333' ,'Brown','','colors/663333.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','990000' ,'Red','','colors/990000.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','996633' ,'Tan','','colors/996633.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','999999' ,'Gray','','colors/999999.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','cc66cc','Pink','','colors/cc66cc.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','cc99cc','Bubble Gum','','colors/cc99cc.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','cc3333' ,'Orange','','colors/cc3333.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','cc6666' ,'Peach','','colors/cc6666.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','cc9999' ,'Rose','','colors/cc9999.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','cccc00' ,'Gold','','colors/cccc00.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','ffff33' ,'Yellow','','colors/ffff33.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','ffffcc','Cream','','colors/ffffcc.png'); - insert into authorised_values (category, authorised_value, lib, - lib_opac, imageurl) values ('CCODE','ffffff','White','','colors/ffffff.png'); - -If you would like to choose the colors manually you can do that via the -`Authorized Values <#authorizedvalues>`__ administration area. - -Colors for CCODE -|image1118| - -Next you'll want to `update the frameworks <#marcbibframeworks>`__ so -that the 952$8 (if you're using collection code) label to says Color. - -Once you have that in place you can start to catalog items by color. - -Finally you'll want to add the following JQuery to your preferences so -that it will relabel 'Collection' to 'Color' - -`IntranetUserJS <#intranetuserjs>`__ - -:: - - $(document).ready(function(){ - $("#advsearch-tab-ccode a:contains('Collection')").text("Color"); - $("#holdings th:contains('Collection')").text("Color"); - }); - -`OPACUserJS <#opacuserjs>`__ - -:: - - $(document).ready(function(){ - $("#advsearch-tab-ccode a:contains('Collection')").text("Color"); - $('#item_ccode').text("Color"); - }); - -Koha and Your Website -===================== - -This appendix will include tips for integrating Koha in to your library -website. - -`Koha search on your site <#embedsearch>`__ -------------------------------------------- - -Often you'll want to add a Koha search box to your library website. To -do so, just copy and paste the following code in to your library website -and update the YOURCATALOG bit with your catalog's URL and you're set to -go. - -:: - - -

- - -

- - -GNU General Public License version 3 -==================================== - -Version 3, 29 June 2007 - -Copyright © 2007 Free Software Foundation, Inc. http://fsf.org/ - -Everyone is permitted to copy and distribute verbatim copies of this -license document, but changing it is not allowed. - -**Preamble** - -The GNU General Public License is a free, copyleft license for software -and other kinds of works. - -The licenses for most software and other practical works are designed to -take away your freedom to share and change the works. By contrast, the -GNU General Public License is intended to guarantee your freedom to -share and change all versions of a program--to make sure it remains free -software for all its users. We, the Free Software Foundation, use the -GNU General Public License for most of our software; it applies also to -any other work released this way by its authors. You can apply it to -your programs, too. - -When we speak of free software, we are referring to freedom, not price. -Our General Public Licenses are designed to make sure that you have the -freedom to distribute copies of free software (and charge for them if -you wish), that you receive source code or can get it if you want it, -that you can change the software or use pieces of it in new free -programs, and that you know you can do these things. - -To protect your rights, we need to prevent others from denying you these -rights or asking you to surrender the rights. Therefore, you have -certain responsibilities if you distribute copies of the software, or if -you modify it: responsibilities to respect the freedom of others. - -For example, if you distribute copies of such a program, whether gratis -or for a fee, you must pass on to the recipients the same freedoms that -you received. You must make sure that they, too, receive or can get the -source code. And you must show them these terms so they know their -rights. - -Developers that use the GNU GPL protect your rights with two steps: (1) -assert copyright on the software, and (2) offer you this License giving -you legal permission to copy, distribute and/or modify it. - -For the developers' and authors' protection, the GPL clearly explains -that there is no warranty for this free software. For both users' and -authors' sake, the GPL requires that modified versions be marked as -changed, so that their problems will not be attributed erroneously to -authors of previous versions. - -Some devices are designed to deny users access to install or run -modified versions of the software inside them, although the manufacturer -can do so. This is fundamentally incompatible with the aim of protecting -users' freedom to change the software. The systematic pattern of such -abuse occurs in the area of products for individuals to use, which is -precisely where it is most unacceptable. Therefore, we have designed -this version of the GPL to prohibit the practice for those products. If -such problems arise substantially in other domains, we stand ready to -extend this provision to those domains in future versions of the GPL, as -needed to protect the freedom of users. - -Finally, every program is threatened constantly by software patents. -States should not allow patents to restrict development and use of -software on general-purpose computers, but in those that do, we wish to -avoid the special danger that patents applied to a free program could -make it effectively proprietary. To prevent this, the GPL assures that -patents cannot be used to render the program non-free. - -The precise terms and conditions for copying, distribution and -modification follow. - -**TERMS AND CONDITIONS** - -**0. Definitions.** - -"This License" refers to version 3 of the GNU General Public License. - -"Copyright" also means copyright-like laws that apply to other kinds of -works, such as semiconductor masks. - -"The Program" refers to any copyrightable work licensed under this -License. Each licensee is addressed as "you". "Licensees" and -"recipients" may be individuals or organizations. - -To "modify" a work means to copy from or adapt all or part of the work -in a fashion requiring copyright permission, other than the making of an -exact copy. The resulting work is called a "modified version" of the -earlier work or a work "based on" the earlier work. - -A "covered work" means either the unmodified Program or a work based on -the Program. - -To "propagate" a work means to do anything with it that, without -permission, would make you directly or secondarily liable for -infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, -distribution (with or without modification), making available to the -public, and in some countries other activities as well. - -To "convey" a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through -a computer network, with no transfer of a copy, is not conveying. - -An interactive user interface displays "Appropriate Legal Notices" to -the extent that it includes a convenient and prominently visible feature -that (1) displays an appropriate copyright notice, and (2) tells the -user that there is no warranty for the work (except to the extent that -warranties are provided), that licensees may convey the work under this -License, and how to view a copy of this License. If the interface -presents a list of user commands or options, such as a menu, a prominent -item in the list meets this criterion. - -**1. Source Code.** - -The "source code" for a work means the preferred form of the work for -making modifications to it. "Object code" means any non-source form of a -work. - -A "Standard Interface" means an interface that either is an official -standard defined by a recognized standards body, or, in the case of -interfaces specified for a particular programming language, one that is -widely used among developers working in that language. - -The "System Libraries" of an executable work include anything, other -than the work as a whole, that (a) is included in the normal form of -packaging a Major Component, but which is not part of that Major -Component, and (b) serves only to enable use of the work with that Major -Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A "Major -Component", in this context, means a major essential component (kernel, -window system, and so on) of the specific operating system (if any) on -which the executable work runs, or a compiler used to produce the work, -or an object code interpreter used to run it. - -The "Corresponding Source" for a work in object code form means all the -source code needed to generate, install, and (for an executable work) -run the object code and to modify the work, including scripts to control -those activities. However, it does not include the work's System -Libraries, or general-purpose tools or generally available free programs -which are used unmodified in performing those activities but which are -not part of the work. For example, Corresponding Source includes -interface definition files associated with source files for the work, -and the source code for shared libraries and dynamically linked -subprograms that the work is specifically designed to require, such as -by intimate data communication or control flow between those subprograms -and other parts of the work. - -The Corresponding Source need not include anything that users can -regenerate automatically from other parts of the Corresponding Source. - -The Corresponding Source for a work in source code form is that same -work. - -**2. Basic Permissions.** - -All rights granted under this License are granted for the term of -copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a -covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your -rights of fair use or other equivalent, as provided by copyright law. - -You may make, run and propagate covered works that you do not convey, -without conditions so long as your license otherwise remains in force. -You may convey covered works to others for the sole purpose of having -them make modifications exclusively for you, or provide you with -facilities for running those works, provided that you comply with the -terms of this License in conveying all material for which you do not -control copyright. Those thus making or running the covered works for -you must do so exclusively on your behalf, under your direction and -control, on terms that prohibit them from making any copies of your -copyrighted material outside their relationship with you. - -Conveying under any other circumstances is permitted solely under the -conditions stated below. Sublicensing is not allowed; section 10 makes -it unnecessary. - -**3. Protecting Users' Legal Rights From Anti-Circumvention Law.** - -No covered work shall be deemed part of an effective technological -measure under any applicable law fulfilling obligations under article 11 -of the WIPO copyright treaty adopted on 20 December 1996, or similar -laws prohibiting or restricting circumvention of such measures. - -When you convey a covered work, you waive any legal power to forbid -circumvention of technological measures to the extent such circumvention -is effected by exercising rights under this License with respect to the -covered work, and you disclaim any intention to limit operation or -modification of the work as a means of enforcing, against the work's -users, your or third parties' legal rights to forbid circumvention of -technological measures. - -**4. Conveying Verbatim Copies.** - -You may convey verbatim copies of the Program's source code as you -receive it, in any medium, provided that you conspicuously and -appropriately publish on each copy an appropriate copyright notice; keep -intact all notices stating that this License and any non-permissive -terms added in accord with section 7 apply to the code; keep intact all -notices of the absence of any warranty; and give all recipients a copy -of this License along with the Program. - -You may charge any price or no price for each copy that you convey, and -you may offer support or warranty protection for a fee. - -**5. Conveying Modified Source Versions.** - -You may convey a work based on the Program, or the modifications to -produce it from the Program, in the form of source code under the terms -of section 4, provided that you also meet all of these conditions: - -a. The work must carry prominent notices stating that you modified it, - and giving a relevant date. - -b. The work must carry prominent notices stating that it is released - under this License and any conditions added under section 7. This - requirement modifies the requirement in section 4 to "keep intact all - notices". - -c. You must license the entire work, as a whole, under this License to - anyone who comes into possession of a copy. This License will - therefore apply, along with any applicable section 7 additional - terms, to the whole of the work, and all its parts, regardless of how - they are packaged. This License gives no permission to license the - work in any other way, but it does not invalidate such permission if - you have separately received it. - -d. If the work has interactive user interfaces, each must display - Appropriate Legal Notices; however, if the Program has interactive - interfaces that do not display Appropriate Legal Notices, your work - need not make them do so. - -A compilation of a covered work with other separate and independent -works, which are not by their nature extensions of the covered work, and -which are not combined with it such as to form a larger program, in or -on a volume of a storage or distribution medium, is called an -"aggregate" if the compilation and its resulting copyright are not used -to limit the access or legal rights of the compilation's users beyond -what the individual works permit. Inclusion of a covered work in an -aggregate does not cause this License to apply to the other parts of the -aggregate. - -**6. Conveying Non-Source Forms.** - -You may convey a covered work in object code form under the terms of -sections 4 and 5, provided that you also convey the machine-readable -Corresponding Source under the terms of this License, in one of these -ways: - -a. Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by the - Corresponding Source fixed on a durable physical medium customarily - used for software interchange. - -b. Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by a written - offer, valid for at least three years and valid for as long as you - offer spare parts or customer support for that product model, to give - anyone who possesses the object code either (1) a copy of the - Corresponding Source for all the software in the product that is - covered by this License, on a durable physical medium customarily - used for software interchange, for a price no more than your - reasonable cost of physically performing this conveying of source, or - (2) access to copy the Corresponding Source from a network server at - no charge. - -c. Convey individual copies of the object code with a copy of the - written offer to provide the Corresponding Source. This alternative - is allowed only occasionally and noncommercially, and only if you - received the object code with such an offer, in accord with - subsection 6b. - -d. Convey the object code by offering access from a designated place - (gratis or for a charge), and offer equivalent access to the - Corresponding Source in the same way through the same place at no - further charge. You need not require recipients to copy the - Corresponding Source along with the object code. If the place to copy - the object code is a network server, the Corresponding Source may be - on a different server (operated by you or a third party) that - supports equivalent copying facilities, provided you maintain clear - directions next to the object code saying where to find the - Corresponding Source. Regardless of what server hosts the - Corresponding Source, you remain obligated to ensure that it is - available for as long as needed to satisfy these requirements. - -e. Convey the object code using peer-to-peer transmission, provided you - inform other peers where the object code and Corresponding Source of - the work are being offered to the general public at no charge under - subsection 6d. - -A separable portion of the object code, whose source code is excluded -from the Corresponding Source as a System Library, need not be included -in conveying the object code work. - -A "User Product" is either (1) a "consumer product", which means any -tangible personal property which is normally used for personal, family, -or household purposes, or (2) anything designed or sold for -incorporation into a dwelling. In determining whether a product is a -consumer product, doubtful cases shall be resolved in favor of coverage. -For a particular product received by a particular user, "normally used" -refers to a typical or common use of that class of product, regardless -of the status of the particular user or of the way in which the -particular user actually uses, or expects or is expected to use, the -product. A product is a consumer product regardless of whether the -product has substantial commercial, industrial or non-consumer uses, -unless such uses represent the only significant mode of use of the -product. - -"Installation Information" for a User Product means any methods, -procedures, authorization keys, or other information required to install -and execute modified versions of a covered work in that User Product -from a modified version of its Corresponding Source. The information -must suffice to ensure that the continued functioning of the modified -object code is in no case prevented or interfered with solely because -modification has been made. - -If you convey an object code work under this section in, or with, or -specifically for use in, a User Product, and the conveying occurs as -part of a transaction in which the right of possession and use of the -User Product is transferred to the recipient in perpetuity or for a -fixed term (regardless of how the transaction is characterized), the -Corresponding Source conveyed under this section must be accompanied by -the Installation Information. But this requirement does not apply if -neither you nor any third party retains the ability to install modified -object code on the User Product (for example, the work has been -installed in ROM). - -The requirement to provide Installation Information does not include a -requirement to continue to provide support service, warranty, or updates -for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to a -network may be denied when the modification itself materially and -adversely affects the operation of the network or violates the rules and -protocols for communication across the network. - -Corresponding Source conveyed, and Installation Information provided, in -accord with this section must be in a format that is publicly documented -(and with an implementation available to the public in source code -form), and must require no special password or key for unpacking, -reading or copying. - -**7. Additional Terms.** - -"Additional permissions" are terms that supplement the terms of this -License by making exceptions from one or more of its conditions. -Additional permissions that are applicable to the entire Program shall -be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions -apply only to part of the Program, that part may be used separately -under those permissions, but the entire Program remains governed by this -License without regard to the additional permissions. - -When you convey a copy of a covered work, you may at your option remove -any additional permissions from that copy, or from any part of it. -(Additional permissions may be written to require their own removal in -certain cases when you modify the work.) You may place additional -permissions on material, added by you to a covered work, for which you -have or can give appropriate copyright permission. - -Notwithstanding any other provision of this License, for material you -add to a covered work, you may (if authorized by the copyright holders -of that material) supplement the terms of this License with terms: - -a. Disclaiming warranty or limiting liability differently from the terms - of sections 15 and 16 of this License; or - -b. Requiring preservation of specified reasonable legal notices or - author attributions in that material or in the Appropriate Legal - Notices displayed by works containing it; or - -c. Prohibiting misrepresentation of the origin of that material, or - requiring that modified versions of such material be marked in - reasonable ways as different from the original version; or - -d. Limiting the use for publicity purposes of names of licensors or - authors of the material; or - -e. Declining to grant rights under trademark law for use of some trade - names, trademarks, or service marks; or - -f. Requiring indemnification of licensors and authors of that material - by anyone who conveys the material (or modified versions of it) with - contractual assumptions of liability to the recipient, for any - liability that these contractual assumptions directly impose on those - licensors and authors. - -All other non-permissive additional terms are considered "further -restrictions" within the meaning of section 10. If the Program as you -received it, or any part of it, contains a notice stating that it is -governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains a -further restriction but permits relicensing or conveying under this -License, you may add to a covered work material governed by the terms of -that license document, provided that the further restriction does not -survive such relicensing or conveying. - -If you add terms to a covered work in accord with this section, you must -place, in the relevant source files, a statement of the additional terms -that apply to those files, or a notice indicating where to find the -applicable terms. - -Additional terms, permissive or non-permissive, may be stated in the -form of a separately written license, or stated as exceptions; the above -requirements apply either way. - -**8. Termination.** - -You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or -modify it is void, and will automatically terminate your rights under -this License (including any patent licenses granted under the third -paragraph of section 11). - -However, if you cease all violation of this License, then your license -from a particular copyright holder is reinstated (a) provisionally, -unless and until the copyright holder explicitly and finally terminates -your license, and (b) permanently, if the copyright holder fails to -notify you of the violation by some reasonable means prior to 60 days -after the cessation. - -Moreover, your license from a particular copyright holder is reinstated -permanently if the copyright holder notifies you of the violation by -some reasonable means, this is the first time you have received notice -of violation of this License (for any work) from that copyright holder, -and you cure the violation prior to 30 days after your receipt of the -notice. - -Termination of your rights under this section does not terminate the -licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently -reinstated, you do not qualify to receive new licenses for the same -material under section 10. - -**9. Acceptance Not Required for Having Copies.** - -You are not required to accept this License in order to receive or run a -copy of the Program. Ancillary propagation of a covered work occurring -solely as a consequence of using peer-to-peer transmission to receive a -copy likewise does not require acceptance. However, nothing other than -this License grants you permission to propagate or modify any covered -work. These actions infringe copyright if you do not accept this -License. Therefore, by modifying or propagating a covered work, you -indicate your acceptance of this License to do so. - -**10. Automatic Licensing of Downstream Recipients.** - -Each time you convey a covered work, the recipient automatically -receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible -for enforcing compliance by third parties with this License. - -An "entity transaction" is a transaction transferring control of an -organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered work -results from an entity transaction, each party to that transaction who -receives a copy of the work also receives whatever licenses to the work -the party's predecessor in interest had or could give under the previous -paragraph, plus a right to possession of the Corresponding Source of the -work from the predecessor in interest, if the predecessor has it or can -get it with reasonable efforts. - -You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may not -impose a license fee, royalty, or other charge for exercise of rights -granted under this License, and you may not initiate litigation -(including a cross-claim or counterclaim in a lawsuit) alleging that any -patent claim is infringed by making, using, selling, offering for sale, -or importing the Program or any portion of it. - -**11. Patents.** - -A "contributor" is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The work -thus licensed is called the contributor's "contributor version". - -A contributor's "essential patent claims" are all patent claims owned or -controlled by the contributor, whether already acquired or hereafter -acquired, that would be infringed by some manner, permitted by this -License, of making, using, or selling its contributor version, but do -not include claims that would be infringed only as a consequence of -further modification of the contributor version. For purposes of this -definition, "control" includes the right to grant patent sublicenses in -a manner consistent with the requirements of this License. - -Each contributor grants you a non-exclusive, worldwide, royalty-free -patent license under the contributor's essential patent claims, to make, -use, sell, offer for sale, import and otherwise run, modify and -propagate the contents of its contributor version. - -In the following three paragraphs, a "patent license" is any express -agreement or commitment, however denominated, not to enforce a patent -(such as an express permission to practice a patent or covenant not to -sue for patent infringement). To "grant" such a patent license to a -party means to make such an agreement or commitment not to enforce a -patent against the party. - -If you convey a covered work, knowingly relying on a patent license, and -the Corresponding Source of the work is not available for anyone to -copy, free of charge and under the terms of this License, through a -publicly available network server or other readily accessible means, -then you must either (1) cause the Corresponding Source to be so -available, or (2) arrange to deprive yourself of the benefit of the -patent license for this particular work, or (3) arrange, in a manner -consistent with the requirements of this License, to extend the patent -license to downstream recipients. "Knowingly relying" means you have -actual knowledge that, but for the patent license, your conveying the -covered work in a country, or your recipient's use of the covered work -in a country, would infringe one or more identifiable patents in that -country that you have reason to believe are valid. - -If, pursuant to or in connection with a single transaction or -arrangement, you convey, or propagate by procuring conveyance of, a -covered work, and grant a patent license to some of the parties -receiving the covered work authorizing them to use, propagate, modify or -convey a specific copy of the covered work, then the patent license you -grant is automatically extended to all recipients of the covered work -and works based on it. - -A patent license is "discriminatory" if it does not include within the -scope of its coverage, prohibits the exercise of, or is conditioned on -the non-exercise of one or more of the rights that are specifically -granted under this License. You may not convey a covered work if you are -a party to an arrangement with a third party that is in the business of -distributing software, under which you make payment to the third party -based on the extent of your activity of conveying the work, and under -which the third party grants, to any of the parties who would receive -the covered work from you, a discriminatory patent license (a) in -connection with copies of the covered work conveyed by you (or copies -made from those copies), or (b) primarily for and in connection with -specific products or compilations that contain the covered work, unless -you entered into that arrangement, or that patent license was granted, -prior to 28 March 2007. - -Nothing in this License shall be construed as excluding or limiting any -implied license or other defenses to infringement that may otherwise be -available to you under applicable patent law. - -**12. No Surrender of Others' Freedom.** - -If conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a -covered work so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you -may not convey it at all. For example, if you agree to terms that -obligate you to collect a royalty for further conveying from those to -whom you convey the Program, the only way you could satisfy both those -terms and this License would be to refrain entirely from conveying the -Program. - -**13. Use with the GNU Affero General Public License.** - -Notwithstanding any other provision of this License, you have permission -to link or combine any covered work with a work licensed under version 3 -of the GNU Affero General Public License into a single combined work, -and to convey the resulting work. The terms of this License will -continue to apply to the part which is the covered work, but the special -requirements of the GNU Affero General Public License, section 13, -concerning interaction through a network will apply to the combination -as such. - -**14. Revised Versions of this License.** - -The Free Software Foundation may publish revised and/or new versions of -the GNU General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - -Each version is given a distinguishing version number. If the Program -specifies that a certain numbered version of the GNU General Public -License "or any later version" applies to it, you have the option of -following the terms and conditions either of that numbered version or of -any later version published by the Free Software Foundation. If the -Program does not specify a version number of the GNU General Public -License, you may choose any version ever published by the Free Software -Foundation. - -If the Program specifies that a proxy can decide which future versions -of the GNU General Public License can be used, that proxy's public -statement of acceptance of a version permanently authorizes you to -choose that version for the Program. - -Later license versions may give you additional or different permissions. -However, no additional obligations are imposed on any author or -copyright holder as a result of your choosing to follow a later version. - -**15. Disclaimer of Warranty.** - -THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT -HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT -WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT -LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A -PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF -THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME -THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. - -**16. Limitation of Liability.** - -IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR -CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, -INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES -ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT -NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES -SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE -WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN -ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. - -**17. Interpretation of Sections 15 and 16.** - -If the disclaimer of warranty and limitation of liability provided above -cannot be given local legal effect according to their terms, reviewing -courts shall apply local law that most closely approximates an absolute -waiver of all civil liability in connection with the Program, unless a -warranty or assumption of liability accompanies a copy of the Program in -return for a fee. - -**END OF TERMS AND CONDITIONS** - -**How to Apply These Terms to Your New Programs** - -If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these -terms. - -To do so, attach the following notices to the program. It is safest to -attach them to the start of each source file to most effectively state -the exclusion of warranty; and each file should have at least the -"copyright" line and a pointer to where the full notice is found. - -:: - - one line to give the program's name and a brief idea of what it does. - Copyright (C) year name of author - - This program is free software: you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation, either version 3 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program. If not, see http://www.gnu.org/licenses/. - - -Also add information on how to contact you by electronic and paper mail. - -If the program does terminal interaction, make it output a short notice -like this when it starts in an interactive mode: - -:: - - program Copyright (C) year name of author - This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. - This is free software, and you are welcome to redistribute it - under certain conditions; type `show c' for details. - - -The hypothetical commands \`\ ``show w``' and \`\ ``show c``' should -show the appropriate parts of the General Public License. Of course, -your program's commands might be different; for a GUI interface, you -would use an "about box". - -You should also get your employer (if you work as a programmer) or -school, if any, to sign a "copyright disclaimer" for the program, if -necessary. For more information on this, and how to apply and follow the -GNU GPL, see http://www.gnu.org/licenses/. - -The GNU General Public License does not permit incorporating your -program into proprietary programs. If your program is a subroutine -library, you may consider it more useful to permit linking proprietary -applications with the library. If this is what you want to do, use the -GNU Lesser General Public License instead of this License. But first, -please read http://www.gnu.org/philosophy/why-not-lgpl.html. - -.. |image0| image:: images/admin/globalprefs/prefsearch.png -.. |image1| image:: images/admin/globalprefs/prefsearch1.png -.. |image2| image:: images/admin/globalprefs/saveallprefs.png -.. |image3| image:: images/admin/globalprefs/saveconfirmation.png -.. |image4| image:: images/admin/globalprefs/sortprefs.png -.. |image5| image:: images/admin/globalprefs/Google/2newproject.png -.. |image6| image:: images/admin/globalprefs/Google/3identity.png -.. |image7| image:: images/admin/globalprefs/Google/4enable.png -.. |image8| image:: images/admin/globalprefs/Google/5consent.png -.. |image9| image:: images/admin/globalprefs/Google/6credtype.png -.. |image10| image:: images/admin/globalprefs/Google/7creds.png -.. |image11| image:: images/admin/globalprefs/Google/8oauth.png -.. |image12| image:: images/admin/globalprefs/Google/7creds.png -.. |image13| image:: images/admin/globalprefs/persona.png -.. |image14| image:: images/admin/globalprefs/AuthDisplayHierarchy.png -.. |image15| image:: images/admin/globalprefs/hide_marc-display.png -.. |image16| image:: images/admin/globalprefs/hide_marc-dont.png -.. |image17| image:: images/admin/globalprefs/LabelMARCView-do.png -.. |image18| image:: images/admin/globalprefs/LabelMARCView-dont.png -.. |image19| image:: images/admin/globalprefs/SeparateHoldings.png -.. |image20| image:: images/admin/globalprefs/advancedMARCeditor-display.png -.. |image21| image:: images/admin/globalprefs/advancedMARCeditor-dontdisplay.png -.. |image22| image:: images/admin/globalprefs/AlternateHoldingsField.png -.. |image23| image:: images/admin/globalprefs/item-level_itypes.png -.. |image24| image:: images/admin/globalprefs/SpineLabelShowPrintOnBibDetails.png -.. |image25| image:: images/admin/globalprefs/AgeRestrictionOverride.png -.. |image26| image:: images/admin/globalprefs/AgeRestrictionMarker.png -.. |image27| image:: images/admin/globalprefs/AllowTooManyOverride-yes.png -.. |image28| image:: images/admin/globalprefs/AllowTooManyOverride-no.png -.. |image29| image:: images/admin/globalprefs/IssueLostItem-msg.png -.. |image30| image:: images/admin/globalprefs/IssueLostItem-confirm.png -.. |image31| image:: images/admin/globalprefs/OnSiteCheckoutsForce.png -.. |image32| image:: images/admin/globalprefs/decreaseLoanHighHoldsDuration.png -.. |image33| image:: images/admin/globalprefs/CircAutocompl.png -.. |image34| image:: images/admin/globalprefs/FilterBeforeOverdueReport.png -.. |image35| image:: images/admin/globalprefs/FineNotifyAtCheckin.png -.. |image36| image:: images/admin/globalprefs/DisplayClearScreenButtonOff.png -.. |image37| image:: images/admin/globalprefs/DisplayClearScreenButton.png -.. |image38| image:: images/admin/globalprefs/ExportRemoveFields.png -.. |image39| image:: images/admin/globalprefs/ExportWithCsvProfile.png -.. |image40| image:: images/admin/globalprefs/itemBarcodeFallbackSearch.png -.. |image41| image:: images/admin/globalprefs/SpecifyDueDate.png -.. |image42| image:: images/admin/globalprefs/SpecifyDueDate-no.png -.. |image43| image:: images/admin/globalprefs/WaitingNotifyAtCheckin.png -.. |image44| image:: images/circ/selfcheckout.png -.. |image45| image:: images/circ/SelfCheckoutByLogin.png -.. |image46| image:: images/admin/globalprefs/editionstab.png -.. |image47| image:: images/admin/globalprefs/editions.png -.. |image48| image:: images/admin/globalprefs/Babeltheque.png -.. |image49| image:: images/admin/globalprefs/HTML5MediaEnabled-opac.png -.. |image50| image:: images/admin/globalprefs/HTML5MediaEnabled-staff.png -.. |image51| image:: images/admin/globalprefs/IDreamBooksReadometer.png -.. |image52| image:: images/admin/globalprefs/IDreamBooksResults.png -.. |image53| image:: images/admin/globalprefs/IDreamBooksReviews.png -.. |image54| image:: images/admin/globalprefs/AllowMultipleCovers.png -.. |image55| image:: images/admin/globalprefs/novelisttab.png -.. |image56| image:: images/admin/globalprefs/novelistside.png -.. |image57| image:: images/admin/globalprefs/Overdrive.png -.. |image58| image:: images/admin/globalprefs/TagsInputOnList.png -.. |image59| image:: images/admin/globalprefs/TagsInputOnDetail.png -.. |image60| image:: images/admin/globalprefs/alphabet.png -.. |image61| image:: images/admin/globalprefs/opaclanguagesdisplay.png -.. |image62| image:: images/admin/globalprefs/DisplayOPACiconsXSLT.png -.. |image63| image:: images/admin/globalprefs/hidelostitems.png -.. |image64| image:: images/admin/globalprefs/LibraryName.png -.. |image65| image:: images/admin/globalprefs/OpacAddMastheadLibraryPulldown-add.png -.. |image66| image:: images/admin/globalprefs/OpacAddMastheadLibraryPulldown-dontadd.png -.. |image67| image:: images/admin/globalprefs/OPACBaseURL.png -.. |image68| image:: images/admin/globalprefs/opaccredits-html.png -.. |image69| image:: images/admin/globalprefs/opaccredits.png -.. |image70| image:: images/admin/globalprefs/OPACDisplay856uAsImage.png -.. |image71| image:: images/admin/globalprefs/856imagemarc.png -.. |image72| image:: images/admin/globalprefs/favicon.png -.. |image73| image:: images/admin/globalprefs/opacheader-html.png -.. |image74| image:: images/admin/globalprefs/opacheader.png -.. |image75| image:: images/admin/globalprefs/OpacKohaUrl.png -.. |image76| image:: images/admin/globalprefs/opacmaintenance.png -.. |image77| image:: images/admin/globalprefs/OpacMainUserBlock.png -.. |image78| image:: images/admin/globalprefs/OPACMySummaryHTML.png -.. |image79| image:: images/admin/globalprefs/OpacNav.png -.. |image80| image:: images/admin/globalprefs/OpacNavBottom.png -.. |image81| image:: images/admin/globalprefs/OpacNavRight.png -.. |image82| image:: images/admin/globalprefs/OPACNoResultsFound.png -.. |image83| image:: images/admin/globalprefs/OpacSeparateHoldings.png -.. |image84| image:: images/admin/globalprefs/OPACShowBarcode-noshow.png -.. |image85| image:: images/admin/globalprefs/OPACShowBarcode-show.png -.. |image86| image:: images/admin/globalprefs/OPACShowHoldQueueDetails-showholds.png -.. |image87| image:: images/admin/globalprefs/OPACShowHoldQueueDetails-priority.png -.. |image88| image:: images/admin/globalprefs/OpacShowRecentComments.png -.. |image89| image:: images/admin/globalprefs/OpacStarRatings-details.png -.. |image90| image:: images/admin/globalprefs/OpacStarRatings-results.png -.. |image91| image:: images/admin/globalprefs/opacuserjs-before.png -.. |image92| image:: images/admin/globalprefs/opacuserjs.png -.. |image93| image:: images/admin/globalprefs/opacuserjs-after.png -.. |image94| image:: images/admin/globalprefs/authoritysearch.png -.. |image95| image:: images/admin/globalprefs/OpacBrowseResults.png -.. |image96| image:: images/admin/globalprefs/OpacHoldNotes.png -.. |image97| image:: images/admin/globalprefs/OPACPatronDetails.png -.. |image98| image:: images/admin/globalprefs/OPACPatronDetails-approve.png -.. |image99| image:: images/admin/globalprefs/OpacTopissue.png -.. |image100| image:: images/admin/globalprefs/topissues.png -.. |image101| image:: images/admin/globalprefs/ShowReviewerPhoto.png -.. |image102| image:: images/admin/globalprefs/SocialNetworks.png -.. |image103| image:: images/admin/globalprefs/PatronSelfRegistration.png -.. |image104| image:: images/admin/globalprefs/OPACShelfBrowser.png -.. |image105| image:: images/admin/globalprefs/SMSSendDriver.png -.. |image106| image:: images/admin/globalprefs/StatisticsFields.png -.. |image107| image:: images/admin/globalprefs/displayFacetCount.png -.. |image108| image:: images/admin/globalprefs/AdvancedSearchTypes.png -.. |image109| image:: images/admin/globalprefs/opacSerialDefaultTab-colltab.png -.. |image110| image:: images/admin/globalprefs/opacSerialDefaultTab-subtab.png -.. |image111| image:: images/admin/globalprefs/SubscriptionHistory-brief.png -.. |image112| image:: images/admin/globalprefs/SubscriptionHistory-full.png -.. |image113| image:: images/admin/globalprefs/Display856uAsImage.png -.. |image114| image:: images/admin/globalprefs/856imagemarc.png -.. |image115| image:: images/admin/globalprefs/DisplayIconsXSLT.png -.. |image116| image:: images/admin/globalprefs/favicon.png -.. |image117| image:: images/admin/globalprefs/IntranetmainUserblock-html.png -.. |image118| image:: images/admin/globalprefs/IntranetmainUserblock.png -.. |image119| image:: images/admin/globalprefs/XSLTDetailsDisplay-off.png -.. |image120| image:: images/admin/globalprefs/XSLTDetailsDisplay-on.png -.. |image121| image:: images/admin/globalprefs/StaffDetailItemSelection.png -.. |image122| image:: images/admin/basicparams/librarylist.png -.. |image123| image:: images/admin/basicparams/grouplists.png -.. |image124| image:: images/admin/basicparams/newlibrary.png -.. |image125| image:: images/admin/basicparams/librarycontact.png -.. |image126| image:: images/admin/basicparams/librarylink.png -.. |image127| image:: images/admin/basicparams/opacinfo.png -.. |image128| image:: images/admin/basicparams/cannotdeletelibrary.png -.. |image129| image:: images/admin/basicparams/addlibgroup.png -.. |image130| image:: images/admin/basicparams/searchgroup.png -.. |image131| image:: images/admin/basicparams/stafflibgroupsearch.png -.. |image132| image:: images/admin/basicparams/groupproperties.png -.. |image133| image:: images/admin/basicparams/addlibrarytogroup.png -.. |image134| image:: images/admin/basicparams/itemtypes.png -.. |image135| image:: images/admin/basicparams/additemtype.png -.. |image136| image:: images/admin/basicparams/itemtype-msgsetup.png -.. |image137| image:: images/admin/basicparams/itemtype-msg.png -.. |image138| image:: images/admin/basicparams/itemtype-alert.png -.. |image139| image:: images/admin/basicparams/newitemtype.png -.. |image140| image:: images/admin/basicparams/nodeleteitemtype.png -.. |image141| image:: images/admin/basicparams/bor_notes.png -.. |image142| image:: images/admin/basicparams/report_group.png -.. |image143| image:: images/admin/basicparams/report_subgroup.png -.. |image144| image:: images/admin/basicparams/addauthcat.png -.. |image145| image:: images/admin/basicparams/authvallist.png -.. |image146| image:: images/admin/basicparams/addauthvalue.png -.. |image147| image:: images/admin/basicparams/authvals.png -.. |image148| image:: images/admin/patroncirc/patroncatlist.png -.. |image149| image:: images/admin/patroncirc/newpatroncat.png -.. |image150| image:: images/admin/patroncirc/patcaterror.png -.. |image151| image:: images/admin/patroncirc/patcaterror.png -.. |image152| image:: images/admin/patroncirc/patcaterror.png -.. |image153| image:: images/admin/patroncirc/hidelostitemspatron.png -.. |image154| image:: images/admin/patroncirc/patroncatpulldown.png -.. |image155| image:: images/admin/patroncirc/patcaterror.png -.. |image156| image:: images/admin/patroncirc/selectissuinglibrary.png -.. |image157| image:: images/admin/patroncirc/addcircrule.png -.. |image158| image:: images/admin/patroncirc/editcircfine.png -.. |image159| image:: images/admin/patroncirc/clonerules.png -.. |image160| image:: images/admin/patroncirc/rulescloned.png -.. |image161| image:: images/admin/patroncirc/defaultcheckholds.png -.. |image162| image:: images/admin/patroncirc/checkoutsperpatron.png -.. |image163| image:: images/admin/patroncirc/holdsperitem.png -.. |image164| image:: images/admin/patroncirc/attributes.png -.. |image165| image:: images/admin/patroncirc/addattribute.png -.. |image166| image:: images/admin/patroncirc/showattribute.png -.. |image167| image:: images/admin/patroncirc/pa_class.png -.. |image168| image:: images/admin/patroncirc/patronattribute.png -.. |image169| image:: images/admin/patroncirc/pa_class-patron.png -.. |image170| image:: images/admin/patroncirc/deletepatronattr.png -.. |image171| image:: images/admin/patroncirc/librarytransferselect.png -.. |image172| image:: images/admin/patroncirc/collectcodes.png -.. |image173| image:: images/admin/patroncirc/limittocollcode.png -.. |image174| image:: images/admin/patroncirc/transferlimits.png -.. |image175| image:: images/admin/patroncirc/transportcostmatrix.png -.. |image176| image:: images/admin/patroncirc/librariesforalert.png -.. |image177| image:: images/admin/patroncirc/alertmatrix.png -.. |image178| image:: images/admin/patroncirc/newcity.png -.. |image179| image:: images/admin/patroncirc/cities.png -.. |image180| image:: images/admin/patroncirc/patroncity.png -.. |image181| image:: images/admin/cataloging/frameworks.png -.. |image182| image:: images/admin/cataloging/frameworkoptions.png -.. |image183| image:: images/admin/cataloging/addframework.png -.. |image184| image:: images/admin/cataloging/startnewframework.png -.. |image185| image:: images/admin/cataloging/editframework.png -.. |image186| image:: images/admin/cataloging/newtag.png -.. |image187| image:: images/admin/cataloging/newtagform.png -.. |image188| image:: images/admin/cataloging/subfieldslink.png -.. |image189| image:: images/admin/cataloging/editfield.png -.. |image190| image:: images/admin/cataloging/editsubfield.png -.. |image191| image:: images/admin/cataloging/advancedoptsubfield.png -.. |image192| image:: images/admin/cataloging/frameworkvisibility.png -.. |image193| image:: images/admin/cataloging/otheroptssubfield.png -.. |image194| image:: images/admin/cataloging/504auth.png -.. |image195| image:: images/admin/cataloging/importexport.png -.. |image196| image:: images/admin/cataloging/exportoptions.png -.. |image197| image:: images/admin/cataloging/importexport.png -.. |image198| image:: images/admin/cataloging/importfile.png -.. |image199| image:: images/admin/cataloging/importconfirm.png -.. |image200| image:: images/admin/cataloging/importtimer.png -.. |image201| image:: images/admin/cataloging/kohamarcmapping.png -.. |image202| image:: images/admin/cataloging/mapmarc.png -.. |image203| image:: images/admin/cataloging/subtitlebookmapping.png -.. |image204| image:: images/admin/cataloging/subtitledvdmapping.png -.. |image205| image:: images/admin/cataloging/subtitlebookinopac.png -.. |image206| image:: images/admin/cataloging/frameworktest.png -.. |image207| image:: images/admin/cataloging/classsources.png -.. |image208| image:: images/admin/cataloging/addclasssource.png -.. |image209| image:: images/admin/cataloging/newmatchrule.png -.. |image210| image:: images/admin/cataloging/samplematchrule.png -.. |image211| image:: images/admin/cataloging/removematchcheck.png -.. |image212| image:: images/admin/acquisitions/currencies.png -.. |image213| image:: images/admin/acquisitions/nocurrency.png -.. |image214| image:: images/admin/acquisitions/budgetslist.png -.. |image215| image:: images/admin/acquisitions/newbudgetform.png -.. |image216| image:: images/admin/acquisitions/budgetslist.png -.. |image217| image:: images/admin/acquisitions/budgetslist.png -.. |image218| image:: images/admin/acquisitions/duplicatebudget.png -.. |image219| image:: images/admin/acquisitions/duplicatestartend.png -.. |image220| image:: images/admin/acquisitions/closereport.png -.. |image221| image:: images/admin/acquisitions/newfund.png -.. |image222| image:: images/admin/acquisitions/newfundform.png -.. |image223| image:: images/admin/acquisitions/restrictfund.png -.. |image224| image:: images/admin/acquisitions/fundlist.png -.. |image225| image:: images/admin/acquisitions/fundactions.png -.. |image226| image:: images/admin/acquisitions/childfunds.png -.. |image227| image:: images/admin/acquisitions/planningpulldown.png -.. |image228| image:: images/admin/acquisitions/planningbymonths.png -.. |image229| image:: images/admin/acquisitions/addplanningcol.png -.. |image230| image:: images/admin/acquisitions/autofill.png -.. |image231| image:: images/admin/acquisitions/planningcsv.png -.. |image232| image:: images/admin/additional/z39list.png -.. |image233| image:: images/admin/additional/newz39.png -.. |image234| image:: images/admin/additional/newsru.png -.. |image235| image:: images/admin/additional/didyoumean.png -.. |image236| image:: images/admin/additional/didyoumeandrag.png -.. |image237| image:: images/admin/additional/didyoumeanopacexplode.png -.. |image238| image:: images/admin/additional/didyoumeanopacauth.png -.. |image239| image:: images/admin/additional/columns.png -.. |image240| image:: images/admin/additional/setcurrencynohide.png -.. |image241| image:: images/admin/additional/currenciesnohide.png -.. |image242| image:: images/admin/additional/setcurrencyhide.png -.. |image243| image:: images/admin/additional/currencieshide.png -.. |image244| image:: images/admin/additional/togglecolumns.png -.. |image245| image:: images/tools/patronlists/patronlists.png -.. |image246| image:: images/tools/patronlists/newpatronlist.png -.. |image247| image:: images/tools/patronlists/addtopatronlist.png -.. |image248| image:: images/tools/patronlists/addpatrontolist.png -.. |image249| image:: images/tools/patronlists/patronstoadd.png -.. |image250| image:: images/tools/patronlists/patronlist.png -.. |image251| image:: images/tools/comments/commentswaiting.png -.. |image252| image:: images/tools/comments/commentmoderation.png -.. |image253| image:: images/tools/comments/nocomments.png -.. |image254| image:: images/tools/comments/commentapproved.png -.. |image255| image:: images/tools/importpatrons/importpatrons.png -.. |image256| image:: images/tools/importpatrons/patronmatch.png -.. |image257| image:: images/tools/importpatrons/patronmatching.png -.. |image258| image:: images/tools/notices/notices.png -.. |image259| image:: images/tools/notices/newnotice.png -.. |image260| image:: images/tools/triggers.png -.. |image261| image:: images/tools/patroncards/addlayout.png -.. |image262| image:: images/tools/patroncards/units.png -.. |image263| image:: images/tools/patroncards/managelayouts.png -.. |image264| image:: images/tools/patroncards/newtemplate.png -.. |image265| image:: images/tools/patroncards/edittemplate.png -.. |image266| image:: images/tools/patroncards/units.png -.. |image267| image:: images/tools/patroncards/managetemplates.png -.. |image268| image:: images/tools/patroncards/newprofile.png -.. |image269| image:: images/tools/patroncards/addprofile.png -.. |image270| image:: images/tools/patroncards/units.png -.. |image271| image:: images/tools/patroncards/manageprofiles.png -.. |image272| image:: images/tools/patroncards/newbatch.png -.. |image273| image:: images/tools/patroncards/cards.png -.. |image274| image:: images/tools/patroncards/imageupload.png -.. |image275| image:: images/tools/patroncards/imageuploaded.png -.. |image276| image:: images/tools/patroncards/imagedelete.png -.. |image277| image:: images/tools/anonymize/patronbulkdelete.png -.. |image278| image:: images/tools/anonymize/patronanonconfirm.png -.. |image279| image:: images/tools/anonymize/patronanoncomplete.png -.. |image280| image:: images/tools/batchpatron/batchmodify.png -.. |image281| image:: images/tools/batchpatron/modifyform.png -.. |image282| image:: images/tools/batchpatron/attributes.png -.. |image283| image:: images/tools/tagging/pendingtags.png -.. |image284| image:: images/tools/tagging/tagpending.png -.. |image285| image:: images/tools/tagging/tagsummary.png -.. |image286| image:: images/tools/tagging/tagapproved.png -.. |image287| image:: images/tools/tagging/tagblacklisttest-neither.png -.. |image288| image:: images/tools/tagging/tagfilters.png -.. |image289| image:: images/tools/patronphotos/uploadphotosfile.png -.. |image290| image:: images/tools/patronphotos/uploadimagetool.png -.. |image291| image:: images/tools/patronphotos/imageuploadconfirm.png -.. |image292| image:: images/tools/rotatingcollections/rotatingcollectionnotice.png -.. |image293| image:: images/tools/batchmod/batchmod.png -.. |image294| image:: images/tools/batchmod/batchmodsummary.png -.. |image295| image:: images/tools/batchmod/batchmodform.png -.. |image296| image:: images/tools/batchmod/batchmodresults.png -.. |image297| image:: images/tools/batchmod/editinbatch.png -.. |image298| image:: images/tools/batchdelete/batchdel.png -.. |image299| image:: images/tools/batchdelete/confirmbatchdel.png -.. |image300| image:: images/tools/batchdelete/toomanytodelete.png -.. |image301| image:: images/tools/batchdelete/nobatchdel.png -.. |image302| image:: images/tools/batchdelete/batchdeldone.png -.. |image303| image:: images/tools/batchbibmod/batchbibmod.png -.. |image304| image:: images/tools/autoitemmodage/savedrule.png -.. |image305| image:: images/tools/autoitemmodage/addeditrules.png -.. |image306| image:: images/tools/autoitemmodage/ruleform.png -.. |image307| image:: images/tools/autoitemmodage/savedrule.png -.. |image308| image:: images/tools/exportmarc/marcexport-pt1.png -.. |image309| image:: images/tools/exportmarc/fileexport.png -.. |image310| image:: images/tools/exportmarc/marcexport-pt2.png -.. |image311| image:: images/tools/exportmarc/marcexport-pt3.png -.. |image312| image:: images/tools/exportmarc/authexport-pt1.png -.. |image313| image:: images/tools/exportmarc/authexport-pt2.png -.. |image314| image:: images/tools/exportmarc/authexport-pt3.png -.. |image315| image:: images/tools/inventory/generateshelflist.png -.. |image316| image:: images/tools/inventory/shelflist.png -.. |image317| image:: images/tools/inventory/importbarcodes.png -.. |image318| image:: images/tools/labelcreator/newtemplate.png -.. |image319| image:: images/tools/labelcreator/labelform.png -.. |image320| image:: images/tools/patroncards/units.png -.. |image321| image:: images/tools/labelcreator/labeltemplates.png -.. |image322| image:: images/tools/labelcreator/newprofile.png -.. |image323| image:: images/tools/labelcreator/newprofileform.png -.. |image324| image:: images/tools/patroncards/units.png -.. |image325| image:: images/tools/labelcreator/profiles.png -.. |image326| image:: images/tools/labelcreator/newlayout.png -.. |image327| image:: images/tools/labelcreator/layoutform.png -.. |image328| image:: images/tools/labelcreator/listlabelfields.png -.. |image329| image:: images/tools/labelcreator/labelfromstaged.png -.. |image330| image:: images/tools/labelcreator/newbatch.png -.. |image331| image:: images/tools/labelcreator/addbatchitems.png -.. |image332| image:: images/tools/labelcreator/searchforbatch.png -.. |image333| image:: images/tools/labelcreator/batchsearchresults.png -.. |image334| image:: images/tools/labelcreator/itemsinbarch.png -.. |image335| image:: images/tools/labelcreator/exportbatch.png -.. |image336| image:: images/tools/labelcreator/savebatch.png -.. |image337| image:: images/tools/quickspinelable.png -.. |image338| image:: images/tools/marcmodtemplates/addtemplate.png -.. |image339| image:: images/tools/marcmodtemplates/ifexample.png -.. |image340| image:: images/tools/marcmodtemplates/regexexample.png -.. |image341| image:: images/tools/marcmodtemplates/viewactions.png -.. |image342| image:: images/tools/marcmodtemplates/duplicate.png -.. |image343| image:: images/tools/marcmodtemplates/templatechoice.png -.. |image344| image:: images/tools/marcimport/stagemarc-pt1.png -.. |image345| image:: images/tools/marcimport/stagemarc-pt2.png -.. |image346| image:: images/tools/marcimport/recordtype.png -.. |image347| image:: images/tools/marcimport/encoding.png -.. |image348| image:: images/tools/marcimport/templatechoice.png -.. |image349| image:: images/tools/marcimport/matches.png -.. |image350| image:: images/tools/marcimport/matchrule.png -.. |image351| image:: images/tools/marcimport/checkitems.png -.. |image352| image:: images/tools/marcimport/stagemarc-results.png -.. |image353| image:: images/tools/marcimport/managestaged.png -.. |image354| image:: images/tools/marcimport/managestagedrecords.png -.. |image355| image:: images/tools/marcimport/importframework.png -.. |image356| image:: images/tools/marcimport/stagedrecords.png -.. |image357| image:: images/tools/marcimport/matchfound.png -.. |image358| image:: images/tools/marcimport/stagediff.png -.. |image359| image:: images/tools/marcimport/importedrecords.png -.. |image360| image:: images/tools/marcimport/reservoirresults.png -.. |image361| image:: images/tools/marcimport/managestaged.png -.. |image362| image:: images/tools/marcimport/cleanbatch.png -.. |image363| image:: images/tools/uploadlocalimg/uploadsingle.png -.. |image364| image:: images/tools/uploadlocalimg/bibnumurl.png -.. |image365| image:: images/tools/uploadlocalimg/bibnummarc.png -.. |image366| image:: images/tools/uploadlocalimg/zipfiles.png -.. |image367| image:: images/tools/uploadlocalimg/uploadsummary.png -.. |image368| image:: images/admin/globalprefs/AllowMultipleCovers.png -.. |image369| image:: images/tools/calendar/calendar.png -.. |image370| image:: images/tools/calendar/calendaradd.png -.. |image371| image:: images/tools/calendar/copyholidays.png -.. |image372| image:: images/tools/calendar/calendarsummary.png -.. |image373| image:: images/tools/calendar/calendaredit.png -.. |image374| image:: images/tools/calendar/calendarexception.png -.. |image375| image:: images/tools/calendar/calendarhelp.png -.. |image376| image:: images/tools/csvprofiles/addcsv.png -.. |image377| image:: images/tools/csvprofiles/addcsv-sql.png -.. |image378| image:: images/tools/csvprofiles/downloadcsv.png -.. |image379| image:: images/tools/csvprofiles/csvfieldsep.png -.. |image380| image:: images/tools/csvprofiles/csvadded.png -.. |image381| image:: images/tools/csvprofiles/modifycsv.png -.. |image382| image:: images/tools/csvprofiles/csvmodified.png -.. |image383| image:: images/tools/csvprofiles/deletecsv.png -.. |image384| image:: images/tools/csvprofiles/exportlist.png -.. |image385| image:: images/tools/logs/logviewer.png -.. |image386| image:: images/tools/logs/logresults.png -.. |image387| image:: images/tools/news/news.png -.. |image388| image:: images/tools/news/addnews.png -.. |image389| image:: images/tools/news/opacnews.png -.. |image390| image:: images/tools/news/librariannews.png -.. |image391| image:: images/tools/news/slipnews.png -.. |image392| image:: images/tools/tasksched/taskscheduler.png -.. |image393| image:: images/tools/tasksched/scheduledreports.png -.. |image394| image:: images/tools/tasksched/savedreports.png -.. |image395| image:: images/tools/qotd/quoteinopac.png -.. |image396| image:: images/tools/qotd/quotebuttons.png -.. |image397| image:: images/tools/qotd/addquote.png -.. |image398| image:: images/tools/qotd/editquote.png -.. |image399| image:: images/tools/qotd/quotebuttons.png -.. |image400| image:: images/tools/qotd/importquotes.png -.. |image401| image:: images/tools/qotd/importedsummary.png -.. |image402| image:: images/tools/qotd/editimported.png -.. |image403| image:: images/tools/qotd/selectfordelete.png -.. |image404| image:: images/tools/qotd/importquotebuttons.png -.. |image405| image:: images/tools/qotd/confirmdelete.png -.. |image406| image:: images/tools/qotd/importquotebuttons.png -.. |image407| image:: images/patrons/newpatron.png -.. |image408| image:: images/patrons/addpatronform.png -.. |image409| image:: images/patrons/addcontact.png -.. |image410| image:: images/patrons/addGuarantor.png -.. |image411| image:: images/patrons/addOrg.png -.. |image412| image:: images/patrons/addaltcontact.png -.. |image413| image:: images/patrons/addlibmanagement.png -.. |image414| image:: images/patrons/addlibsetup.png -.. |image415| image:: images/patrons/circnote.png -.. |image416| image:: images/patrons/addattributes.png -.. |image417| image:: images/patrons/addpatronmsg.png -.. |image418| image:: images/patrons/duplicatewarn.png -.. |image419| image:: images/patrons/patronagelimit.png -.. |image420| image:: images/patrons/statspatcat.png -.. |image421| image:: images/patrons/newinhouse.png -.. |image422| image:: images/patrons/patronedit.png -.. |image423| image:: images/patrons/duplicatedpatron.png -.. |image424| image:: images/patrons/duplicatedpatronfinal.png -.. |image425| image:: images/patrons/addpatronimage.png -.. |image426| image:: images/patrons/patronimage.png -.. |image427| image:: images/patrons/patronedit.png -.. |image428| image:: images/patrons/patronpassword.png -.. |image429| image:: images/patrons/patroneditsection.png -.. |image430| image:: images/patrons/patronaddimage.png -.. |image431| image:: images/patrons/patronflags.png -.. |image432| image:: images/patrons/patronaddress.png -.. |image433| image:: images/patrons/patroncardlost.png -.. |image434| image:: images/patrons/addpatronrestriction.png -.. |image435| image:: images/patrons/restricteduntil.png -.. |image436| image:: images/patrons/updatetoadult.png -.. |image437| image:: images/patrons/choosadulttype.png -.. |image438| image:: images/patrons/pendingpatronrequest.png -.. |image439| image:: images/patrons/managepatronupdates.png -.. |image440| image:: images/patrons/editpatronpermissions.png -.. |image441| image:: images/patrons/GranularPermissions.png -.. |image442| image:: images/patrons/myaccount.png -.. |image443| image:: images/patrons/child.png -.. |image444| image:: images/patrons/parent.png -.. |image445| image:: images/patrons/checkoutsummary.png -.. |image446| image:: images/patrons/relativecheckouts.png -.. |image447| image:: images/patrons/patronrestrictions-none.png -.. |image448| image:: images/patrons/patronrestrictions.png -.. |image449| image:: images/patrons/addrestriction.png -.. |image450| image:: images/patrons/patronaccount.png -.. |image451| image:: images/patrons/makepayment.png -.. |image452| image:: images/patrons/payfine.png -.. |image453| image:: images/patrons/paypartial.png -.. |image454| image:: images/patrons/payamount.png -.. |image455| image:: images/patrons/payselected-select.png -.. |image456| image:: images/patrons/payselected.png -.. |image457| image:: images/patrons/reverselink.png -.. |image458| image:: images/patrons/reversed.png -.. |image459| image:: images/patrons/manualinvoice.png -.. |image460| image:: images/patrons/manualcredit.png -.. |image461| image:: images/patrons/patroninvoice.png -.. |image462| image:: images/patrons/routinglisttab.png -.. |image463| image:: images/patrons/patronroutinglists.png -.. |image464| image:: images/patrons/readinghistory.png -.. |image465| image:: images/patrons/readinghistory-export.png -.. |image466| image:: images/patrons/borrowerlog.png -.. |image467| image:: images/patrons/patnoticestab.png -.. |image468| image:: images/patrons/patnoticestab-full.png -.. |image469| image:: images/patrons/resendnotice.png -.. |image470| image:: images/patrons/patronstats.png -.. |image471| image:: images/patrons/patronfilestab.png -.. |image472| image:: images/patrons/nopatronfiles.png -.. |image473| image:: images/patrons/patronfileslist.png -.. |image474| image:: images/patrons/generatedischarge.png -.. |image475| image:: images/patrons/cantdischarge.png -.. |image476| image:: images/patrons/dischargeletter.png -.. |image477| image:: images/patrons/patronsearch.png -.. |image478| image:: images/patrons/patronsearchexpand.png -.. |image479| image:: images/patrons/patronfieldsearch.png -.. |image480| image:: images/patrons/patronsearchcontains.png -.. |image481| image:: images/patrons/patronbrowse.png -.. |image482| image:: images/circ/checkoutmain.png -.. |image483| image:: images/circ/checkoutpatron.png -.. |image484| image:: images/circ/circquickbox.png -.. |image485| image:: images/circ/checkingout-noshow.png -.. |image486| image:: images/circ/checkingout.png -.. |image487| image:: images/circ/checkoutsummary.png -.. |image488| image:: images/circ/onsitecheckout.png -.. |image489| image:: images/circ/exportcheckouts.png -.. |image490| image:: images/circ/holdssummary.png -.. |image491| image:: images/circ/patronnotes.png -.. |image492| image:: images/circ/holdwaiting.png -.. |image493| image:: images/circ/circonholdings.png -.. |image494| image:: images/circ/printslip.png -.. |image495| image:: images/admin/globalprefs/DisplayClearScreenButton.png -.. |image496| image:: images/circ/batchcheckoutwarn.png -.. |image497| image:: images/circ/batchlocaluse.png -.. |image498| image:: images/circ/materialspecified.png -.. |image499| image:: images/circ/fineswarning.png -.. |image500| image:: images/circ/debarwarning.png -.. |image501| image:: images/circ/overridetemporarily.png -.. |image502| image:: images/circ/addresswarning.png -.. |image503| image:: images/circ/lostcardwarning.png -.. |image504| image:: images/circ/warnings/patrondebt.png -.. |image505| image:: images/circ/warnings/onhold.png -.. |image506| image:: images/circ/warnings/holdwaiting.png -.. |image507| image:: images/circ/warnings/alreadycheckedout.png -.. |image508| image:: images/circ/warnings/checkedoutelse.png -.. |image509| image:: images/circ/warnings/notforloan.png -.. |image510| image:: images/circ/warnings/toomanycheckouts.png -.. |image511| image:: images/circ/warnings/toomanycheckouts-no.png -.. |image512| image:: images/circ/warnings/norenewals.png -.. |image513| image:: images/circ/barcodefastadd.png -.. |image514| image:: images/circ/lostitemmsg.png -.. |image515| image:: images/circ/lostitemconfirm.png -.. |image516| image:: images/circ/warnings/agewarning.png -.. |image517| image:: images/circ/warnings/decreaseLoanHighHoldsDuration.png -.. |image518| image:: images/circ/circsummary.png -.. |image519| image:: images/circ/renewbutton.png -.. |image520| image:: images/circ/overriderenew.png -.. |image521| image:: images/circ/renewcirc.png -.. |image522| image:: images/circ/renewbarcode.png -.. |image523| image:: images/circ/renewed.png -.. |image524| image:: images/circ/renewnomatch.png -.. |image525| image:: images/circ/renewnotchecked.png -.. |image526| image:: images/circ/checkinmain.png -.. |image527| image:: images/circ/checkinquickbox.png -.. |image528| image:: images/circ/checkinlink.png -.. |image529| image:: images/circ/checkincirc.png -.. |image530| image:: images/circ/checkin.png -.. |image531| image:: images/circ/checkintransfer.png -.. |image532| image:: images/circ/transferstatus.png -.. |image533| image:: images/circ/transfercheckin.png -.. |image534| image:: images/circ/materialspecified.png -.. |image535| image:: images/circ/holdfound.png -.. |image536| image:: images/circ/waitingstatus.png -.. |image537| image:: images/circ/holdconfirmtransfer.png -.. |image538| image:: images/circ/intransithold.png -.. |image539| image:: images/admin/globalprefs/FineNotifyAtCheckin.png -.. |image540| image:: images/circ/bor_notes.png -.. |image541| image:: images/circ/staffmessages.png -.. |image542| image:: images/circ/leavecircmsg.png -.. |image543| image:: images/circ/staffmessages.png -.. |image544| image:: images/circ/opacmsg.png -.. |image545| image:: images/circ/placeholdbib.png -.. |image546| image:: images/circ/placeholdsearch.png -.. |image547| image:: images/circ/placeholdfindpatron.png -.. |image548| image:: images/circ/searchtohold.png -.. |image549| image:: images/circ/holdresults.png -.. |image550| image:: images/circ/holdmultiresults.png -.. |image551| image:: images/circ/placeholdsingle.png -.. |image552| image:: images/circ/placeholdmultiple.png -.. |image553| image:: images/circ/forgethold.png -.. |image554| image:: images/circ/holdtab.png -.. |image555| image:: images/circ/holdslist.png -.. |image556| image:: images/circ/holdpriority.png -.. |image557| image:: images/circ/lowestpriority.png -.. |image558| image:: images/circ/suspendholds.png -.. |image559| image:: images/circ/cancelholds.png -.. |image560| image:: images/circ/holdconfirmtransfer.png -.. |image561| image:: images/circ/holdconfirm.png -.. |image562| image:: images/circ/holdpatronrec.png -.. |image563| image:: images/circ/holditem.png -.. |image564| image:: images/circ/holdwaitingwarn.png -.. |image565| image:: images/circ/transfer.png -.. |image566| image:: images/circ/itemtransferred.png -.. |image567| image:: images/circ/itemintransit.png -.. |image568| image:: images/circ/itemlocations.png -.. |image569| image:: images/circ/mylibrary.png -.. |image570| image:: images/circ/setlibrary.png -.. |image571| image:: images/circ/circmenu.png -.. |image572| image:: images/circ/fastadd.png -.. |image573| image:: images/circ/barcodefastadd.png -.. |image574| image:: images/circ/fastaddbarcode.png -.. |image575| image:: images/circ/fastadditem.png -.. |image576| image:: images/circ/fastaddcheckedout.png -.. |image577| image:: images/circ/holdsqueue.png -.. |image578| image:: images/circ/holdstopull.png -.. |image579| image:: images/circ/refineholdstopull.png -.. |image580| image:: images/circ/holdspickup.png -.. |image581| image:: images/circ/holdspickupover.png -.. |image582| image:: images/circ/holdratio.png -.. |image583| image:: images/circ/transitreceive.png -.. |image584| image:: images/circ/transferlate.png -.. |image585| image:: images/circ/overdues.png -.. |image586| image:: images/circ/overduewfines.png -.. |image587| image:: images/circ/checkoutinhouse.png -.. |image588| image:: images/circ/localuserecorded.png -.. |image589| image:: images/circ/localusecheckin.png -.. |image590| image:: images/circ/LOCvalues.png -.. |image591| image:: images/circ/selfcheckoutlink.png -.. |image592| image:: images/circ/selfcheckout.png -.. |image593| image:: images/circ/SelfCheckoutByLogin.png -.. |image594| image:: images/circ/selfcheckoutuser.png -.. |image595| image:: images/circ/selfcheckoutsummary.png -.. |image596| image:: images/circ/selfreceiptprint.png -.. |image597| image:: images/circ/selfcheckoutfines.png -.. |image598| image:: images/circ/offlinecirc.png -.. |image599| image:: images/circ/syncoffline.png -.. |image600| image:: images/circ/downloadoffline.png -.. |image601| image:: images/circ/offlinecheckout.png -.. |image602| image:: images/circ/offlineduedate.png -.. |image603| image:: images/circ/offlinecheckouts.png -.. |image604| image:: images/circ/offlineupload.png -.. |image605| image:: images/circ/viewkohaoffline.png -.. |image606| image:: images/circ/offlinecirclog.png -.. |image607| image:: images/circ/offlinecircsuccess.png -.. |image608| image:: images/circ/koctstatusbar.png -.. |image609| image:: images/circ/koct.png -.. |image610| image:: images/circ/koctwarn.png -.. |image611| image:: images/circ/koctparam.png -.. |image612| image:: images/circ/koct.png -.. |image613| image:: images/circ/koctcheckin.png -.. |image614| image:: images/circ/koctcount.png -.. |image615| image:: images/circ/koctlog.png -.. |image616| image:: images/circ/offlinecirclink.png -.. |image617| image:: images/circ/offlinecirclog.png -.. |image618| image:: images/circ/offlinecircsuccess.png -.. |image619| image:: images/circ/koctdirectly.png -.. |image620| image:: images/circ/koctwarn.png -.. |image621| image:: images/circ/offlinecirclink.png -.. |image622| image:: images/circ/uploadofflinecirc.png -.. |image623| image:: images/circ/processoffline.png -.. |image624| image:: images/circ/offlinesummary.png -.. |image625| image:: images/circ/offlinecirclog.png -.. |image626| image:: images/circ/offlinecircsuccess.png -.. |image627| image:: images/cataloging/newfromframework.png -.. |image628| image:: images/cataloging/zsearch.png -.. |image629| image:: images/cataloging/zsearchresults.png -.. |image630| image:: images/cataloging/importz39.png -.. |image631| image:: images/cataloging/tryanotherzsearch.png -.. |image632| image:: images/cataloging/addmarc.png -.. |image633| image:: images/cataloging/lockedauthority.png -.. |image634| image:: images/cataloging/catauthoritysearch.png -.. |image635| image:: images/cataloging/catauthoritysearchresults.png -.. |image636| image:: images/cataloging/dupfield.png -.. |image637| image:: images/cataloging/clonesubfield.png -.. |image638| image:: images/cataloging/leaderbuilder.png -.. |image639| image:: images/cataloging/008plugin.png -.. |image640| image:: images/cataloging/savecataloging.png -.. |image641| image:: images/cataloging/duprecordwarn.png -.. |image642| image:: images/cataloging/advancedzresults.png -.. |image643| image:: images/cataloging/advancedzviewmarc.png -.. |image644| image:: images/cataloging/advancedcataloging.png -.. |image645| image:: images/cataloging/advancedkeyshort.png -.. |image646| image:: images/cataloging/analyticslink.png -.. |image647| image:: images/cataloging/analyticsbarcode.png -.. |image648| image:: images/cataloging/analyticlinksuccess.png -.. |image649| image:: images/cataloging/analytics773.png -.. |image650| image:: images/cataloging/analyticstab.png -.. |image651| image:: images/cataloging/anayticbib.png -.. |image652| image:: images/cataloging/hostrecords.png -.. |image653| image:: images/cataloging/analyticschildlink.png -.. |image654| image:: images/cataloging/analytics773child.png -.. |image655| image:: images/cataloging/analyticstab.png -.. |image656| image:: images/cataloging/anayticbib.png -.. |image657| image:: images/cataloging/hostrecords.png -.. |image658| image:: images/cataloging/analyticdelink.png -.. |image659| image:: images/cataloging/catalogsearch.png -.. |image660| image:: images/cataloging/editrecord.png -.. |image661| image:: images/cataloging/editingrecord.png -.. |image662| image:: images/cataloging/replaceviaz39.png -.. |image663| image:: images/cataloging/uploadimage.png -.. |image664| image:: images/cataloging/createduplicate.png -.. |image665| image:: images/cataloging/newduprecord.png -.. |image666| image:: images/lists/mergeprimary.png -.. |image667| image:: images/lists/mergerecs.png -.. |image668| image:: images/lists/nondupfield.png -.. |image669| image:: images/lists/mergereportvalues.png -.. |image670| image:: images/lists/mergeblankreport.png -.. |image671| image:: images/lists/mergereport.png -.. |image672| image:: images/cataloging/deleterecord.png -.. |image673| image:: images/cataloging/nodeleterecord.png -.. |image674| image:: images/cataloging/catalogsearch.png -.. |image675| image:: images/cataloging/newitem.png -.. |image676| image:: images/cataloging/additem.png -.. |image677| image:: images/cataloging/requireditemfields.png -.. |image678| image:: images/cataloging/additembuttons.png -.. |image679| image:: images/cataloging/items.png -.. |image680| image:: images/cataloging/items-withoutlabelprint.png -.. |image681| image:: images/cataloging/items-withlabelprint.png -.. |image682| image:: images/cataloging/items-activatefilters.png -.. |image683| image:: images/cataloging/edititem.png -.. |image684| image:: images/cataloging/edititemlink.png -.. |image685| image:: images/cataloging/itemstab.png -.. |image686| image:: images/cataloging/edititemlinkfromtab.png -.. |image687| image:: images/cataloging/editinbatch.png -.. |image688| image:: images/cataloging/editwithitemchecks.png -.. |image689| image:: images/cataloging/quickitemedit.png -.. |image690| image:: images/cataloging/editloststatus.png -.. |image691| image:: images/cataloging/editdamagedstatus.png -.. |image692| image:: images/cataloging/edititemlink.png -.. |image693| image:: images/cataloging/quickitemedit.png -.. |image694| image:: images/cataloging/itemorderinfo.png -.. |image695| image:: images/cataloging/attachitem.png -.. |image696| image:: images/cataloging/attachitemform.png -.. |image697| image:: images/cataloging/edititemstodelete.png -.. |image698| image:: images/cataloging/deleteitemlink.png -.. |image699| image:: images/cataloging/editwithitemchecks.png -.. |image700| image:: images/cataloging/itemstab-long.png -.. |image701| image:: images/cataloging/itemspecifichistory.png -.. |image702| image:: images/cataloging/newauthtypes.png -.. |image703| image:: images/cataloging/newauthrec.png -.. |image704| image:: images/cataloging/creatnewauthfromlink.png -.. |image705| image:: images/cataloging/authrelationships.png -.. |image706| image:: images/cataloging/authzsearch.png -.. |image707| image:: images/cataloging/authimport.png -.. |image708| image:: images/cataloging/authorityimported.png -.. |image709| image:: images/cataloging/authoritysearch.png -.. |image710| image:: images/cataloging/authorityresults.png -.. |image711| image:: images/cataloging/authrecord.png -.. |image712| image:: images/cataloging/authoritiesseealso.png -.. |image713| image:: images/cataloging/editauthority.png -.. |image714| image:: images/cataloging/dupauth.png -.. |image715| image:: images/cataloging/authmergesearch.png -.. |image716| image:: images/cataloging/authmergechoice.png -.. |image717| image:: images/cataloging/authmerging.png -.. |image718| image:: images/cataloging/authmerged.png -.. |image719| image:: images/appendix-onorder/marcbreaker.png -.. |image720| image:: images/appendix-onorder/marcbreaker-summary.png -.. |image721| image:: images/appendix-onorder/editrecords.png -.. |image722| image:: images/appendix-onorder/addfield.png -.. |image723| image:: images/appendix-onorder/add942.png -.. |image724| image:: images/appendix-onorder/add952.png -.. |image725| image:: images/appendix-onorder/compile.png -.. |image726| image:: images/coursereserves/coursesblank.png -.. |image727| image:: images/coursereserves/newcourse.png -.. |image728| image:: images/coursereserves/instructorsearch.png -.. |image729| image:: images/coursereserves/instructorremove.png -.. |image730| image:: images/coursereserves/courses.png -.. |image731| image:: images/coursereserves/courses.png -.. |image732| image:: images/coursereserves/courseadmin.png -.. |image733| image:: images/coursereserves/addbarcode.png -.. |image734| image:: images/coursereserves/coursewithreserves.png -.. |image735| image:: images/coursereserves/courselinkopac.png -.. |image736| image:: images/coursereserves/coursesopac.png -.. |image737| image:: images/coursereserves/courseopac.png -.. |image738| image:: images/serials/frequencies.png -.. |image739| image:: images/serials/newfrequency.png -.. |image740| image:: images/serials/numpatterns.png -.. |image741| image:: images/serials/newnumpattern.png -.. |image742| image:: images/serials/newsubfrombib.png -.. |image743| image:: images/serials/newsubbutton.png -.. |image744| image:: images/serials/addsub.png -.. |image745| image:: images/serials/vendorwarning.png -.. |image746| image:: images/serials/newasdup.png -.. |image747| image:: images/serials/addsub2.png -.. |image748| image:: images/serials/advancedpattern.png -.. |image749| image:: images/serials/predictionpattern.png -.. |image750| image:: images/serials/subsearch.png -.. |image751| image:: images/serials/subbuttons.png -.. |image752| image:: images/serials/serialcolllink.png -.. |image753| image:: images/serials/editissue.png -.. |image754| image:: images/serials/receiveissue.png -.. |image755| image:: images/serials/serialitem.png -.. |image756| image:: images/serials/editissue.png -.. |image757| image:: images/serials/createroutinglink.png -.. |image758| image:: images/serials/createroutinglist.png -.. |image759| image:: images/serials/addtorouting.png -.. |image760| image:: images/serials/editroutinglist.png -.. |image761| image:: images/serials/previewroutinglist.png -.. |image762| image:: images/serials/subinfoonbib.png -.. |image763| image:: images/serials/subscriptiondetail.png -.. |image764| image:: images/acquisitions/subdetails.png -.. |image765| image:: images/serials/subopac.png -.. |image766| image:: images/serials/compactopac.png -.. |image767| image:: images/serials/opacroutingsubscribe.png -.. |image768| image:: images/serials/fullopac.png -.. |image769| image:: images/serials/serialclaimmenu.png -.. |image770| image:: images/serials/serialclaimmenu1.png -.. |image771| image:: images/serials/noserialclaim.png -.. |image772| image:: images/serials/serialclaims.png -.. |image773| image:: images/serials/serialexpiresearch.png -.. |image774| image:: images/serials/serialexpire.png -.. |image775| image:: images/serials/renewsubscription.png -.. |image776| image:: images/serials/collectionrenew.png -.. |image777| image:: images/serials/serialrenew.png -.. |image778| image:: images/serials/serialsearch.png -.. |image779| image:: images/serials/advanceserialsearch.png -.. |image780| image:: images/serials/serialsearchresults.png -.. |image781| image:: images/acquisitions/acqfunds.png -.. |image782| image:: images/acquisitions/fundbreakdown.png -.. |image783| image:: images/acquisitions/newvendbutton.png -.. |image784| image:: images/acquisitions/newvendor1.png -.. |image785| image:: images/acquisitions/newvendor2.png -.. |image786| image:: images/acquisitions/newvendor3.png -.. |image787| image:: images/acquisitions/vendorsearch.png -.. |image788| image:: images/acquisitions/vendorpage.png -.. |image789| image:: images/acquisitions/receivebutton.png -.. |image790| image:: images/acquisitions/newcontract.png -.. |image791| image:: images/acquisitions/newcontractform.png -.. |image792| image:: images/acquisitions/contractdisplay.png -.. |image793| image:: images/acquisitions/contractonbasket.png -.. |image794| image:: images/acquisitions/suggestonacq.png -.. |image795| image:: images/acquisitions/pendingsuggestions.png -.. |image796| image:: images/acquisitions/suggestmanage.png -.. |image797| image:: images/acquisitions/suggestionsfilters.png -.. |image798| image:: images/acquisitions/suggestbranchfilter.png -.. |image799| image:: images/acquisitions/suggestpending.png -.. |image800| image:: images/acquisitions/suggestiondetails.png -.. |image801| image:: images/acquisitions/editsuggestion.png -.. |image802| image:: images/acquisitions/suggestreasons.png -.. |image803| image:: images/acquisitions/suggestothers.png -.. |image804| image:: images/acquisitions/mysuggestions.png -.. |image805| image:: images/acquisitions/addbasketbutton.png -.. |image806| image:: images/acquisitions/addbasket.png -.. |image807| image:: images/acquisitions/basketwithcontracts.png -.. |image808| image:: images/acquisitions/basket.png -.. |image809| image:: images/acquisitions/orderfromexisting.png -.. |image810| image:: images/acquisitions/existingitemorder.png -.. |image811| image:: images/acquisitions/orderfromsuggest.png -.. |image812| image:: images/acquisitions/orderfromsuggestform.png -.. |image813| image:: images/acquisitions/ordersuggestlink.png -.. |image814| image:: images/acquisitions/subordersearch.png -.. |image815| image:: images/acquisitions/suborderresults.png -.. |image816| image:: images/acquisitions/suborder.png -.. |image817| image:: images/acquisitions/fromnewemptyrecord.png -.. |image818| image:: images/acquisitions/orderz39.png -.. |image819| image:: images/acquisitions/orderz39results.png -.. |image820| image:: images/acquisitions/dupwarning.png -.. |image821| image:: images/acquisitions/orderz39form.png -.. |image822| image:: images/acquisitions/stagedfiles.png -.. |image823| image:: images/acquisitions/itemonorder.png -.. |image824| image:: images/acquisitions/itemonorderadded.png -.. |image825| image:: images/acquisitions/accounting.png -.. |image826| image:: images/acquisitions/fundconfirmation.png -.. |image827| image:: images/acquisitions/finalbasket.png -.. |image828| image:: images/acquisitions/showalldetails.png -.. |image829| image:: images/acquisitions/cantdeleteorderline.png -.. |image830| image:: images/acquisitions/basketbuttons.png -.. |image831| image:: images/acquisitions/BasketConfirmations.png -.. |image832| image:: images/acquisitions/basketgroup.png -.. |image833| image:: images/acquisitions/basketuncertain.png -.. |image834| image:: images/acquisitions/uncertainprices.png -.. |image835| image:: images/acquisitions/closebasket.png -.. |image836| image:: images/acquisitions/createpurchaseorder.png -.. |image837| image:: images/acquisitions/basketgroup.png -.. |image838| image:: images/acquisitions/pdforder.png -.. |image839| image:: images/acquisitions/receivebutton.png -.. |image840| image:: images/acquisitions/receivefromsearch.png -.. |image841| image:: images/acquisitions/receive.png -.. |image842| image:: images/acquisitions/receiptsummary.png -.. |image843| image:: images/acquisitions/receiveitem.png -.. |image844| image:: images/acquisitions/receiveditem.png -.. |image845| image:: images/acquisitions/received.png -.. |image846| image:: images/acquisitions/transfersearch.png -.. |image847| image:: images/acquisitions/transfervendor.png -.. |image848| image:: images/acquisitions/transferbasket.png -.. |image849| image:: images/acquisitions/transferconfirm.png -.. |image850| image:: images/acquisitions/basketwithreceived.png -.. |image851| image:: images/acquisitions/invoicesearch.png -.. |image852| image:: images/acquisitions/invoices.png -.. |image853| image:: images/acquisitions/invoice.png -.. |image854| image:: images/acquisitions/noinvoicefiles.png -.. |image855| image:: images/acquisitions/invoicefiles.png -.. |image856| image:: images/acquisitions/mergeinvoices.png -.. |image857| image:: images/acquisitions/acqclaimfilter.png -.. |image858| image:: images/acquisitions/lateorders.png -.. |image859| image:: images/acquisitions/claimletter.png -.. |image860| image:: images/acquisitions/acqsearches.png -.. |image861| image:: images/acquisitions/vendorquicksearch.png -.. |image862| image:: images/acquisitions/ordersearch.png -.. |image863| image:: images/acquisitions/ordersearchresults.png -.. |image864| image:: images/acquisitions/ordersearchexpand.png -.. |image865| image:: images/acquisitions/ordersearchfull.png -.. |image866| image:: images/acquisitions/acqfunds.png -.. |image867| image:: images/acquisitions/spent.png -.. |image868| image:: images/lists/newlistbutton.png -.. |image869| image:: images/lists/newlistform.png -.. |image870| image:: images/lists/newlistsearch.png -.. |image871| image:: images/lists/newlistfromsearch.png -.. |image872| image:: images/lists/listslist.png -.. |image873| image:: images/lists/listcontents.png -.. |image874| image:: images/lists/addtolist.png -.. |image875| image:: images/lists/listslist.png -.. |image876| image:: images/lists/listcontents.png -.. |image877| image:: images/lists/listofdups.png -.. |image878| image:: images/lists/addtocart.png -.. |image879| image:: images/lists/itemsaddedcart.png -.. |image880| image:: images/lists/cart.png -.. |image881| image:: images/reports/report1.png -.. |image882| image:: images/reports/report2.png -.. |image883| image:: images/reports/report3.png -.. |image884| image:: images/reports/report4.png -.. |image885| image:: images/reports/report5.png -.. |image886| image:: images/reports/report6.png -.. |image887| image:: images/reports/reportconfirm.png -.. |image888| image:: images/reports/reportsave.png -.. |image889| image:: images/reports/savedreports.png -.. |image890| image:: images/reports/newsql.png -.. |image891| image:: images/reports/reportfromsql.png -.. |image892| image:: images/reports/reportsubgroup.png -.. |image893| image:: images/reports/datepicker.png -.. |image894| image:: images/reports/branchpulldown.png -.. |image895| image:: images/reports/duplicatereport.png -.. |image896| image:: images/reports/savedreports.png -.. |image897| image:: images/reports/editreportoption.png -.. |image898| image:: images/reports/editreport.png -.. |image899| image:: images/reports/runreport.png -.. |image900| image:: images/reports/reportparameters.png -.. |image901| image:: images/reports/reportresults.png -.. |image902| image:: images/reports/acqform.png -.. |image903| image:: images/reports/acqnumbers.png -.. |image904| image:: images/reports/acqtotal.png -.. |image905| image:: images/reports/acqamounts.png -.. |image906| image:: images/reports/patronform.png -.. |image907| image:: images/reports/patronresults.png -.. |image908| image:: images/reports/catalogform.png -.. |image909| image:: images/reports/catalogresults.png -.. |image910| image:: images/reports/circform.png -.. |image911| image:: images/reports/circresults.png -.. |image912| image:: images/reports/inhouse.png -.. |image913| image:: images/reports/serialsform.png -.. |image914| image:: images/reports/serialsresults.png -.. |image915| image:: images/reports/holdstatsform.png -.. |image916| image:: images/reports/holdstatsresults.png -.. |image917| image:: images/reports/topcheckoutsform.png -.. |image918| image:: images/reports/topcheckoutsresult.png -.. |image919| image:: images/reports/topcircform.png -.. |image920| image:: images/reports/topcircresults.png -.. |image921| image:: images/reports/patnocheckout.png -.. |image922| image:: images/reports/patnocheckout-results.png -.. |image923| image:: images/reports/nocheckoutsform.png -.. |image924| image:: images/reports/nocheckoutsresults.png -.. |image925| image:: images/reports/itemtotals.png -.. |image926| image:: images/reports/itemtotalsresults.png -.. |image927| image:: images/reports/lostitems.png -.. |image928| image:: images/reports/averloanform.png -.. |image929| image:: images/reports/avercheckout.png -.. |image930| image:: images/reports/dict1.png -.. |image931| image:: images/reports/dict2.png -.. |image932| image:: images/reports/dict3.png -.. |image933| image:: images/reports/dict4.png -.. |image934| image:: images/reports/dictconfirm.png -.. |image935| image:: images/reports/dictlist.png -.. |image936| image:: images/reports/dictionarylimit.png -.. |image937| image:: images/opac/searchbox.png -.. |image938| image:: images/opac/totalresults-rss.png -.. |image939| image:: images/opac/sortingresults.png -.. |image940| image:: images/opac/leader.png -.. |image941| image:: images/opac/holdings-results.png -.. |image942| image:: images/opac/coverresults.png -.. |image943| image:: images/opac/didyoumeanopac.png -.. |image944| image:: images/opac/refineresults.png -.. |image945| image:: images/opac/totalresults-rss.png -.. |image946| image:: images/opac/bibdetail/bibtitle.png -.. |image947| image:: images/opac/bibdetail/bibauthor.png -.. |image948| image:: images/opac/bibdetail/authoritylink.png -.. |image949| image:: images/opac/bibdetail/bibleader.png -.. |image950| image:: images/opac/bibdetail/bibdetails.png -.. |image951| image:: images/opac/bibdetail/bibsubjects.png -.. |image952| image:: images/opac/bibdetail/bibsummary.png -.. |image953| image:: images/opac/bibdetail/biblinks.png -.. |image954| image:: images/opac/bibdetail/bibtags.png -.. |image955| image:: images/opac/bibdetail/bibholdings.png -.. |image956| image:: images/opac/bibdetail/bibtitlenotes.png -.. |image957| image:: images/opac/bibdetail/bibcomments.png -.. |image958| image:: images/opac/bibdetail/bibeditions.png -.. |image959| image:: images/opac/bibdetail/bibsearch.png -.. |image960| image:: images/opac/bibdetail/bibbrowseresults.png -.. |image961| image:: images/opac/bibdetail/biboptions.png -.. |image962| image:: images/opac/bibdetail/bibmoresearch.png -.. |image963| image:: images/opac/bibdetail/bibsave.png -.. |image964| image:: images/opac/bibdetail/bibviews.png -.. |image965| image:: images/opac/nolists.png -.. |image966| image:: images/opac/addtonewlist.png -.. |image967| image:: images/opac/publiclistpermissions.png -.. |image968| image:: images/opac/newlist.png -.. |image969| image:: images/opac/addtolistcart.png -.. |image970| image:: images/opac/chooselist.png -.. |image971| image:: images/opac/listview.png -.. |image972| image:: images/opac/emailist.png -.. |image973| image:: images/opac/mylists.png -.. |image974| image:: images/opac/editlist.png -.. |image975| image:: images/opac/deletelist.png -.. |image976| image:: images/opac/shareconfirmation.png -.. |image977| image:: images/opac/addtolistcart.png -.. |image978| image:: images/opac/addedtocart.png -.. |image979| image:: images/opac/cartcontents.png -.. |image980| image:: images/opac/emailcart.png -.. |image981| image:: images/opac/downloadcart.png -.. |image982| image:: images/opac/opacplaceholdresults.png -.. |image983| image:: images/opac/opacplaceholdsindiv.png -.. |image984| image:: images/opac/opacplaceholdsdetail.png -.. |image985| image:: images/opac/opacplacehold.png -.. |image986| image:: images/opac/holdnote.png -.. |image987| image:: images/opac/opacplaceholdspecific.png -.. |image988| image:: images/opac/tags-results.png -.. |image989| image:: images/opac/tagsadded-results.png -.. |image990| image:: images/opac/tagaddmultiple-results.png -.. |image991| image:: images/opac/commentstab.png -.. |image992| image:: images/opac/addcomment.png -.. |image993| image:: images/opac/commentpending.png -.. |image994| image:: images/opac/yourcomment.png -.. |image995| image:: images/opac/commentby.png -.. |image996| image:: images/opac/recentcomments.png -.. |image997| image:: images/opac/zoteroaddressbar.png -.. |image998| image:: images/opac/zoterotitle.png -.. |image999| image:: images/opac/PatronSelfRegistration.png -.. |image1000| image:: images/opac/patronregistration.png -.. |image1001| image:: images/opac/patronregistrationcomplete.png -.. |image1002| image:: images/opac/forgotpwlink.png -.. |image1003| image:: images/opac/myaccount.png -.. |image1004| image:: images/opac/opacsummary-wlinks.png -.. |image1005| image:: images/opac/SHOW_BCODEadd.png -.. |image1006| image:: images/opac/SHOW_BCODEattribute.png -.. |image1007| image:: images/opac/barcodeoncheckouts.png -.. |image1008| image:: images/opac/myoverdues.png -.. |image1009| image:: images/opac/myfines.png -.. |image1010| image:: images/opac/myholds.png -.. |image1011| image:: images/opac/nocard.png -.. |image1012| image:: images/opac/noaddress.png -.. |image1013| image:: images/opac/debarred.png -.. |image1014| image:: images/opac/mybilling.png -.. |image1015| image:: images/opac/paypaypal.png -.. |image1016| image:: images/opac/myprofile.png -.. |image1017| image:: images/opac/patronrequestwaiting.png -.. |image1018| image:: images/opac/myprofile-noedit.png -.. |image1019| image:: images/opac/mytags.png -.. |image1020| image:: images/opac/mypassword.png -.. |image1021| image:: images/opac/mysearchhistory.png -.. |image1022| image:: images/opac/searchistory.png -.. |image1023| image:: images/opac/myhistory.png -.. |image1024| image:: images/opac/myprivacy.png -.. |image1025| image:: images/opac/deletecirchistory.png -.. |image1026| image:: images/opac/mysuggestions.png -.. |image1027| image:: images/opac/mymessages.png -.. |image1028| image:: images/opac/OPACSMSSendDriver.png -.. |image1029| image:: images/opac/smsopac.png -.. |image1030| image:: images/opac/mylists.png -.. |image1031| image:: images/opac/dischargeopac.png -.. |image1032| image:: images/opac/dischargeopac-confirm.png -.. |image1033| image:: images/opac/suggestfromsearch.png -.. |image1034| image:: images/opac/suggestfromnoresults.png -.. |image1035| image:: images/opac/suggestfrommyaccount.png -.. |image1036| image:: images/opac/newsuggestion.png -.. |image1037| image:: images/searching/searchbox.png -.. |image1038| image:: images/searching/searchterms.png -.. |image1039| image:: images/searching/resultssummary.png -.. |image1040| image:: images/searching/resultssummary2.png -.. |image1041| image:: images/searching/noresults.png -.. |image1042| image:: images/searching/menubar.png -.. |image1043| image:: images/searching/searchoptions.png -.. |image1044| image:: images/searching/advsearch.png -.. |image1045| image:: images/searching/numresults.png -.. |image1046| image:: images/searching/feweropts.png -.. |image1047| image:: images/searching/advoptions.png -.. |image1048| image:: images/searching/advsortby.png -.. |image1049| image:: images/searching/ex1.png -.. |image1050| image:: images/searching/ex2.png -.. |image1051| image:: images/searching/ex3.png -.. |image1052| image:: images/searching/ex4.png -.. |image1053| image:: images/searching/ex5.png -.. |image1054| image:: images/searching/ex6.png -.. |image1055| image:: images/searching/ex7.png -.. |image1056| image:: images/searching/ex8.png -.. |image1057| image:: images/searching/ex9.png -.. |image1058| image:: images/searching/ex10.png -.. |image1059| image:: images/searching/ex11.png -.. |image1060| image:: images/searching/ex12.png -.. |image1061| image:: images/searching/ex13.png -.. |image1062| image:: images/searchhistory/searchhistory.png -.. |image1063| image:: images/searchhistory/bibsearch.png -.. |image1064| image:: images/searchhistory/authsearch.png -.. |image1065| image:: images/about/aboutserver.png -.. |image1066| image:: images/about/aboutperlmodules.png -.. |image1067| image:: images/about/systeminfo.jpg -.. |image1068| image:: images/appendix-opac/opaccustomregions.jpg -.. |image1069| image:: images/serialssamples/readersserial.png -.. |image1070| image:: images/serialssamples/hebrewnewspaper.png -.. |image1071| image:: images/serialssamples/backpacker.png -.. |image1072| image:: images/serialssamples/keatsplanning.png -.. |image1073| image:: images/serialssamples/cilirregular.png -.. |image1074| image:: images/serialssamples/cilpattern.png -.. |image1075| image:: images/serialssamples/cilreceived.png -.. |image1076| image:: images/appendix-cms/newpreference.png -.. |image1077| image:: images/appendix-cms/newpref-settings.png -.. |image1078| image:: images/appendix-cms/recommendedreading.png -.. |image1079| image:: images/appendix-cms/class101-pref.png -.. |image1080| image:: images/appendix-cms/editrecommendpref.png -.. |image1081| image:: images/appendix-xslt/book.png -.. |image1082| image:: images/appendix-xslt/comp.png -.. |image1083| image:: images/appendix-xslt/cr.png -.. |image1084| image:: images/appendix-xslt/map.png -.. |image1085| image:: images/appendix-xslt/mixed.png -.. |image1086| image:: images/appendix-xslt/sound.png -.. |image1087| image:: images/appendix-xslt/visual.png -.. |image1088| image:: images/appendix-xslt/kit.png -.. |image1089| image:: images/appendix-marcedit/marcedit.png -.. |image1090| image:: images/appendix-marcedit/marcedit-editsubfield.png -.. |image1091| image:: images/appendix-marcedit/editsubfield.png -.. |image1092| image:: images/appendix-marcedit/excelimport/step-1.png -.. |image1093| image:: images/appendix-marcedit/excelimport/step-2.png -.. |image1094| image:: images/appendix-marcedit/excelimport/step-3.png -.. |image1095| image:: images/appendix-marcedit/excelimport/step-4.png -.. |image1096| image:: images/appendix-marcedit/excelimport/step-5.png -.. |image1097| image:: images/appendix-marcedit/excelimport/step-6.png -.. |image1098| image:: images/appendix-marcedit/excelimport/step-7.png -.. |image1099| image:: images/appendix-marcedit/excelimport/step-8.png -.. |image1100| image:: images/appendix-marcedit/excelimport/step-9.png -.. |image1101| image:: images/appendix-marcedit/excelimport/step-10.png -.. |image1102| image:: images/appendix-marcedit/excelimport/step-11.png -.. |image1103| image:: images/appendix-marcedit/excelimport/step-12.png -.. |image1104| image:: images/appendix-marcedit/excelimport/step-13.png -.. |image1105| image:: images/appendix-marcedit/excelimport/step-14.png -.. |image1106| image:: images/appendix-marcedit/excelimport/step-15.png -.. |image1107| image:: images/appendix-marcedit/excelimport/step-17.png -.. |image1108| image:: images/appendix-marcedit/excelimport/step-18.png -.. |image1109| image:: images/appendix-marcedit/excelimport/step-19.png -.. |image1110| image:: images/appendix-marcedit/excelimport/step-20.png -.. |image1111| image:: images/appendix-oclc/oclcgatewaysetup.png -.. |image1112| image:: images/opac/SHOW_BCODEadd.png -.. |image1113| image:: images/opac/SHOW_BCODEattribute.png -.. |image1114| image:: images/opac/barcodeoncheckouts.png -.. |image1115| image:: images/cataloging/lockedauthority.png -.. |image1116| image:: images/reports/datepicker.png -.. |image1117| image:: images/reports/branchpulldown.png -.. |image1118| image:: images/appendix-extending/colorccode.png -- 1.7.2.5