7 sub _get_help_version {
8 my $help_version = C4::Context->preference("Version");
9 if ( $help_version =~ m|^(\d+)\.(\d{2}).*$| ) {
12 unless ( $major % 2 ) { $major-- };
13 $major = sprintf("%02d", $major);
14 $help_version = "$version.$major";
20 my ( $preferred_language ) = @_;
22 my @available_languages = qw( en ar cs es fr it pt_BR tz zh_TW );
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;
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;
35 return $KohaManualBaseURL . '/' . _get_help_version . '/' . $KohaManualLanguage . '/html'; # TODO html could be a KohaManualFormat with pdf, html, epub
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/additional-fields' => '/administration.html#additional-fields',
62 'admin/admin-home' => '/administration.html',
63 'admin/aqbudgetperiods' => '/administration.html#budgets',
64 'admin/aqbudgets' => '/administration.html#funds',
65 'admin/aqcontract' => '/acquisitions.html#vendor-contracts',
66 'admin/aqplan' => '/administration.html#budget-planning',
67 'admin/audio_alerts' => '/administration.html#audio-alerts',
68 'admin/auth_subfields_structure' => '/administration.html#authority-types',
69 'admin/auth_tag_structure' => '/administration.html#authority-types',
70 'admin/authorised_values' => '/administration.html#authorized-values',
71 'admin/authtypes' => '/administration.html#authority-types',
72 'admin/background_jobs' => '/administration.html#managing-jobs',
73 'admin/biblio_framework' => '/administration.html#marc-bibliographic-frameworks',
74 'admin/branch_transfer_limits' => '/administration.html#library-transfer-limits',
75 'admin/branches' => '/administration.html#libraries-&-groups',
76 'admin/categories' => '/administration.html#patron-categories',
77 'admin/checkmarc' => '/administration.html#marc-bibliographic-framework-test',
78 'admin/cities' => '/administration.html#cities-and-towns',
79 'admin/classsources' => '/administration.html#classification-sources',
80 'admin/columns_settings' => '/administration.html#table-settings',
81 'admin/curbside_pickup' => '/administration.html#curbside-pickup',
82 'admin/currency' => '/administration.html#currencies-and-exchange-rates',
83 'admin/credit_types' => '/administration.html#credit-types',
84 'admin/debit_types' => '/administration.html#debit-types',
85 'admin/didyoumean' => '/administration.html#did-you-mean',
86 'admin/edi_accounts' => '/administration.html#edi-accounts',
87 'admin/edi_ean_accounts' => '/administration.html#library-eans',
88 'admin/identity_providers' => '/administration.html#identity-providers-label',
89 'admin/item_circulation_alerts' => '/administration.html#item-circulation-alerts',
90 'admin/items_search_fields' => '/administration.html#item-search-fields',
91 'admin/itemtypes' => '/administration.html#item-types',
92 'admin/koha2marclinks' => '/administration.html#koha-to-marc-mapping',
93 'admin/library_groups' => '/administration.html#library-groups',
94 'admin/marc_subfields_structure' => '/administration.html#marc-bibliographic-frameworks',
95 'admin/marc-overlay-rules' => '/administration.html#record-overlay-rules',
96 'admin/marctagstructure' => '/administration.html#marc-bibliographic-frameworks',
97 'admin/matching-rules' => '/administration.html#record-matching-rules',
98 'admin/oai_set_mappings' => '/administration.html#oai-sets-configuration',
99 'admin/oai_sets' => '/administration.html#oai-sets-configuration',
100 'admin/patron-attr-types' => '/administration.html#patron-attribute-types',
101 'admin/preferences' => '/globalpreferences.html',
102 'admin/preferences#accounting' => '/accountspreferences.html',
103 'admin/preferences#acquisitions' => '/acquisitionspreferences.html',
104 'admin/preferences#admin' => '/administrationpreferences.html',
105 'admin/preferences#authorities' => '/authoritiespreferences.html',
106 'admin/preferences#cataloguing' => '/catalogingpreferences.html',
107 'admin/preferences#circulation' => '/circulationpreferences.html',
108 'admin/preferences#enhanced_content' => '/enhancedcontentpreferences.html',
109 'admin/preferences#i18n_l10n' => '/i18npreferences.html',
110 'admin/preferences#logs' => '/logspreferences.html',
111 'admin/preferences#opac' => '/opacpreferences.html',
112 'admin/preferences#patrons' => '/patronspreferences.html',
113 'admin/preferences#searching' => '/searchingpreferences.html',
114 'admin/preferences#serials' => '/serialspreferences.html',
115 'admin/preferences#staff_interface' => '/staffclientpreferences.html',
116 'admin/preferences#staff_interface' => '/staffclientpreferences.html',
117 'admin/preferences#tools' => '/toolspreferences.html',
118 'admin/preferences#web_services' => '/webservicespreferences.html',
119 'admin/smart-rules' => '/administration.html#circulation-and-fine-rules',
120 'admin/smtp_servers' => '/administration.html#smtp-servers',
121 'admin/restrictions' => '/administration.html#patron-restrictions',
122 'admin/share_content' => '/administration.html#share-content-with-mana-kb',
123 'admin/sms_providers' => '/administration.html#sms-cellular-providers',
124 'admin/systempreferences' => '/localusepreferences.html',
125 'admin/transport-cost-matrix' => '/administration.html#transport-cost-matrix',
126 'admin/z3950servers' => '/administration.html#z39.50/sru-servers',
127 'admin/usage_statistics' => '/administration.html#share-your-usage-statistics',
128 'authorities/authorities-home' => '/cataloging.html#authorities',
129 'authorities/authorities' => '/cataloging.html#authorities',
130 'authorities/detail' => '/cataloging.html#authorities',
131 'authorities/merge' => '/cataloging.html#merging-authorities',
132 'catalogue/detail' => '/cataloging.html#bibliographic-records',
133 'catalogue/issuehistory' => '/cataloging.html#item-specific-circulation-history',
134 'catalogue/itemsearch' => '/searching.html#item-searching',
135 'catalogue/moredetail' => '/cataloging.html#item-records',
136 'catalogue/search-history' => '/plugins.html#search-history',
137 'catalogue/search' => '/searching.html',
138 'cataloguing/cataloging-home' => '/cataloging.html',
139 'cataloguing/addbiblio' => '/cataloging.html#bibliographic-records',
140 'cataloguing/addbooks' => '/cataloging.html',
141 'cataloguing/additem' => '/cataloging.html#item-records',
142 'cataloguing/cataloging-home.pl' => '/cataloging.html',
143 'cataloguing/linkitem' => '/cataloging.html#adding-analytic-records',
144 'cataloguing/merge' => '/cataloging.html#merging-records',
145 'cataloguing/moveitem' => '/cataloging.html#moving-items',
146 'circ/article-requests' => '/circulation.html#article-requests',
147 'circ/branchoverdues' => '/circulation.html#overdues-with-fines',
148 'circ/branchtransfers' => '/circulation.html#transfers',
149 'circ/circulation-home' => '/circulation.html',
150 'circ/circulation' => '/circulation.html#check-out-(issuing)',
151 'circ/offline' => '/circulation.html#offline-circulation-in-koha',
152 'circ/on-site_checkouts' => '/circulation.html#pending-on-site-checkouts',
153 'circ/overdue' => '/circulation.html#overdues',
154 'circ/pendingreserves' => '/circulation.html#holds-to-pull',
155 'circ/renew' => '/circulation.html#renewing',
156 'circ/reserveratios' => '/circulation.html#hold-ratios',
157 'circ/returns' => '/circulation.html#check-in-returning',
158 'circ/set-library' => '/circulation.html#set-library',
159 'circ/transferstoreceive' => '/circulation.html#transfers-to-receive',
160 'circ/view_holdsqueue' => '/circulation.html#holds-queue',
161 'circ/waitingreserves' => '/circulation.html#holds-awaiting-pickup',
162 'course_reserves/add_items' => '/course_reserves.html',
163 'course_reserves/course-details' => '/course_reserves.html',
164 'course_reserves/course-reserves' => '/course_reserves.html',
165 'course_reserves/course' => '/course_reserves.html#adding-courses',
166 'erm/erm' => '/erm.html',
167 'erm/agreements' => '/erm.html#agreements',
168 'erm/agreements/' => '/erm.html#search-and-view-an-agreement-record',
169 'erm/agreements/add' => '/erm.html#create-an-agreement-record',
170 'erm/agreements/edit/' => '/erm.html#create-an-agreement-record',
171 'erm/licenses' => '/erm.html#licenses',
172 'erm/licenses/' => '/erm.html#search-and-view-a-license-record',
173 'erm/licenses/add' => '/erm.html#create-a-license-record',
174 'erm/licenses/edit' => '/erm.html#create-a-license-record',
175 'erm/eholdings/local/packages' => '/erm.html#local',
176 'erm/eholdings/local/packages/' => '/erm.html#local',
177 'erm/eholdings/local/packages/add' => '/erm.html#local',
178 'erm/eholdings/local/packages/edit/' => '/erm.html#local',
179 'erm/eholdings/local/titles' => '/erm.html#titles-1',
180 'erm/eholdings/local/titles/' => '/erm.html#titles-1',
181 'erm/eholdings/local/titles/add' => '/erm.html#titles-1',
182 'erm/eholdings/local/titles/edit/' => '/erm.html#titles-1',
183 'erm/eholdings/local/titles/import' => '/erm.html#import-a-new-local-title-record-from-a-list',
184 'erm/eholdings/local/resources/' => '/erm.html#eholdings',
185 'erm/eholdings/ebsco/packages' => '/erm.html#packages',
186 'erm/eholdings/ebsco/packages/' => '/erm.html#packages',
187 'erm/eholdings/ebsco/packages/add' => '/erm.html#packages',
188 'erm/eholdings/ebsco/packages/edit/' => '/erm.html#packages',
189 'erm/eholdings/ebsco/titles' => '/erm.html#titles',
190 'erm/eholdings/ebsco/titles/' => '/erm.html#titles',
191 'erm/eholdings/ebsco/titles/add' => '/erm.html#titles',
192 'erm/eholdings/ebsco/titles/edit/' => '/erm.html#titles',
193 'erm/eholdings/ebsco/resources/' => '/erm.html#ebsco',
194 'ill/ill-requests' => '/ILL_requests.html',
195 'labels/barcode-print' => '/cataloging.html#barcode-generator',
196 'labels/label-edit-batch' => '/cataloging.html#label-batches-label',
197 'labels/label-edit-layout' => '/cataloging.html#label-layouts-label',
198 'labels/label-edit-profile' => '/cataloging.html#label-profiles-label',
199 'labels/label-edit-range' => '/cataloging.html#barcode-range',
200 'labels/label-edit-template' => '/cataloging.html#label-templates-label',
201 'labels/label-home' => '/cataloging.html#label-creator-label',
202 'labels/label-manage' => '/cataloging.html#label-creator-label',
203 'labels/spinelabel-home' => '/cataloging.html#quick-spine-label-creator',
205 'members/apikeys' => '/webservices.html#api-key-management-interface-for-patrons',
206 'members/boraccount' => '/patrons.html#fines',
207 'members/discharge' => '/patrons.html#patron-discharges',
208 'members/files' => '/patrons.html#files',
209 'members/mancredit' => '/patrons.html#creating-manual-credits',
210 'members/maninvoice' => '/patrons.html#creating-manual-invoices',
211 'members/member-flags' => '/patrons.html#patron-permissions',
212 'members/member-password' => '/patrons.html#editing-patrons',
213 'members/member' => '/patrons.html#patron-search',
214 'members/memberentry' => '/patrons.html#add-a-new-patron',
215 'members/members-home' => '/patrons.html',
216 'members/members-update' => '/patrons.html#managing-patron-self-edits',
217 'members/moremember' => '/patrons.html#patron-information',
218 'members/notices' => '/patrons.html#notices',
219 'members/pay' => '/patrons.html#pay/reverse-fines',
220 'members/paycollect' => '/patrons.html#pay/reverse-fines',
221 'members/purchase-suggestions' => '/patrons.html#purchase-suggestions',
222 'members/readingrec' => '/patrons.html#circulation-history',
223 'members/routing-lists' => '/patrons.html#routing-lists',
224 'members/statistics' => '/patrons.html#statistics',
225 'offline_circ/list' => '/circulation.html#offline-circulation-utilities',
226 'offline_circ/process_koc' => '/circulation.html#upload-offline-circ-file',
227 'patron_lists/lists' => '/tools.html#patron-lists',
228 'patroncards/edit-batch' => '/tools.html#batches',
229 'patroncards/edit-layout' => '/tools.html#layouts',
230 'patroncards/edit-profile' => '/tools.html#profiles',
231 'patroncards/edit-template' => '/tools.html#templates',
232 'patroncards/home' => '/tools.html#patron-card-creator',
233 'patroncards/image-manage' => '/tools.html#manage-images',
234 'patroncards/manage' => '/tools.html#patron-card-creator',
235 'plugins/plugins-home' => '/plugins.html',
236 'plugins/plugins-upload' => '/plugins.html',
237 'preservation/home' => '/preservation.html',
238 'preservation/settings/processings/add' => '/preservation.html#add-a-new-processing',
239 'preservation/settings/processings/edit/' => '/preservation.html#add-a-new-processing',
240 'preservation/settings' => '/preservation.html#settings',
241 'preservation/settings/' => '/preservation.html#settings',
242 'preservation/trains' => '/preservation.html#trains',
243 'preservation/trains/' => '/preservation.html#show-train',
244 'preservation/trains/add' => '/preservation.html#new-train',
245 'preservation/trains/edit/' => '/preservation.html#trains',
246 'preservation/trains//items/add' => '/preservation.html#add-items',
247 'preservation/trains//items/edit/' => '/preservation.html#add-items',
248 'preservation/waiting-list' => '/preservation.html#waiting-list',
249 'reports/acquisitions_stats' => '/reports.html#acquisitions-statistics',
250 'reports/bor_issues_top' => '/reports.html#patrons-with-the-most-checkouts',
251 'reports/borrowers_out' => '/reports.html#patrons-with-no-checkouts',
252 'reports/borrowers_stats' => '/reports.html#patron-statistics',
253 'reports/cat_issues_top' => '/reports.html#most-circulated-items',
254 'reports/catalogue_out' => '/reports.html#items-with-no-checkouts',
255 'reports/catalogue_stats' => '/reports.html#catalog-statistics',
256 'reports/dictionary' => '/reports.html#report-dictionary',
257 'reports/guided_reports' => '/reports.html#custom-reports',
258 'reports/issues_avg_stats' => '/reports.html#average-loan-time',
259 'reports/issues_stats' => '/reports.html#circulation-statistics',
260 'reports/itemslost' => '/reports.html#lost-items',
261 'reports/manager' => '/reports.html#catalog-by-item-type',
262 'reports/reports-home' => '/reports.html',
263 'reports/reserves_stats' => '/reports.html#holds-statistics',
264 'reports/serials_stats' => '/reports.html#serials-statistics',
265 'reserve/request' => '/circulation.html#holds',
266 'reviews/reviewswaiting' => '/tools.html#comments',
267 'rotating_collections/rotatingCollections' => '/tools.html#rotating-collections',
268 'serials/checkexpiration' => '/serials.html#check-serial-expiration',
269 'serials/claims' => '/serials.html#claim-late-serials',
270 'serials/routing' => '/serials.html#create-a-routing-list',
271 'serials/serials-collection' => '/serials.html',
272 'serials/serials-edit' => '/serials.html#receive-issues',
273 'serials/serials-home' => '/serials.html',
274 'serials/subscription-add' => '/serials.html#add-a-subscription',
275 'serials/subscription-detail' => '/serials.html',
276 'serials/subscription-frequencies' => '/serials.html#manage-serial-frequencies',
277 'serials/subscription-numberpatterns' => '/serials.html#manage-serial-numbering-patterns',
278 'suggestion/suggestion' => '/acquisitions.html#managing-suggestions',
279 'tags/list' => '/tools.html#tag-moderation',
280 'tags/review' => '/tools.html#tag-moderation',
281 'tools/access_files' => '/tools.html#access-files',
282 'tools/automatic_item_modification_by_age' => '/cataloging.html#automatic-item-editing-by-age',
283 'tools/batchMod' => '/cataloging.html#batch-editing-items',
284 'tools/batch_extend_due_dates' => '/tools.html#batch-extend-due-dates',
285 'tools/batch_delete_records' => '/cataloging.html#batch-deleting-records',
286 'tools/batch_record_modification' => '/cataloging.html#batch-record-modification',
287 'tools/cleanborrowers' => '/tools.html#patrons-anonymize-bulk-delete',
288 'tools/csv-profiles' => '/tools.html#csv-profiles',
289 'tools/export' => '/cataloging.html#exporting-data',
290 'tools/holidays' => '/tools.html#calendar',
291 'tools/import_borrowers' => '/tools.html#patron-import',
292 'tools/inventory' => '/cataloging.html#inventory',
293 'tools/additional-contents' => '/tools.html#news', # FIXME Needs a change to the manual
294 'tools/letter' => '/tools.html#notices-slips',
295 'tools/manage-marc-import' => '/cataloging.html#managing-staged-records',
296 'tools/marc_modification_templates' => '/cataloging.html#marc-modification-templates',
297 'tools/modborrowers' => '/tools.html#batch-patron-modification',
298 'tools/overduerules' => '/tools.html#overdue-notice-status-triggers',
299 'tools/picture-upload' => '/tools.html#upload-patron-images',
300 'tools/quotes-upload' => '/tools.html#import-quotes',
301 'tools/quotes' => '/tools.html#quote-of-the-day-(qotd)-editor',
302 'tools/scheduler' => '/tools.html#task-scheduler',
303 'tools/stage-marc-import' => '/cataloging.html#staging-records-for-import',
304 'tools/tools-home' => '/tools.html',
305 'tools/upload-cover-image' => '/cataloging.html#adding-cover-images',
306 'tools/viewlog' => '/tools.html#log-viewer',
307 'virtualshelves/shelves' => '/lists.html#lists',
311 my ( $url, $preferred_language ) = @_;
313 if ( $url =~ /koha\/(.*)\.pl/ || $url =~ '/koha/(erm.*)' || $url =~ '/koha/(preservation.*)' ) {
318 $file =~ s/[^a-zA-Z0-9_\-\/]*//g;
320 if ( $file =~ m|^erm| || $file =~ m|^preservation| ) {
325 if ( $url =~ /(?:\?|\&)tab=(?<value>[\w+,.-]*)/ ) {
326 $view = $file . '#' . $+{value};
329 my $base_url = _get_base_url($preferred_language);
332 exists $mapping->{$view} ? $mapping->{$view}
333 : exists $mapping->{$file} ? $mapping->{$file}
334 : $mapping->{mainpage}