Koha/Manual.pm

   1 package Koha::Manual;
   2
   3 use Modern::Perl;
   4
   5 use C4::Context;
   6
   7 sub _get_help_version {
   8     my $help_version = C4::Context->preference("Version");
   9     if ( $help_version =~ m|^(\d+)\.(\d{2}).*$| ) {
  10         my $version = $1;
  11         my $major = $2;
  12         unless ( $major % 2 ) { $major-- };
  13         $major = sprintf("%02d", $major);
  14         $help_version = "$version.$major";
  15     }
  16     return $help_version;
  17 }
  18
  19 sub _get_base_url {
  20     my ( $preferred_language ) = @_;
  21
  22     my @available_languages = qw( en ar cs es fr it pt_BR tz zh_TW );
  23
  24     my ( $language ) = grep {
  25         my $preferred_short = substr $preferred_language, 0, 2;
  26         my $avail_short = substr $_, 0, 2;
  27         $preferred_short eq $avail_short ? $_ : ()
  28     } @available_languages;
  29
  30     my $KohaManualLanguage = $language || C4::Context->preference('KohaManualLanguage') || 'en';
  31     my $KohaManualBaseURL = C4::Context->preference('KohaManualBaseURL') || 'https://koha-community.org/manual';
  32     if ( $KohaManualBaseURL =~ m|^/| ) {
  33         $KohaManualBaseURL = C4::Context->preference('staffClientBaseURL') . $KohaManualBaseURL;
  34     }
  35     return $KohaManualBaseURL . '/' . _get_help_version . '/' . $KohaManualLanguage . '/html'; # TODO html could be a KohaManualFormat with pdf, html, epub
  36 }
  37
  38 our $mapping = {
  39     'about'                                    => '/plugins.html#about-koha',
  40     'acqui/acqui-home'                         => '/acquisitions.html',
  41     'acqui/addorderiso2709'                    => '/acquisitions.html#create-a-basket',
  42     'acqui/basket'                             => '/acquisitions.html#create-a-basket',
  43     'acqui/basketgroup'                        => '/acquisitions.html#create-a-basket-group',
  44     'acqui/basketheader'                       => '/acquisitions.html#create-a-basket',
  45     'acqui/booksellers'                        => '/acquisitions.html#acquisition-searches',
  46     'acqui/edifactmsgs'                        => '/acquisitions.html#edifact-messages',
  47     'acqui/histsearch'                         => '/acquisitions.html#acquisition-searches',
  48     'acqui/invoice'                            => '/acquisitions.html#invoices',
  49     'acqui/invoices'                           => '/acquisitions.html#invoices',
  50     'acqui/lateorders'                         => '/acquisitions.html#claims-late-orders',
  51     'acqui/neworderbiblio'                     => '/acquisitions.html#create-a-basket',
  52     'acqui/neworderempty'                      => '/acquisitions.html#create-a-basket',
  53     'acqui/newordersubscription'               => '/acquisitions.html#create-a-basket',
  54     'acqui/newordersuggestion'                 => '/acquisitions.html#create-a-basket',
  55     'acqui/orderreceive'                       => '/acquisitions.html#receiving-orders',
  56     'acqui/parcel'                             => '/acquisitions.html#receiving-orders',
  57     'acqui/parcels'                            => '/acquisitions.html#receiving-orders',
  58     'acqui/supplier'                           => '/acquisitions.html#vendors',
  59     'acqui/uncertainprice'                     => '/acquisitions.html#create-a-basket',
  60     'acqui/z3950_search'                       => '/acquisitions.html#create-a-basket',
  61     'admin/admin-home'                         => '/administration.html',
  62     'admin/aqbudgetperiods'                    => '/administration.html#budgets',
  63     'admin/aqbudgets'                          => '/administration.html#funds',
  64     'admin/aqcontract'                         => '/acquisitions.html#vendor-contracts',
  65     'admin/aqplan'                             => '/administration.html#budget-planning',
  66     'admin/auth_subfields_structure'           => '/administration.html#authority-types',
  67     'admin/auth_tag_structure'                 => '/administration.html#authority-types',
  68     'admin/authorised_values'                  => '/administration.html#authorized-values',
  69     'admin/authtypes'                          => '/administration.html#authority-types',
  70     'admin/biblio_framework'                   => '/administration.html#marc-bibliographic-frameworks',
  71     'admin/branch_transfer_limits'             => '/administration.html#library-transfer-limits',
  72     'admin/branches'                           => '/administration.html#libraries-&-groups',
  73     'admin/categories'                         => '/administration.html#patron-categories',
  74     'admin/checkmarc'                          => '/administration.html#marc-bibliographic-framework-test',
  75     'admin/cities'                             => '/administration.html#cities-and-towns',
  76     'admin/classsources'                       => '/administration.html#classification-sources',
  77     'admin/columns_settings'                   => '/administration.html#column-settings',
  78     'admin/currency'                           => '/administration.html#currencies-and-exchange-rates',
  79     'admin/didyoumean'                         => '/administration.html#did-you-mean?',
  80     'admin/edi_accounts'                       => '/administration.html#edi-accounts',
  81     'admin/edi_ean_accounts'                   => '/administration.html#library-eans',
  82     'admin/item_circulation_alerts'            => '/administration.html#item-circulation-alerts',
  83     'admin/items_search_fields'                => '/administration.html#item-search-fields',
  84     'admin/itemtypes'                          => '/administration.html#item-types',
  85     'admin/koha2marclinks'                     => '/administration.html#koha-to-marc-mapping',
  86     'admin/marc_subfields_structure'           => '/administration.html#marc-bibliographic-frameworks',
  87     'admin/marctagstructure'                   => '/administration.html#marc-bibliographic-frameworks',
  88     'admin/matching-rules'                     => '/administration.html#record-matching-rules',
  89     'admin/oai_set_mappings'                   => '/administration.html#oai-sets-configuration',
  90     'admin/oai_sets'                           => '/administration.html#oai-sets-configuration',
  91     'admin/patron-attr-types'                  => '/administration.html#patron-attribute-types',
  92     'admin/preferences'                        => '/globalpreferences.html',
  93     'admin/preferences#accounting'             => '/accountspreferences.html',
  94     'admin/preferences#acquisitions'           => '/acquisitionspreferences.html',
  95     'admin/preferences#admin'                  => '/administrationpreferences.html',
  96     'admin/preferences#authorities'            => '/authoritiespreferences.html',
  97     'admin/preferences#cataloguing'            => '/catalogingpreferences.html',
  98     'admin/preferences#circulation'            => '/circulationpreferences.html',
  99     'admin/preferences#enhanced_content'       => '/enhancedcontentpreferences.html',
 100     'admin/preferences#i18n_l10n'              => '/i18npreferences.html',
 101     'admin/preferences#logs'                   => '/logspreferences.html',
 102     'admin/preferences#opac'                   => '/opacpreferences.html',
 103     'admin/preferences#patrons'                => '/patronspreferences.html',
 104     'admin/preferences#searching'              => '/searchingpreferences.html',
 105     'admin/preferences#serials'                => '/serialspreferences.html',
 106     'admin/preferences#staff_interface'        => '/staffclientpreferences.html',
 107     'admin/preferences#staff_interface'        => '/staffclientpreferences.html',
 108     'admin/preferences#tools'                  => '/toolspreferences.html',
 109     'admin/preferences#web_services'           => '/webservicespreferences.html',
 110     'admin/smart-rules'                        => '/administration.html#circulation-and-fine-rules',
 111     'admin/sms_providers'                      => '/administration.html#sms-cellular-providers',
 112     'admin/systempreferences'                  => '/localusepreferences.html',
 113     'admin/transport-cost-matrix'              => '/administration.html#transport-cost-matrix',
 114     'admin/z3950servers'                       => '/administration.html#z39.50/sru-servers',
 115     'authorities/authorities-home'             => '/cataloging.html#authorities',
 116     'authorities/authorities'                  => '/cataloging.html#authorities',
 117     'authorities/detail'                       => '/cataloging.html#authorities',
 118     'authorities/merge'                        => '/cataloging.html#merging-authorities',
 119     'catalogue/detail'                         => '/cataloging.html#bibliographic-records',
 120     'catalogue/issuehistory'                   => '/cataloging.html#item-specific-circulation-history',
 121     'catalogue/itemsearch'                     => '/searching.html#item-searching',
 122     'catalogue/moredetail'                     => '/cataloging.html#item-records',
 123     'catalogue/search-history'                 => '/plugins.html#search-history',
 124     'catalogue/search'                         => '/searching.html',
 125     'cataloguing/cataloging-home'              => '/cataloging.html',
 126     'cataloguing/addbiblio'                    => '/cataloging.html#bibliographic-records',
 127     'cataloguing/addbooks'                     => '/cataloging.html',
 128     'cataloguing/additem'                      => '/cataloging.html#item-records',
 129     'cataloguing/cataloging-home.pl'           => '/cataloging.html',
 130     'cataloguing/linkitem'                     => '/cataloging.html#adding-analytic-records',
 131     'cataloguing/merge'                        => '/cataloging.html#merging-records',
 132     'cataloguing/moveitem'                     => '/cataloging.html#moving-items',
 133     'circ/article-requests'                    => '/circulation.html#article-requests',
 134     'circ/branchoverdues'                      => '/circulation.html#overdues-with-fines',
 135     'circ/branchtransfers'                     => '/circulation.html#transfers',
 136     'circ/circulation-home'                    => '/circulation.html',
 137     'circ/circulation'                         => '/circulation.html#check-out-(issuing)',
 138     'circ/offline'                             => '/circulation.html#offline-circulation-in-koha',
 139     'circ/on-site_checkouts'                   => '/circulation.html#pending-on-site-checkouts',
 140     'circ/overdue'                             => '/circulation.html#overdues',
 141     'circ/pendingreserves'                     => '/circulation.html#holds-to-pull',
 142     'circ/renew'                               => '/circulation.html#renewing',
 143     'circ/reserveratios'                       => '/circulation.html#hold-ratios',
 144     'circ/returns'                             => '/circulation.html#check-in-returning',
 145     'circ/set-library'                         => '/circulation.html#set-library',
 146     'circ/transferstoreceive'                  => '/circulation.html#transfers-to-receive',
 147     'circ/view_holdsqueue'                     => '/circulation.html#holds-queue',
 148     'circ/waitingreserves'                     => '/circulation.html#holds-awaiting-pickup',
 149     'course_reserves/add_items'                => '/course_reserves.html',
 150     'course_reserves/course-details'           => '/course_reserves.html',
 151     'course_reserves/course-reserves'          => '/course_reserves.html',
 152     'course_reserves/course'                   => '/course_reserves.html#adding-courses',
 153     'ill/ill-requests'                         => '/ILL_requests.html',
 154     'labels/label-edit-batch'                  => '/tools.html#label-batches-label',
 155     'labels/label-edit-layout'                 => '/tools.html#label-layouts-label',
 156     'labels/label-edit-profile'                => '/tools.html#label-profiles-label',
 157     'labels/label-edit-range'                  => '/tools.html#label-creator-label', #FIXME Add when documented
 158     'labels/label-edit-template'               => '/tools.html#label-templates-label',
 159     'labels/label-home'                        => '/tools.html#label-creator-label',
 160     'labels/label-manage'                      => '/tools.html#label-creator-label',
 161     'labels/spinelabel-home'                   => '/tools.html#quick-spine-label-creator',
 162     'mainpage'                                 => '/',
 163     'members/apikeys'                          => '/webservices.html#api-key-management-interface-for-patrons',
 164     'members/boraccount'                       => '/patrons.html#fines',
 165     'members/discharge'                        => '/patrons.html#patron-discharges',
 166     'members/files'                            => '/patrons.html#files',
 167     'members/mancredit'                        => '/patrons.html#creating-manual-credits',
 168     'members/maninvoice'                       => '/patrons.html#creating-manual-invoices',
 169     'members/member-flags'                     => '/patrons.html#patron-permissions',
 170     'members/member-password'                  => '/patrons.html#editing-patrons',
 171     'members/member'                           => '/patrons.html#patron-search',
 172     'members/memberentry'                      => '/patrons.html#add-a-new-patron',
 173     'members/members-home'                     => '/patrons.html',
 174     'members/members-update'                   => '/patrons.html#managing-patron-self-edits',
 175     'members/moremember'                       => '/patrons.html#patron-information',
 176     'members/notices'                          => '/patrons.html#notices',
 177     'members/pay'                              => '/patrons.html#pay/reverse-fines',
 178     'members/paycollect'                       => '/patrons.html#pay/reverse-fines',
 179     'members/purchase-suggestions'             => '/patrons.html#purchase-suggestions',
 180     'members/readingrec'                       => '/patrons.html#circulation-history',
 181     'members/routing-lists'                    => '/patrons.html#routing-lists',
 182     'members/statistics'                       => '/patrons.html#statistics',
 183     'offline_circ/list'                        => '/circulation.html#offline-circulation-utilities',
 184     'offline_circ/process_koc'                 => '/circulation.html#upload-offline-circ-file',
 185     'patron_lists/lists'                       => '/tools.html#patron-lists',
 186     'patroncards/edit-batch'                   => '/tools.html#batches',
 187     'patroncards/edit-layout'                  => '/tools.html#layouts',
 188     'patroncards/edit-profile'                 => '/tools.html#profiles',
 189     'patroncards/edit-template'                => '/tools.html#templates',
 190     'patroncards/home'                         => '/tools.html#patron-card-creator',
 191     'patroncards/image-manage'                 => '/tools.html#manage-images',
 192     'patroncards/manage'                       => '/tools.html#patron-card-creator',
 193     'plugins/plugins-home'                     => '/plugins.html',
 194     'plugins/plugins-upload'                   => '/plugins.html',
 195     'reports/acquisitions_stats'               => '/reports.html#acquisitions-statistics',
 196     'reports/bor_issues_top'                   => '/reports.html#patrons-with-the-most-checkouts',
 197     'reports/borrowers_out'                    => '/reports.html#patrons-with-no-checkouts',
 198     'reports/borrowers_stats'                  => '/reports.html#patron-statistics',
 199     'reports/cat_issues_top'                   => '/reports.html#most-circulated-items',
 200     'reports/catalogue_out'                    => '/reports.html#items-with-no-checkouts',
 201     'reports/catalogue_stats'                  => '/reports.html#catalog-statistics',
 202     'reports/dictionary'                       => '/reports.html#report-dictionary',
 203     'reports/guided_reports'                   => '/reports.html#custom-reports',
 204     'reports/issues_avg_stats'                 => '/reports.html#average-loan-time',
 205     'reports/issues_stats'                     => '/reports.html#circulation-statistics',
 206     'reports/itemslost'                        => '/reports.html#lost-items',
 207     'reports/manager'                          => '/reports.html#catalog-by-item-type',
 208     'reports/reports-home'                     => '/reports.html',
 209     'reports/reserves_stats'                   => '/reports.html#holds-statistics',
 210     'reports/serials_stats'                    => '/reports.html#serials-statistics',
 211     'reserve/request'                          => '/circulation.html#holds',
 212     'reviews/reviewswaiting'                   => '/tools.html#comments',
 213     'rotating_collections/rotatingCollections' => '/tools.html#rotating-collections',
 214     'serials/checkexpiration'                  => '/serials.html#check-serial-expiration',
 215     'serials/claims'                           => '/serials.html#claim-late-serials',
 216     'serials/routing'                          => '/serials.html#create-a-routing-list',
 217     'serials/serials-collection'               => '/serials.html',
 218     'serials/serials-edit'                     => '/serials.html#receive-issues',
 219     'serials/serials-home'                     => '/serials.html',
 220     'serials/subscription-add'                 => '/serials.html#add-a-subscription',
 221     'serials/subscription-detail'              => '/serials.html',
 222     'serials/subscription-frequencies'         => '/serials.html#manage-serial-frequencies',
 223     'serials/subscription-numberpatterns'      => '/serials.html#manage-serial-numbering-patterns',
 224     'suggestion/suggestion'                    => '/acquisitions.html#managing-suggestions',
 225     'tags/list'                                => '/tools.html#tag-moderation',
 226     'tags/review'                              => '/tools.html#tag-moderation',
 227     'tools/automatic_item_modification_by_age' => '/tools.html#automatic-item-modifications-by-age',
 228     'tools/batchMod'                           => '/tools.html#batch-item-deletion',
 229     'tools/batch_delete_records'               => '/tools.html#batch-record-deletion',
 230     'tools/batch_record_modification'          => '/tools.html#batch-record-modification',
 231     'tools/cleanborrowers'                     => '/tools.html#patrons-anonymize-bulk-delete',
 232     'tools/csv-profiles'                       => '/tools.html#csv-profiles',
 233     'tools/export'                             => '/tools.html#export-bibliographic-records',
 234     'tools/holidays'                           => '/tools.html#calendar',
 235     'tools/import_borrowers'                   => '/tools.html#patron-import',
 236     'tools/inventory'                          => '/tools.html#inventory-stocktaking',
 237     'tools/additional-contents'                => '/tools.html#news', # FIXME Needs a change to the manual
 238     'tools/letter'                             => '/tools.html#notices-slips',
 239     'tools/manage-marc-import'                 => '/tools.html#staged-marc-record-management',
 240     'tools/marc_modification_templates'        => '/tools.html#marc-modification-templates',
 241     'tools/modborrowers'                       => '/tools.html#batch-patron-modification',
 242     'tools/overduerules'                       => '/tools.html#overdue-notice-status-triggers',
 243     'tools/picture-upload'                     => '/tools.html#upload-patron-images',
 244     'tools/quotes-upload'                      => '/tools.html#import-quotes',
 245     'tools/quotes'                             => '/tools.html#quote-of-the-day-(qotd)-editor',
 246     'tools/scheduler'                          => '/tools.html#task-scheduler',
 247     'tools/stage-marc-import'                  => '/tools.html#stage-marc-records-for-import',
 248     'tools/tools-home'                         => '/tools.html',
 249     'tools/upload-cover-image'                 => '/tools.html#upload-local-cover-image',
 250     'tools/viewlog'                            => '/tools.html#log-viewer',
 251     'virtualshelves/shelves'                   => '/lists.html#lists',
 252 };
 253
 254 sub get_url {
 255     my ( $url, $preferred_language ) = @_;
 256     my $file;
 257     if ($url =~ /koha\/(.*)\.pl/) {
 258         $file = $1;
 259     } else {
 260         $file = 'mainpage';
 261     }
 262     $file =~ s/[^a-zA-Z0-9_\-\/]*//g;
 263
 264     my $view;
 265     if ($url =~ /(?:\?|\&)tab=(?<value>[\w+,.-]*)/) {
 266         $view = $file . '#' . $+{value};
 267     }
 268
 269     my $base_url = _get_base_url( $preferred_language );
 270     return $base_url
 271       . (
 272           exists $mapping->{$view} ? $mapping->{$view}
 273         : exists $mapping->{$file} ? $mapping->{$file}
 274         :                            $mapping->{mainpage}
 275       );
 276 }
 277
 278 1;