some documentation (19.11 and 20.05) pages are slightly outdated
Hello I have been using Koha documentation to extend Koha 19.11 as a CMS and followed instructions given on the following page: https://koha-community.org/manual/19.11/en/html/extending_koha.html#using-ko... *Under the section "Editing the pages template" it is written as follows:* - 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 ) %]<div id="opacmainuserblock">[% OpacMainUserBlock %]</div>[% END %] - To this: [% IF ( page_test ) %]<div id="opacmainuserblock">[% page_test %]</div>[% END %] *But in the pages.tt <http://pages.tt> file (copied from opac-main.tt <http://opac-main.tt>) and where modifications are to be carried out, the line shows not at approximately line 61 but at line 152 and is written as:* [% IF ( OpacMainUserBlock ) %]<div id="opacmainuserblock">[% OpacMainUserBlock | $raw %]</div>[% END %] It is of course a very minor difference but for the sake of exactitude, it would be nice to have these differences corrected (line number and code) *There is however a bigger issue with the following content:* 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 ) %] <div id="news"> <table class="table table-bordered"> [% FOREACH koha_new IN koha_news %] <thead><tr><th>[% koha_new.title %]</th></tr></thead> <tbody><tr><td><p>[% koha_new.new %]</p> <p class="newsfooter"><i>(published on [% koha_new.newdate %])</i></p></td></tr></tbody> [% END %] </table> </div> [% END %] *Because the code to be researched as above has been completely modified and spans from line 72 to 102 (30 lines of code) and even further.* The same remarks stand also for 20.05 documentation ( https://koha-community.org/manual/20.05/en/html/extending_koha.html#using-ko... ) To whom shall we report this, else than in this mailing list? Kind regards Quynh ================= M. Vũ Đỗ Quỳnh (Ph.D) Trường Đại học Thăng Long - Université de Thang Long - Thang Long University (Hanoi, Vietnam) Phó Hiệu Trưởng, phụ trách HTQT - Vice-recteur chargé de la coopération internationale - Vice-Rector in charge of International Cooperation Web: http://thanglong.edu.vn/
Hello Quynh, Can you report it as a bug on bugs.koha-community.org? Make sure to choose the "Documentation" component when filing the bug. The documentation team will check it out. Thank you for spotting/reporting this! Caroline On 20-09-17 02 h 05, Quỳnh Vũ Đỗ wrote:
Hello I have been using Koha documentation to extend Koha 19.11 as a CMS and followed instructions given on the following page: https://koha-community.org/manual/19.11/en/html/extending_koha.html#using-ko...
*Under the section "Editing the pages template" it is written as follows:* - 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 ) %]<div id="opacmainuserblock">[% OpacMainUserBlock %]</div>[% END %] - To this: [% IF ( page_test ) %]<div id="opacmainuserblock">[% page_test %]</div>[% END %]
*But in the pages.tt <http://pages.tt> file (copied from opac-main.tt <http://opac-main.tt>) and where modifications are to be carried out, the line shows not at approximately line 61 but at line 152 and is written as:* [% IF ( OpacMainUserBlock ) %]<div id="opacmainuserblock">[% OpacMainUserBlock | $raw %]</div>[% END %]
It is of course a very minor difference but for the sake of exactitude, it would be nice to have these differences corrected (line number and code)
*There is however a bigger issue with the following content:*
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 ) %] <div id="news"> <table class="table table-bordered"> [% FOREACH koha_new IN koha_news %] <thead><tr><th>[% koha_new.title %]</th></tr></thead> <tbody><tr><td><p>[% koha_new.new %]</p> <p class="newsfooter"><i>(published on [% koha_new.newdate %])</i></p></td></tr></tbody> [% END %] </table> </div> [% END %]
*Because the code to be researched as above has been completely modified and spans from line 72 to 102 (30 lines of code) and even further.*
The same remarks stand also for 20.05 documentation ( https://koha-community.org/manual/20.05/en/html/extending_koha.html#using-ko... )
To whom shall we report this, else than in this mailing list?
Kind regards Quynh ================= M. Vũ Đỗ Quỳnh (Ph.D) Trường Đại học Thăng Long - Université de Thang Long - Thang Long University (Hanoi, Vietnam) Phó Hiệu Trưởng, phụ trách HTQT - Vice-recteur chargé de la coopération internationale - Vice-Rector in charge of International Cooperation Web: http://thanglong.edu.vn/ _______________________________________________
Koha mailing list http://koha-community.org Koha@lists.katipo.co.nz Unsubscribe: https://lists.katipo.co.nz/mailman/listinfo/koha
-- Caroline Cyr La Rose, M.S.I. Bibliothécaire | Responsable de produit Tél. : 1-833-465-4276, poste 221 Caroline.Cyr-La-Rose@inLibro.com <mailto:caroline.cyr-la-rose@inLibro.com> INLiBRO | Spécialistes en technologies documentaires | www.inLibro.com <http://www.inLibro.com>
participants (2)
-
Caroline Cyr-La-Rose -
Quỳnh Vũ Đỗ