Main Koha release repository
https://koha-community.org
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
248 lines
18 KiB
248 lines
18 KiB
package Koha::Manual;
|
|
|
|
use Modern::Perl;
|
|
|
|
use C4::Context;
|
|
|
|
sub _get_help_version {
|
|
my $help_version = C4::Context->preference("Version");
|
|
if ( $help_version =~ m|^(\d+)\.(\d{2}).*$| ) {
|
|
my $version = $1;
|
|
my $major = $2;
|
|
unless ( $major % 2 ) { $major-- };
|
|
$major = sprintf("%02d", $major);
|
|
$help_version = "$version.$major";
|
|
}
|
|
return $help_version;
|
|
}
|
|
|
|
sub _get_base_url {
|
|
my ( $preferred_language ) = @_;
|
|
|
|
my @available_languages = qw( en ar cs es fr it pt_BR tz zh_TW );
|
|
|
|
my ( $language ) = grep {
|
|
my $preferred_short = substr $preferred_language, 0, 2;
|
|
my $avail_short = substr $_, 0, 2;
|
|
$preferred_short eq $avail_short ? $_ : ()
|
|
} @available_languages;
|
|
|
|
my $KohaManualLanguage = $language || C4::Context->preference('KohaManualLanguage') || 'en';
|
|
my $KohaManualBaseURL = C4::Context->preference('KohaManualBaseURL') || 'https://koha-community.org/manual';
|
|
if ( $KohaManualBaseURL =~ m|^/| ) {
|
|
$KohaManualBaseURL = C4::Context->preference('staffClientBaseURL') . $KohaManualBaseURL;
|
|
}
|
|
return $KohaManualBaseURL . '/' . _get_help_version . '/' . $KohaManualLanguage . '/html'; # TODO html could be a KohaManualFormat with pdf, html, epub
|
|
}
|
|
|
|
our $mapping = {
|
|
'about' => '/plugins.html#about-koha',
|
|
'acqui/acqui-home' => '/acquisitions.html',
|
|
'acqui/addorderiso2709' => '/acquisitions.html#create-a-basket',
|
|
'acqui/basket' => '/acquisitions.html#create-a-basket',
|
|
'acqui/basketgroup' => '/acquisitions.html#create-a-basket-group',
|
|
'acqui/basketheader' => '/acquisitions.html#create-a-basket',
|
|
'acqui/booksellers' => '/acquisitions.html#acquisition-searches',
|
|
'acqui/edifactmsgs' => '/acquisitions.html#edifact-messages',
|
|
'acqui/histsearch' => '/acquisitions.html#acquisition-searches',
|
|
'acqui/invoice' => '/acquisitions.html#invoices',
|
|
'acqui/invoices' => '/acquisitions.html#invoices',
|
|
'acqui/lateorders' => '/acquisitions.html#claims-late-orders',
|
|
'acqui/neworderbiblio' => '/acquisitions.html#create-a-basket',
|
|
'acqui/neworderempty' => '/acquisitions.html#create-a-basket',
|
|
'acqui/newordersubscription' => '/acquisitions.html#create-a-basket',
|
|
'acqui/newordersuggestion' => '/acquisitions.html#create-a-basket',
|
|
'acqui/orderreceive' => '/acquisitions.html#receiving-orders',
|
|
'acqui/parcel' => '/acquisitions.html#receiving-orders',
|
|
'acqui/parcels' => '/acquisitions.html#receiving-orders',
|
|
'acqui/supplier' => '/acquisitions.html#vendors',
|
|
'acqui/uncertainprice' => '/acquisitions.html#create-a-basket',
|
|
'acqui/z3950_search' => '/acquisitions.html#create-a-basket',
|
|
'admin/admin-home' => '/administration.html',
|
|
'admin/aqbudgetperiods' => '/administration.html#budgets',
|
|
'admin/aqbudgets' => '/administration.html#funds',
|
|
'admin/aqcontract' => '/acquisitions.html#vendor-contracts',
|
|
'admin/aqplan' => '/administration.html#budget-planning',
|
|
'admin/auth_subfields_structure' => '/administration.html#authority-types',
|
|
'admin/auth_tag_structure' => '/administration.html#authority-types',
|
|
'admin/authorised_values' => '/administration.html#authorized-values',
|
|
'admin/authtypes' => '/administration.html#authority-types',
|
|
'admin/biblio_framework' => '/administration.html#marc-bibliographic-frameworks',
|
|
'admin/branch_transfer_limits' => '/administration.html#library-transfer-limits',
|
|
'admin/branches' => '/administration.html#libraries-&-groups',
|
|
'admin/categories' => '/administration.html#patron-categories',
|
|
'admin/checkmarc' => '/administration.html#marc-bibliographic-framework-test',
|
|
'admin/cities' => '/administration.html#cities-and-towns',
|
|
'admin/classsources' => '/administration.html#classification-sources',
|
|
'admin/columns_settings' => '/administration.html#column-settings',
|
|
'admin/currency' => '/administration.html#currencies-and-exchange-rates',
|
|
'admin/didyoumean' => '/administration.html#did-you-mean?',
|
|
'admin/edi_accounts' => '/administration.html#edi-accounts',
|
|
'admin/edi_ean_accounts' => '/administration.html#library-eans',
|
|
'admin/item_circulation_alerts' => '/administration.html#item-circulation-alerts',
|
|
'admin/items_search_fields' => '/administration.html#item-search-fields',
|
|
'admin/itemtypes' => '/administration.html#item-types',
|
|
'admin/koha2marclinks' => '/administration.html#koha-to-marc-mapping',
|
|
'admin/marc_subfields_structure' => '/administration.html#marc-bibliographic-frameworks',
|
|
'admin/marctagstructure' => '/administration.html#marc-bibliographic-frameworks',
|
|
'admin/matching-rules' => '/administration.html#record-matching-rules',
|
|
'admin/oai_set_mappings' => '/administration.html#oai-sets-configuration',
|
|
'admin/oai_sets' => '/administration.html#oai-sets-configuration',
|
|
'admin/patron-attr-types' => '/administration.html#patron-attribute-types',
|
|
'admin/preferences' => '/systempreferences.html',
|
|
'admin/smart-rules' => '/administration.html#circulation-and-fine-rules',
|
|
'admin/sms_providers' => '/administration.html#sms-cellular-providers',
|
|
'admin/systempreferences' => '/systempreferences.html#local-use',
|
|
'admin/transport-cost-matrix' => '/administration.html#transport-cost-matrix',
|
|
'admin/z3950servers' => '/administration.html#z39.50/sru-servers',
|
|
'authorities/authorities-home' => '/cataloging.html#authorities',
|
|
'authorities/authorities' => '/cataloging.html#authorities',
|
|
'authorities/detail' => '/cataloging.html#authorities',
|
|
'authorities/merge' => '/cataloging.html#merging-authorities',
|
|
'catalogue/detail' => '/cataloging.html#bibliographic-records',
|
|
'catalogue/issuehistory' => '/cataloging.html#item-specific-circulation-history',
|
|
'catalogue/itemsearch' => '/searching.html#item-searching',
|
|
'catalogue/moredetail' => '/cataloging.html#item-records',
|
|
'catalogue/search-history' => '/plugins.html#search-history',
|
|
'catalogue/search' => '/searching.html',
|
|
'cataloguing/addbiblio' => '/cataloging.html#bibliographic-records',
|
|
'cataloguing/addbooks' => '/cataloging.html',
|
|
'cataloguing/additem' => '/cataloging.html#item-records',
|
|
'cataloguing/linkitem' => '/cataloging.html#adding-analytic-records',
|
|
'cataloguing/merge' => '/cataloging.html#merging-records',
|
|
'cataloguing/moveitem' => '/cataloging.html#moving-items',
|
|
'circ/article-requests' => '/circulation.html#article-requests',
|
|
'circ/branchoverdues' => '/circulation.html#overdues-with-fines',
|
|
'circ/branchtransfers' => '/circulation.html#transfers',
|
|
'circ/circulation-home' => '/circulation.html',
|
|
'circ/circulation' => '/circulation.html#check-out-(issuing)',
|
|
'circ/offline' => '/circulation.html#offline-circulation-in-koha',
|
|
'circ/on-site_checkouts' => '/circulation.html#pending-on-site-checkouts',
|
|
'circ/overdue' => '/circulation.html#overdues',
|
|
'circ/pendingreserves' => '/circulation.html#holds-to-pull',
|
|
'circ/renew' => '/circulation.html#renewing',
|
|
'circ/reserveratios' => '/circulation.html#hold-ratios',
|
|
'circ/returns' => '/circulation.html#check-in-returning',
|
|
'circ/set-library' => '/circulation.html#set-library',
|
|
'circ/transferstoreceive' => '/circulation.html#transfers-to-receive',
|
|
'circ/view_holdsqueue' => '/circulation.html#holds-queue',
|
|
'circ/waitingreserves' => '/circulation.html#holds-awaiting-pickup',
|
|
'course_reserves/add_items' => '/course_reserves.html',
|
|
'course_reserves/course-details' => '/course_reserves.html',
|
|
'course_reserves/course-reserves' => '/course_reserves.html',
|
|
'course_reserves/course' => '/course_reserves.html#adding-courses',
|
|
'ill/ill-requests' => '/ILL_requests.html',
|
|
'labels/label-edit-batch' => '/tools.html#label-batches-label',
|
|
'labels/label-edit-layout' => '/tools.html#label-layouts-label',
|
|
'labels/label-edit-profile' => '/tools.html#label-profiles-label',
|
|
'labels/label-edit-range' => '/tools.html#label-creator-label', #FIXME Add when documented
|
|
'labels/label-edit-template' => '/tools.html#label-templates-label',
|
|
'labels/label-home' => '/tools.html#label-creator-label',
|
|
'labels/label-manage' => '/tools.html#label-creator-label',
|
|
'labels/spinelabel-home' => '/tools.html#quick-spine-label-creator',
|
|
'mainpage' => '/',
|
|
'members/apikeys' => '/webservices.html#api-key-management-interface-for-patrons',
|
|
'members/boraccount' => '/patrons.html#fines',
|
|
'members/discharge' => '/patrons.html#patron-discharges',
|
|
'members/files' => '/patrons.html#files',
|
|
'members/mancredit' => '/patrons.html#creating-manual-credits',
|
|
'members/maninvoice' => '/patrons.html#creating-manual-invoices',
|
|
'members/member-flags' => '/patrons.html#patron-permissions',
|
|
'members/member-password' => '/patrons.html#editing-patrons',
|
|
'members/member' => '/patrons.html#patron-search',
|
|
'members/memberentry' => '/patrons.html#add-a-new-patron',
|
|
'members/members-home' => '/patrons.html',
|
|
'members/members-update' => '/patrons.html#managing-patron-self-edits',
|
|
'members/moremember' => '/patrons.html#patron-information',
|
|
'members/notices' => '/patrons.html#notices',
|
|
'members/pay' => '/patrons.html#pay/reverse-fines',
|
|
'members/paycollect' => '/patrons.html#pay/reverse-fines',
|
|
'members/purchase-suggestions' => '/patrons.html#purchase-suggestions',
|
|
'members/readingrec' => '/patrons.html#circulation-history',
|
|
'members/routing-lists' => '/patrons.html#routing-lists',
|
|
'members/statistics' => '/patrons.html#statistics',
|
|
'offline_circ/list' => '/circulation.html#offline-circulation-utilities',
|
|
'offline_circ/process_koc' => '/circulation.html#upload-offline-circ-file',
|
|
'patron_lists/lists' => '/tools.html#patron-lists',
|
|
'patroncards/edit-batch' => '/tools.html#batches',
|
|
'patroncards/edit-layout' => '/tools.html#layouts',
|
|
'patroncards/edit-profile' => '/tools.html#profiles',
|
|
'patroncards/edit-template' => '/tools.html#templates',
|
|
'patroncards/home' => '/tools.html#patron-card-creator',
|
|
'patroncards/image-manage' => '/tools.html#manage-images',
|
|
'patroncards/manage' => '/tools.html#patron-card-creator',
|
|
'plugins/plugins-home' => '/plugins.html',
|
|
'plugins/plugins-upload' => '/plugins.html',
|
|
'reports/acquisitions_stats' => '/reports.html#acquisitions-statistics',
|
|
'reports/bor_issues_top' => '/reports.html#patrons-with-the-most-checkouts',
|
|
'reports/borrowers_out' => '/reports.html#patrons-with-no-checkouts',
|
|
'reports/borrowers_stats' => '/reports.html#patron-statistics',
|
|
'reports/cat_issues_top' => '/reports.html#most-circulated-items',
|
|
'reports/catalogue_out' => '/reports.html#items-with-no-checkouts',
|
|
'reports/catalogue_stats' => '/reports.html#catalog-statistics',
|
|
'reports/dictionary' => '/reports.html#report-dictionary',
|
|
'reports/guided_reports' => '/reports.html#custom-reports',
|
|
'reports/issues_avg_stats' => '/reports.html#average-loan-time',
|
|
'reports/issues_stats' => '/reports.html#circulation-statistics',
|
|
'reports/itemslost' => '/reports.html#lost-items',
|
|
'reports/manager' => '/reports.html#catalog-by-item-type',
|
|
'reports/reports-home' => '/reports.html',
|
|
'reports/reserves_stats' => '/reports.html#holds-statistics',
|
|
'reports/serials_stats' => '/reports.html#serials-statistics',
|
|
'reserve/request' => '/circulation.html#holds',
|
|
'reviews/reviewswaiting' => '/tools.html#comments',
|
|
'rotating_collections/rotatingCollections' => '/tools.html#rotating-collections',
|
|
'serials/checkexpiration' => '/serials.html#check-serial-expiration',
|
|
'serials/claims' => '/serials.html#claim-late-serials',
|
|
'serials/routing' => '/serials.html#create-a-routing-list',
|
|
'serials/serials-collection' => '/serials.html',
|
|
'serials/serials-edit' => '/serials.html#receive-issues',
|
|
'serials/serials-home' => '/serials.html',
|
|
'serials/subscription-add' => '/serials.html#add-a-subscription',
|
|
'serials/subscription-detail' => '/serials.html',
|
|
'serials/subscription-frequencies' => '/serials.html#manage-serial-frequencies',
|
|
'serials/subscription-numberpatterns' => '/serials.html#manage-serial-numbering-patterns',
|
|
'suggestion/suggestion' => '/acquisitions.html#managing-suggestions',
|
|
'tags/list' => '/tools.html#tag-moderation',
|
|
'tags/review' => '/tools.html#tag-moderation',
|
|
'tools/batchMod' => '/tools.html#batch-item-deletion',
|
|
'tools/batch_delete_records' => '/tools.html#batch-record-deletion',
|
|
'tools/batch_record_modification' => '/tools.html#batch-record-modification',
|
|
'tools/cleanborrowers' => '/tools.html#patrons-anonymize-bulk-delete',
|
|
'tools/csv-profiles' => '/tools.html#csv-profiles',
|
|
'tools/export' => '/tools.html#export-bibliographic-records',
|
|
'tools/holidays' => '/tools.html#calendar',
|
|
'tools/import_borrowers' => '/tools.html#patron-import',
|
|
'tools/inventory' => '/tools.html#inventory-stocktaking',
|
|
'tools/koha-news' => '/tools.html#news',
|
|
'tools/letter' => '/tools.html#notices-slips',
|
|
'tools/manage-marc-import' => '/tools.html#staged-marc-record-management',
|
|
'tools/marc_modification_templates' => '/tools.html#marc-modification-templates',
|
|
'tools/modborrowers' => '/tools.html#batch-patron-modification',
|
|
'tools/overduerules' => '/tools.html#overdue-notice-status-triggers',
|
|
'tools/picture-upload' => '/tools.html#upload-patron-images',
|
|
'tools/quotes-upload' => '/tools.html#import-quotes',
|
|
'tools/quotes' => '/tools.html#quote-of-the-day-(qotd)-editor',
|
|
'tools/scheduler' => '/tools.html#task-scheduler',
|
|
'tools/stage-marc-import' => '/tools.html#stage-marc-records-for-import',
|
|
'tools/tools-home' => '/tools.html',
|
|
'tools/upload-cover-image' => '/tools.html#upload-local-cover-image',
|
|
'tools/viewlog' => '/tools.html#log-viewer',
|
|
'virtualshelves/shelves' => '/lists.html#lists',
|
|
};
|
|
|
|
sub get_url {
|
|
my ( $url, $preferred_language ) = @_;
|
|
my $file;
|
|
if ($url =~ /koha\/(.*)\.pl/) {
|
|
$file = $1;
|
|
} else {
|
|
$file = 'mainpage';
|
|
}
|
|
$file =~ s/[^a-zA-Z0-9_\-\/]*//g;
|
|
|
|
my $base_url = _get_base_url( $preferred_language );
|
|
return $base_url . ( exists $mapping->{$file} ? $mapping->{$file} : $mapping->{mainpage} );
|
|
}
|
|
|
|
1;
|
|
|