From 634dceef57ec913decd15b6f0ce36614e15d94e8 Mon Sep 17 00:00:00 2001 From: Raphael Dannecker Date: Thu, 3 Sep 2020 21:25:42 +0200 Subject: [PATCH] initial commit (da) --- LICENSE.md | 596 ++++++++++++++++++++++++++++++++ README.md | 21 ++ amd/build/search.min.js | 1 + amd/src/search.js | 34 ++ classes/output/renderer.php | 25 ++ classes/output/searchform.php | 28 ++ classes/output/timetable.php | 61 ++++ classes/task/import_data.php | 251 ++++++++++++++ classes/timetable.php | 301 ++++++++++++++++ db/install.php | 34 ++ db/install.xml | 101 ++++++ db/services.php | 53 +++ db/tasks.php | 16 + db/uninstall.php | 34 ++ db/upgrade.php | 183 ++++++++++ externallib.php | 215 ++++++++++++ index.php | 92 +++++ lang/en/timetable.php | 43 +++ lib.php | 99 ++++++ mod_form.php | 80 +++++ settings.php | 66 ++++ templates/searchform.mustache | 7 + templates/searchresult.mustache | 50 +++ templates/timetable.mustache | 86 +++++ version.php | 31 ++ view.php | 84 +++++ 26 files changed, 2592 insertions(+) create mode 100644 LICENSE.md create mode 100644 README.md create mode 100644 amd/build/search.min.js create mode 100644 amd/src/search.js create mode 100644 classes/output/renderer.php create mode 100644 classes/output/searchform.php create mode 100644 classes/output/timetable.php create mode 100755 classes/task/import_data.php create mode 100755 classes/timetable.php create mode 100644 db/install.php create mode 100644 db/install.xml create mode 100644 db/services.php create mode 100755 db/tasks.php create mode 100644 db/uninstall.php create mode 100644 db/upgrade.php create mode 100644 externallib.php create mode 100644 index.php create mode 100644 lang/en/timetable.php create mode 100644 lib.php create mode 100644 mod_form.php create mode 100644 settings.php create mode 100644 templates/searchform.mustache create mode 100644 templates/searchresult.mustache create mode 100644 templates/timetable.mustache create mode 100644 version.php create mode 100644 view.php diff --git a/LICENSE.md b/LICENSE.md new file mode 100644 index 0000000..16d89e0 --- /dev/null +++ b/LICENSE.md @@ -0,0 +1,596 @@ +GNU GENERAL PUBLIC LICENSE +========================== + +Version 3, 29 June 2007 + +Copyright © 2007 Free Software Foundation, Inc. <> + +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. + + + Copyright (C) + + 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 . + +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: + + Copyright (C) + 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 +<>. + +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 +<>. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..206598f --- /dev/null +++ b/README.md @@ -0,0 +1,21 @@ +# timetable # + +TODO Describe the plugin shortly here. + +TODO Provide more detailed description here. + +## License ## + +2020 Raphael Dannecker + +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 . diff --git a/amd/build/search.min.js b/amd/build/search.min.js new file mode 100644 index 0000000..9c9f310 --- /dev/null +++ b/amd/build/search.min.js @@ -0,0 +1 @@ +define(["jquery","core/ajax","core/templates","core/notification"],function($,ajax,templates,notification){function search_timetable(searchstring){var promises=ajax.call([{methodname:"mod_timetable_search",args:{searchstring:searchstring}}]);promises[0].done(function(response){console.log("mod_timetable/search is"+response);templates.render("mod_timetable/searchresult",{searchresults:response}).done(function(html,js){$(".searchresult").replaceWith(html);templates.runTemplateJS(js)}).fail(notification.exception)}).fail(function(ex){})}function load_timetable(type,name){var promises=ajax.call([{methodname:"mod_timetable_get",args:{type:type,name:name,week:0}}]);promises[0].done(function(response){console.log("mod_timetable/get is"+response);templates.render("mod_timetable/timetable",{get:response}).done(function(html,js){$(".timetable").replaceWith(html);templates.runTemplateJS(js)}).fail(notification.exception)}).fail(function(ex){})}return{initialize:function(){$(document).ready(function(){$(".searchstring").keyup(function(){search_timetable($(this).val())});$(".searchresults").click(function(){load_timetable("teacher","Da")})})}}}); diff --git a/amd/src/search.js b/amd/src/search.js new file mode 100644 index 0000000..083409a --- /dev/null +++ b/amd/src/search.js @@ -0,0 +1,34 @@ +define([ + 'jquery','core/ajax','core/templates', 'core/notification' +], function($, ajax, templates, notification) { + + function search_timetable(searchstring) { + //alert(searchstring); + var promises = ajax.call([ + { methodname: 'mod_timetable_search', args: { searchstring: searchstring } }, + ]); + + promises[0].done(function(response) { + console.log('mod_timetable/search is' + response); + templates.render('mod_timetable/searchresult',{searchresults: response}).done(function(html, js) { + $('.searchresult').replaceWith(html); + templates.runTemplateJS(js); + }).fail(notification.exception); + }).fail(function(ex) { + // do something with the exception + }); + + } + + + return { + initialize: function () { + $(document).ready(function () { + //alert('Hi there'); + $(".searchstring").keyup(function() { + search_timetable($(this).val()); + }); + }); + } + }; +}); diff --git a/classes/output/renderer.php b/classes/output/renderer.php new file mode 100644 index 0000000..7abd36e --- /dev/null +++ b/classes/output/renderer.php @@ -0,0 +1,25 @@ +export_for_template($this); + return parent::render_from_template('mod_timetable/timetable', $data); + } + public function render_search_form($page) { + $data = $page->export_for_template($this); + return parent::render_from_template('mod_timetable/searchform', $data); + } +} diff --git a/classes/output/searchform.php b/classes/output/searchform.php new file mode 100644 index 0000000..a961353 --- /dev/null +++ b/classes/output/searchform.php @@ -0,0 +1,28 @@ +sometext = $sometext; + } + + /** + * Export this data so it can be used as the context for a mustache template. + * + * @return stdClass + */ + public function export_for_template(renderer_base $output) { + $data = new stdClass(); + $data->sometext = $this->sometext; + return $data; + } +} diff --git a/classes/output/timetable.php b/classes/output/timetable.php new file mode 100644 index 0000000..0495e52 --- /dev/null +++ b/classes/output/timetable.php @@ -0,0 +1,61 @@ +timetable = $timetable; + } + + /** + * Export this data so it can be used as the context for a mustache template. + * + * @return stdClass + */ + public function export_for_template(renderer_base $output) { + /* + $data = new stdClass(); + $numperiod = get_config('timetable', 'numperiod'); + if ($this->timetable->periodmax > $numperiod) $numperiod = $this->timetable->periodmax; + $numdayweek = 5 + get_config('timetable', 'saturday'); + if ($numdayweek == 6) $data->saturday = 1; + $periods = array(); + + for ($period=0; $period<$numperiod; $period++) { + $days = array(); + for ($day=0; $day<$numdayweek; $day++) { + $days[$day] = new stdClass; + //$days[$day]->lessons = "$period, $day"; + $days[$day]->lessons = array(); + + if (array_key_exists($period+1,$this->timetable->data[$day+1]) + && array_key_exists('lesson',$this->timetable->data[$day+1][$period+1])) { + foreach ($this->timetable->data[$day+1][$period+1]['lesson'] as $lesson) { + $mylesson = new stdClass; + $mylesson->class = $lesson->class; + $mylesson->teacher = $lesson->teacher; + $mylesson->room = $lesson->room; + $mylesson->subject = $lesson->subject; + $mylesson->status = $lesson->week[$this->timetable->week-1]; + $mylesson->flag = $lesson->flag; + $days[$day]->lessons[] = $mylesson; + } + } + } + $periods[$period] = new stdClass; + $periods[$period]->days = $days; + $periods[$period]->number = $period+1; + } + $data->periods = $periods; + //echo var_dump($data); */ + return $this->timetable->prepare_output(); + } +} diff --git a/classes/task/import_data.php b/classes/task/import_data.php new file mode 100755 index 0000000..7c0754e --- /dev/null +++ b/classes/task/import_data.php @@ -0,0 +1,251 @@ +start_delegated_transaction(); + echo "before delete\n"; + $DB->delete_records_select("timetable_lesson", "id>0"); + echo "after delete\n"; + $handle = @fopen($filenamel, "r"); + echo "after handle\n"; + while (($buffer = fgets($handle, 4096)) !== false) { + // echo $buffer; + $buffer = utf8_encode(rtrim($buffer)); + $data = explode("\t", $buffer); + if (count($data) != 10) throw new Exception('Wrong size of elements'); + $dataobject = (object)array('teacher' => $data[0], + 'day' => $data[1], + 'period' => $data[2], + 'subject' => $data[3], + 'room' => $data[4], + 'lessonid'=> $data[5], + 'flag' => $data[6], + 'class' => $data[7], + 'week' => $data[8], + 'unknown' => $data[9]); + + $DB->insert_record("timetable_lesson", $dataobject); + } + $transaction->allow_commit(); + fclose($handle); + $lastmtime = $mtime; + set_config('lastmtime', $lastmtime, 'timetable'); + } catch(Exception $e) { + $transaction->rollback($e); + } + } + } + + private function read_substitution() { + global $DB,$CFG; + $filehash = get_config('timetable', 'filehash_substitution'); + $filename = get_config('timetable', 'fname_substitution'); + + if (!$filename || !file_exists($filename)) return; + if (($handle = fopen($filename, 'r')) == FALSE) return; + $hash = hash_file('md5', $filename); + if ($hash == $filehash) return; + $max_id = 0; + $max_changetime = 0; + if ($result = $DB->get_record_sql("select max(id), max(changetime) from {$CFG->prefix}timetable_substitution")) { + $max_id = $result->{'max(id)'}; + $max_changetime = $result->{'max(changetime)'}; + } + echo "Max id = $max_id\n"; + echo "Max changetime = $max_changetime\n"; + try { + $transaction = $DB->start_delegated_transaction(); + while (($data = fgetcsv($handle, 1000, ',')) !== FALSE) { + $dataobject = (object)array('id' => $data[0], + 'date' => $data[1], + 'period' => $data[2], + 'absence' => $data[3], + 'lesson' => $data[4], + 'teachera' => $data[5], + 'teacherb' => $data[6], + 'subjecta' => utf8_encode($data[7]), + 'statistica' => $data[8], + 'subjectb' => utf8_encode($data[9]), + 'statisticb' => $data[10], + 'rooma' => $data[11], + 'roomb' => $data[12], + 'statisticflag' => $data[13], + 'classa' => utf8_encode($data[14]), + 'reason' => utf8_encode($data[15]), + 'text' => utf8_encode($data[16]), + 'type' => $data[17], + 'classb' => utf8_encode($data[18]), + 'substitutiontype' => $data[19], + 'changetime' => $data[20], + 'unknown' => $data[21]); + //echo var_dump($dataobject); + foreach (get_object_vars($dataobject) as $key => $value) { + if ($value=='') unset($dataobject->{$key}); + } + if ($dataobject->id > $max_id) { + $DB->insert_record_raw("timetable_substitution", $dataobject,false, false, true); + echo "Object (id={$data[0]}) inserted\n"; + } elseif ($dataobject->changetime >= $max_changetime) { + $DB->update_record("timetable_substitution", $dataobject); + echo "Object (id={$data[0]}) updated\n"; + } + } + $transaction->allow_commit(); + fclose($handle); + set_config('filehash_substitution', $hash, 'timetable'); + } catch(Exception $e) { + $transaction->rollback($e); + } + } + + private function read_teacher() { + global $DB,$CFG; + $filehash = get_config('timetable', 'filehash_teacher'); + $filename = get_config('timetable', 'fname_teacher'); + echo "Filename: $filename\n"; + if (!$filename || !file_exists($filename)) return; + if (($handle = fopen($filename, 'r')) == FALSE) return; + $hash = hash_file('md5', $filename); + if ($hash == $filehash) return; + try { + $transaction = $DB->start_delegated_transaction(); + echo "before delete\n"; + $DB->delete_records_select("timetable_teacher", "id>0"); + echo "after delete\n"; + $handle = @fopen($filename, "r"); + echo "after handle\n"; + while (($buffer = fgets($handle, 4096)) !== false) { + echo $buffer; + $buffer = utf8_encode(rtrim($buffer)); + $data = explode("\t", $buffer); + if (!(array_key_exists(3,$data))) { + $data[3] = ''; + } else { + echo "firstname exists: $data[3]\n"; + } + //if (count($data) < 3) throw new Exception('Wrong size of elements'); + $dataobject = (object)array('teacher' => $data[0], + 'surname' => $data[1], + 'firstname' => $data[3]); + + $DB->insert_record("timetable_teacher", $dataobject); + } + $transaction->allow_commit(); + fclose($handle); + set_config('filehash_teacher', $hash, 'timetable'); + } catch(Exception $e) { + $transaction->rollback($e); + } + } + + private function read_room() { + global $DB,$CFG; + $filehash = get_config('timetable', 'filehash_room'); + $filename = get_config('timetable', 'fname_room'); + + if (!$filename || !file_exists($filename)) return; + if (($handle = fopen($filename, 'r')) == FALSE) return; + $hash = hash_file('md5', $filename); + if ($hash == $filehash) return; + try { + $transaction = $DB->start_delegated_transaction(); + echo "before delete\n"; + $DB->delete_records_select("timetable_room", "id>0"); + echo "after delete\n"; + $handle = @fopen($filename, "r"); + echo "after handle\n"; + while (($buffer = fgets($handle, 4096)) !== false) { + // echo $buffer; + $buffer = utf8_encode(rtrim($buffer)); + $data = explode("\t", $buffer); + if (count($data) < 2) throw new Exception('Wrong size of elements'); + $dataobject = (object)array('room' => $data[0], + 'description' => $data[1]); + + $DB->insert_record("timetable_room", $dataobject); + } + $transaction->allow_commit(); + fclose($handle); + set_config('filehash_room', $hash, 'timetable'); + } catch(Exception $e) { + $transaction->rollback($e); + } + } + + private function read_class() { + global $DB,$CFG; + $filehash = get_config('timetable', 'filehash_class'); + $filename = get_config('timetable', 'fname_class'); + + if (!$filename || !file_exists($filename)) return; + if (($handle = fopen($filename, 'r')) == FALSE) return; + $hash = hash_file('md5', $filename); + if ($hash == $filehash) return; + try { + $transaction = $DB->start_delegated_transaction(); + echo "before delete\n"; + $DB->delete_records_select("timetable_class", "id>0"); + echo "after delete\n"; + $handle = @fopen($filename, "r"); + echo "after handle\n"; + while (($buffer = fgets($handle, 4096)) !== false) { + // echo $buffer; + $buffer = utf8_encode(rtrim($buffer)); + $data = explode("\t", $buffer); + if (!(array_key_exists(1,$data))) $data[1] = $data[0]; + + if (count($data) < 2) throw new Exception('Wrong size of elements'); + $dataobject = (object)array('class' => $data[0], + 'description' => $data[1]); + + $DB->insert_record("timetable_class", $dataobject); + } + $transaction->allow_commit(); + fclose($handle); + set_config('filehash_class', $hash, 'timetable'); + } catch(Exception $e) { + $transaction->rollback($e); + } + } + + /** + * Execute the task. + */ + public function execute() { + global $DB,$CFG; + + $this->read_lesson(); + $this->read_substitution(); + $this->read_teacher(); + $this->read_room(); + $this->read_class(); + } + +} \ No newline at end of file diff --git a/classes/timetable.php b/classes/timetable.php new file mode 100755 index 0000000..119dd4f --- /dev/null +++ b/classes/timetable.php @@ -0,0 +1,301 @@ + + * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +namespace mod_timetable; + +defined('MOODLE_INTERNAL') || die(); + +/** + * Class timetable + * + * @package mod_timetable + * @copyright 2020 Raphael Dannecker + * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ +class timetable { + + /** @var array the data of timetable */ + public $data; + + /** + * Class constructor + * + * @param string $type The type of the timetable [class, room, teacher] + * @param string $name Name of class or room or teacher + */ + public function __construct($type, $name) { + $this->type = $type; + $this->name = $name; + $this->periodmax=0; + $this->clear_data(); + } + + public function clear_data() { + $this->data = array(); + for ($i=1; $i<=6; $i++) $this->data[$i] = array(); + } + + + /** + * + * @param int $week The week of timetable + */ + public function read_db($week) { + global $USER, $DB, $CFG; + + $this->clear_data(); + $this->numdayweek = 5 + get_config('timetable', 'saturday'); + $this->week = $week; + $this->monday = new \DateTime(); + $this->monday->setISODate($this->monday->format("Y"), $week); +/* + $this->monday = new \DateTime('29-07-2020'); // Only for debugging!!! + if ($week>0) { + $this->monday->add(new \DateInterval("P".($week)."W")); + } elseif ($week<0) { + $this->monday->sub(new \DateInterval("P".(-$week)."W")); + } + */ + $dayofweek = $this->monday->format('w'); + if ($dayofweek > $this->numdayweek) { + $this->monday->add(new \DateInterval("P".(8-$dayofweek)."D")); + } elseif ($dayofweek < 1) { + $this->monday->add(new \DateInterval("P1D")); + } else { + $this->monday->sub(new \DateInterval("P".($dayofweek-1)."D")); + } + + $this->week = $this->monday->format("W"); + $this->lastday = new \DateTime($this->monday->format('Y-m-d\TH:i:sP')); + $this->lastday->add(new \DateInterval("P".($this->numdayweek-1)."D")); + + //$this->content->text .= $monday->format('d.m') . " - " . $lastday->format('d.m'); + + $sql = "$this->type = '$this->name' and not (mid(week, $this->week, 1) = '-')"; + //$sql = "$this->type = '$this->name' and (mid(week, $this->week, 1) = '1')"; + if ($result = $DB->get_records_select('timetable_lesson',$sql)) { + foreach ($result as $lesson) { + //if (!exists($this->data[$lesson->day][$lesson->period])) $this->data[$lesson->day][$lesson->period] = array(); + $this->data[$lesson->day][$lesson->period]['lesson'][] = $lesson; + if ($this->periodmax < $lesson->period) $this->periodmax = $lesson->period; + } + } + $day = new \DateTime($this->monday->format('Y-m-d\TH:i:sP')); + + for ($i=0; $i<$this->numdayweek; $i++) { + $sql = "date = '".$day->format('Ymd')."' AND ({$this->type}a LIKE '%{$this->name}%' OR {$this->type}b LIKE '%{$this->name}%')"; + if ($result = $DB->get_records_select('timetable_substitution',$sql)) { + foreach ($result as $substitution) { + $this->data[$i+1][$substitution->period]['substitution'][] = $substitution; + if ($this->periodmax < $lesson->period) $this->periodmax = $lesson->period; + } + } + $day->add(new \DateInterval("P1D")); + } + + if ($this->type == 'teacher') { + if ($result = $DB->get_record("timetable_$this->type",[$this->type => $this->name])) { + $this->description = "$result->surname, $result->firstname"; + } + } else { + if ($result = $DB->get_record("timetable_$this->type",[$this->type => $this->name])) { + $this->description = $result->description; + } + } + } + + /** + * Count the number of online users + * + * @return int + */ + public function print_navigation($week) { + /** + * Count the number of online users + * + * @return int + */ + $table = new \html_table(); + $table->attributes['class'] = 'minicalendar calendartable calendar-controls'; + //$table->head = array('','Mo','Di', 'Mi' , 'Do', 'Fr'); + $tablerow = new \html_table_row(); + if ($week>0) { + $tablerow->cells[] = new \html_table_cell(''); + } else { + $tablerow->cells[] = new \html_table_cell(''); + } + $tablerow->cells[] = new \html_table_cell(''.$this->monday->format('d.m') . " - " . $this->lastday->format('d.m').''); + if ($week<2) { + $tablerow->cells[] = new \html_table_cell(''); + } else { + $tablerow->cells[] = new \html_table_cell(''); + } + + + $table->data[] = $tablerow; + return \html_writer::table($table); + + } + + public function get_caption($week) { + $result = ""; + if ($week>0) { + //$result .= ''; + $result .= ''; + } else { + $result .= ''; + //$result .= ''; + } + $result .= ' | '; + $result .= ''; + $result .= ''.$this->monday->format('d.m') . " - " . $this->lastday->format('d.m').''; + $result .= ""; + $result .= ' | '; + if ($week<2) { + //$result .= ''; + $result .= ''; + } else { + $result .= ''; + } + return $result; + + } + + + public function print_table($view,$week) { + global $DB; + //var_dump($this->data[1]); + $numperiod = get_config('timetable', 'numperiod'); + $numdayweek = 5 + get_config('timetable', 'saturday'); + if ($this->periodmax>$numperiod) $numperiod = $this->periodmax; + $table = new \html_table(); + //$table->attributes['class'] = "minicalendar calendartable generaltable timetable_view_$view"; + $table->attributes['class'] = "minicalendar calendartable generaltable timetable_view_$view"; + $table->caption = "
".$this->get_caption($week)."
"; + //$table->style = 'display: none;'; + $table->head = array('','Mo','Di', 'Mi' , 'Do', 'Fr'); + if ($numdayweek == 6) $table->head[] = 'Sa'; + for ($i = 1; $i<=$numperiod; $i++) { + $tablerow = new \html_table_row(); + $cell = new \html_table_cell($i); + $cell->style = 'font-weight: bold;'; +// $cell->attributes['class'] = 'header'; + $tablerow->cells[] = $cell; + for ($k = 1; $k <= $numdayweek; $k++) { + $flag = 0; + if (array_key_exists($i,$this->data[$k]) && array_key_exists('lesson',$this->data[$k][$i])) { + $content = ""; + foreach ($this->data[$k][$i]['lesson'] as $lesson) { + if ($content) $content .= "
"; + if ($lesson->flag) $content .= ""; + //if (substr($lesson->week,$this->week,1) == '1') $content .= $lesson->{$view}; + if ($lesson->week[$this->week-1] == '1') { + if ($lesson->{$view}) { + $content .= $lesson->{$view}; + } else { + $content .= "+++"; + } + } + if ($lesson->week[$this->week-1] == 'x') $content .= "---"; + if ($lesson->flag) $content .= ""; + $flag += $lesson->flag; + } + } else { + $content = "-"; + } + $subtxt = ""; + if (array_key_exists($i,$this->data[$k]) && array_key_exists('substitution', $this->data[$k][$i])) { + foreach ($this->data[$k][$i]['substitution'] as $substitution) { + $subtxt .= $substitution->text; + } + if ($subtxt) { + $content = "$content"; + //$content .= "$subtxt"; + } + } + $cell = new \html_table_cell($content); +// if ($flag) $cell->style = 'color: red;'; + //if (array_key_exists($i, $this->data[$k] ) && array_key_exists('substitution', $this->data[$k][$i])) $cell->attributes['class'] = 'tooltip'; + $tablerow->cells[] = $cell; + } + $table->data[] = $tablerow; + } + return \html_writer::table($table); + } + + public function prepare_output() { + $resultdata = array(); + $numperiod = get_config('timetable', 'numperiod'); + if ($this->periodmax > $numperiod) $numperiod = $this->periodmax; + $numdayweek = 5 + get_config('timetable', 'saturday'); + if ($numdayweek == 6) $resultdata['saturday'] = 1; else $resultdata['saturday'] = 0; + $resultdata['type'] = $this->type; + $resultdata['name'] = $this->name; + $resultdata['description'] = $this->description; + $resultdata['date'] = $this->monday->format('d.m') . " - " . $this->lastday->format('d.m'); + $resultdata['week'] = $this->week; + $resultdata['prevweek'] = $this->week-1; + $resultdata['nextweek'] = $this->week+1; + $resultdata['id'] = \substr(\md5(\rand()), 0, 7); + + $periods = array(); + + for ($period=0; $period<$numperiod; $period++) { + $days = array(); + for ($day=0; $day<$numdayweek; $day++) { + $days[$day] = array(); + $days[$day]['substitution'] = ""; + $days[$day]['lessons'] = array(); + if (array_key_exists($period+1,$this->data[$day+1]) + && array_key_exists('lesson',$this->data[$day+1][$period+1])) { + foreach ($this->data[$day+1][$period+1]['lesson'] as $lesson) { + $mylesson = array(); + $mylesson['class'] = $lesson->class; + $mylesson['teacher'] = $lesson->teacher; + $mylesson['room'] = $lesson->room; + $mylesson['subject'] = $lesson->subject; + $mylesson['status'] = ""; + if ($lesson->week[$this->week-1] == 'x') $mylesson['status'] = 1; + $mylesson['flag'] = ""; + if ($lesson->flag) $mylesson['flag'] = $lesson->flag; + + if ($this->type == 'class') $mylesson['class'] = ""; + if ($this->type == 'teacher') $mylesson['teacher'] = ""; + if ($this->type == 'room') $mylesson['room'] = ""; + $days[$day]['lessons'][] = $mylesson; + /* + - für diese Woche wurden keine Daten ausgegeben + 0 in dieser Woche findet der Unterricht nicht statt + 1 in dieser Woche findet der Unterricht statt + x in dieser Woche entfällt der Unterricht + + if ($lesson->week[$this->week-1] == 'x') + */ + } + } + if (array_key_exists($period+1,$this->data[$day+1]) + && array_key_exists('substitution', $this->data[$day+1][$period+1])) { + foreach ($this->data[$day+1][$period+1]['substitution'] as $substitution) { + //echo "In substitution loop".$substitution->text; + $days[$day]['substitution'] .= $substitution->text; + } + } + + } + $periods[$period] = array(); + $periods[$period]['days'] = $days; + $periods[$period]['number'] = $period+1; + } + $resultdata['periods'] = $periods; + //echo var_dump($data); + return $resultdata; + } + +} diff --git a/db/install.php b/db/install.php new file mode 100644 index 0000000..239deee --- /dev/null +++ b/db/install.php @@ -0,0 +1,34 @@ +. + +/** + * Code to be executed after the plugin's database scheme has been installed is defined here. + * + * @package mod_timetable + * @category upgrade + * @copyright 2020 Raphael Dannecker + * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +defined('MOODLE_INTERNAL') || die(); + +/** + * Custom code to be run on installing the plugin. + */ +function xmldb_timetable_install() { + + return true; +} diff --git a/db/install.xml b/db/install.xml new file mode 100644 index 0000000..dd02728 --- /dev/null +++ b/db/install.xml @@ -0,0 +1,101 @@ + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + + + + + +
+ + + + + + + + + +
+ + + + + + + + + +
+ + \ No newline at end of file diff --git a/db/services.php b/db/services.php new file mode 100644 index 0000000..c7d0a24 --- /dev/null +++ b/db/services.php @@ -0,0 +1,53 @@ +. + +/** + * Web service local plugin template external functions and service definitions. + * + * @package mod_timetable + * @copyright 2020 Raphael Dannecker + * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +// We defined the web service functions to install. +$functions = array( + 'mod_timetable_search' => array( + 'classname' => 'mod_timetable_external', + 'methodname' => 'search', + 'classpath' => 'mod/timetable/externallib.php', + 'description' => 'Return search result of timetable search', + 'type' => 'read', + 'ajax' => true, + 'capabilities' => array(), // capabilities required by the function. + ), + 'mod_timetable_get' => array( + 'classname' => 'mod_timetable_external', + 'methodname' => 'get', + 'classpath' => 'mod/timetable/externallib.php', + 'description' => 'Return timetable data', + 'type' => 'read', + 'ajax' => true, + 'capabilities' => array(), // capabilities required by the function. + ) +); + +// We define the services to install as pre-build services. A pre-build service is not editable by administrator. +$services = array( + 'My service' => array( + 'functions' => array ('mod_timetable_search','mod_timetable_get'), + 'restrictedusers' => 0, + 'enabled'=>1, + ) +); diff --git a/db/tasks.php b/db/tasks.php new file mode 100755 index 0000000..fb37dc3 --- /dev/null +++ b/db/tasks.php @@ -0,0 +1,16 @@ + '\mod_timetable\task\import_data', + 'blocking' => 0, + 'minute' => '*/10', + 'hour' => '*', + 'day' => '*', + 'month' => '*', + 'dayofweek' => '*', + ], +]; + diff --git a/db/uninstall.php b/db/uninstall.php new file mode 100644 index 0000000..2cbdff3 --- /dev/null +++ b/db/uninstall.php @@ -0,0 +1,34 @@ +. + +/** + * Code that is executed before the tables and data are dropped during the plugin uninstallation. + * + * @package mod_timetable + * @category upgrade + * @copyright 2020 Raphael Dannecker + * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +defined('MOODLE_INTERNAL') || die(); + +/** + * Custom uninstallation procedure. + */ +function xmldb_timetable_uninstall() { + + return true; +} diff --git a/db/upgrade.php b/db/upgrade.php new file mode 100644 index 0000000..68c4e41 --- /dev/null +++ b/db/upgrade.php @@ -0,0 +1,183 @@ +. + +/** + * Plugin upgrade steps are defined here. + * + * @package mod_timetable + * @category upgrade + * @copyright 2020 Raphael Dannecker + * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +defined('MOODLE_INTERNAL') || die(); + +/** + * Execute mod_timetable upgrade from the given old version. + * + * @param int $oldversion + * @return bool + */ +function xmldb_timetable_upgrade($oldversion) { + global $DB; + + $dbman = $DB->get_manager(); + + // For further information please read the Upgrade API documentation: + // https://docs.moodle.org/dev/Upgrade_API + // + // You will also have to create the db/install.xml file by using the XMLDB Editor. + // Documentation for the XMLDB Editor can be found at: + // https://docs.moodle.org/dev/XMLDB_editor + + if ($oldversion < 2020082903) { + + // Define table timetable to be created. + $table = new xmldb_table('timetable'); + + // Adding fields to table timetable. + $table->add_field('id', XMLDB_TYPE_INTEGER, '10', null, XMLDB_NOTNULL, XMLDB_SEQUENCE, null); + $table->add_field('course', XMLDB_TYPE_INTEGER, '10', null, XMLDB_NOTNULL, null, null); + $table->add_field('name', XMLDB_TYPE_CHAR, '255', null, XMLDB_NOTNULL, null, null); + $table->add_field('timecreated', XMLDB_TYPE_INTEGER, '10', null, XMLDB_NOTNULL, null, '0'); + $table->add_field('timemodified', XMLDB_TYPE_INTEGER, '10', null, XMLDB_NOTNULL, null, '0'); + $table->add_field('intro', XMLDB_TYPE_TEXT, null, null, null, null, null); + $table->add_field('introformat', XMLDB_TYPE_INTEGER, '4', null, XMLDB_NOTNULL, null, '0'); + + // Adding keys to table timetable. + $table->add_key('primary', XMLDB_KEY_PRIMARY, ['id']); + $table->add_key('fk_course', XMLDB_KEY_FOREIGN, ['course'], 'course', ['id']); + + // Conditionally launch create table for timetable. + if (!$dbman->table_exists($table)) { + $dbman->create_table($table); + } + + // Define table timetable_lesson to be created. + $table = new xmldb_table('timetable_lesson'); + + // Adding fields to table timetable_lesson. + $table->add_field('id', XMLDB_TYPE_INTEGER, '10', null, XMLDB_NOTNULL, XMLDB_SEQUENCE, null); + $table->add_field('teacher', XMLDB_TYPE_CHAR, '20', null, null, null, null); + $table->add_field('day', XMLDB_TYPE_INTEGER, '2', null, null, null, null); + $table->add_field('period', XMLDB_TYPE_INTEGER, '2', null, null, null, null); + $table->add_field('subject', XMLDB_TYPE_CHAR, '20', null, null, null, null); + $table->add_field('room', XMLDB_TYPE_CHAR, '20', null, null, null, null); + $table->add_field('lessonid', XMLDB_TYPE_INTEGER, '7', null, null, null, null); + $table->add_field('flag', XMLDB_TYPE_INTEGER, '7', null, null, null, null); + $table->add_field('class', XMLDB_TYPE_CHAR, '20', null, null, null, null); + $table->add_field('week', XMLDB_TYPE_CHAR, '53', null, null, null, null); + $table->add_field('unknown', XMLDB_TYPE_INTEGER, '7', null, null, null, null); + + // Adding keys to table timetable_lesson. + $table->add_key('primary', XMLDB_KEY_PRIMARY, ['id']); + + // Conditionally launch create table for timetable_lesson. + if (!$dbman->table_exists($table)) { + $dbman->create_table($table); + } + + // Define table timetable_substitution to be created. + $table = new xmldb_table('timetable_substitution'); + + // Adding fields to table timetable_substitution. + $table->add_field('id', XMLDB_TYPE_INTEGER, '10', null, XMLDB_NOTNULL, XMLDB_SEQUENCE, null); + $table->add_field('date', XMLDB_TYPE_CHAR, '8', null, null, null, null); + $table->add_field('period', XMLDB_TYPE_INTEGER, '2', null, null, null, null); + $table->add_field('absence', XMLDB_TYPE_INTEGER, '6', null, null, null, null); + $table->add_field('lesson', XMLDB_TYPE_INTEGER, '6', null, null, null, null); + $table->add_field('teachera', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('teacherb', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('subjecta', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('statistica', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('subjectb', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('statisticb', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('rooma', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('roomb', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('statisticflag', XMLDB_TYPE_CHAR, '10', null, null, null, null); + $table->add_field('classa', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('reason', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('text', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('type', XMLDB_TYPE_INTEGER, '10', null, null, null, null); + $table->add_field('classb', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('substitutiontype', XMLDB_TYPE_CHAR, '1', null, null, null, null); + $table->add_field('changetime', XMLDB_TYPE_INTEGER, '12', null, null, null, null); + $table->add_field('unknown', XMLDB_TYPE_CHAR, '10', null, null, null, null); + + // Adding keys to table timetable_substitution. + $table->add_key('primary', XMLDB_KEY_PRIMARY, ['id']); + + // Conditionally launch create table for timetable_substitution. + if (!$dbman->table_exists($table)) { + $dbman->create_table($table); + } + + // Define table timetable_teacher to be created. + $table = new xmldb_table('timetable_teacher'); + + // Adding fields to table timetable_teacher. + $table->add_field('id', XMLDB_TYPE_INTEGER, '10', null, XMLDB_NOTNULL, XMLDB_SEQUENCE, null); + $table->add_field('teacher', XMLDB_TYPE_CHAR, '20', null, XMLDB_NOTNULL, null, null); + $table->add_field('surname', XMLDB_TYPE_CHAR, '255', null, null, null, null); + $table->add_field('firstname', XMLDB_TYPE_CHAR, '255', null, null, null, null); + + // Adding keys to table timetable_teacher. + $table->add_key('primary', XMLDB_KEY_PRIMARY, ['id']); + + // Conditionally launch create table for timetable_teacher. + if (!$dbman->table_exists($table)) { + $dbman->create_table($table); + } + + // Define table timetable_room to be created. + $table = new xmldb_table('timetable_room'); + + // Adding fields to table timetable_room. + $table->add_field('id', XMLDB_TYPE_INTEGER, '10', null, XMLDB_NOTNULL, XMLDB_SEQUENCE, null); + $table->add_field('room', XMLDB_TYPE_CHAR, '20', null, XMLDB_NOTNULL, null, null); + $table->add_field('description', XMLDB_TYPE_CHAR, '255', null, null, null, null); + + // Adding keys to table timetable_room. + $table->add_key('primary', XMLDB_KEY_PRIMARY, ['id']); + + // Conditionally launch create table for timetable_room. + if (!$dbman->table_exists($table)) { + $dbman->create_table($table); + } + + // Define table timetable_class to be created. + $table = new xmldb_table('timetable_class'); + + // Adding fields to table timetable_class. + $table->add_field('id', XMLDB_TYPE_INTEGER, '10', null, XMLDB_NOTNULL, XMLDB_SEQUENCE, null); + $table->add_field('class', XMLDB_TYPE_CHAR, '20', null, XMLDB_NOTNULL, null, null); + $table->add_field('description', XMLDB_TYPE_CHAR, '255', null, null, null, null); + + // Adding keys to table timetable_class. + $table->add_key('primary', XMLDB_KEY_PRIMARY, ['id']); + + // Conditionally launch create table for timetable_class. + if (!$dbman->table_exists($table)) { + $dbman->create_table($table); + } + + // Timetable savepoint reached. + upgrade_mod_savepoint(true, 2020082903, 'timetable'); + } + + + return true; +} diff --git a/externallib.php b/externallib.php new file mode 100644 index 0000000..e65d54f --- /dev/null +++ b/externallib.php @@ -0,0 +1,215 @@ +. + +/** + * External Web Service Template + * + * @package mod_timetable + * @copyright 2020 Raphael Dannecker + * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ +require_once($CFG->libdir . "/externallib.php"); + +class mod_timetable_external extends external_api { + + /** + * Returns description of method parameters + * @return external_function_parameters + */ + public static function search_parameters() { + return new external_function_parameters( + array('searchstring' => new external_value(PARAM_TEXT, 'The searchstring.', VALUE_DEFAULT, '')) + ); + } + + /** + * Returns welcome message + * @return search result message + */ + public static function search($searchstring = 'Hello world, ') { + global $USER,$DB; + + //Parameter validation + //REQUIRED + $params = self::validate_parameters(self::search_parameters(), + array('searchstring' => $searchstring)); + + //Context validation + //OPTIONAL but in most web service it should present + $context = get_context_instance(CONTEXT_USER, $USER->id); + self::validate_context($context); + + //Capability checking + //OPTIONAL but in most web service it should present + if (!has_capability('moodle/user:viewdetails', $context)) { + throw new moodle_exception('cannotviewprofile'); + } + + $results = array(); + //return $params['searchstring'] . $USER->firstname ; + $classes = $DB->get_records_select('timetable_class', 'class like ? OR description like ? LIMIT 10', array ('%'.$params['searchstring'].'%', '%'.$params['searchstring'].'%')); + foreach($classes as $class) { + $result = array( + 'type' => 'class', + 'name' => $class->class, + 'description' => "Klassenplan: $class->description ($class->class)" + ); + $results[] = $result; + } + $teachers = $DB->get_records_select('timetable_teacher', 'teacher like ? OR surname like ? LIMIT 10', array ('%'.$params['searchstring'].'%', '%'.$params['searchstring'].'%')); + foreach($teachers as $teacher) { + $result = array( + 'type' => 'teacher', + 'name' => $teacher->teacher, + 'description' => "Lehrerplan: $teacher->surname, $teacher->firstname ($teacher->teacher)" + ); + $results[] = $result; + } + $rooms = $DB->get_records_select('timetable_room', 'description like ? limit 10', array ('%'.$params['searchstring'].'%')); + foreach($rooms as $room) { + $result = array( + 'type' => 'room', + 'name' => $room->room, + 'description' => "Raumplan: ".$room->description + ); + $results[] = $result; + } + //echo var_dump($results); + return $results; + } + + /** + * Returns description of method result value + * @return external_description + */ + public static function search_returns() { + //return new external_value(PARAM_TEXT, 'The search result'); + return new external_multiple_structure( + new external_single_structure( + array( + 'type' => new external_value(PARAM_TEXT, 'type of timetable: class, teacher, room'), + 'name' => new external_value(PARAM_TEXT, 'value of type'), + 'description' => new external_value(PARAM_TEXT, 'description') + ) + ) + ); + } + + + + /** + * Returns description of method parameters + * @return external_function_parameters + */ + public static function get_parameters() { + return new external_function_parameters( + array( + 'type' => new external_value(PARAM_TEXT, 'The type of timetable: class, teacher, room'), + 'name' => new external_value(PARAM_TEXT, 'value of type'), + 'week' => new external_value(PARAM_INT, 'The week of timetable') + ) + ); + } + + /** + * Returns welcome message + * @return get result message + */ + public static function get($type,$name,$week) { + global $USER,$DB; + + //Parameter validation + //REQUIRED + + //echo "Hallo\n"; + $params = self::validate_parameters(self::get_parameters(), + array('type' => $type, 'name'=> $name, 'week' => $week)); + + //Context validation + //OPTIONAL but in most web service it should present + $context = get_context_instance(CONTEXT_USER, $USER->id); + self::validate_context($context); + + //Capability checking + //OPTIONAL but in most web service it should present + if (!has_capability('moodle/user:viewdetails', $context)) { + throw new moodle_exception('cannotviewprofile'); + } + + //echo "Type: ".$params['type']."\n"; + //echo "Name: ".$params['name']."\n"; + //echo "Week: ".$params['week']."\n"; + if(!($params['week'])) { + $today = new \DateTime(); + $params['week'] = $today->format("W"); + } + + $ttable = new \mod_timetable\timetable($params['type'],$params['name']); + $ttable->read_db($params['week']); + //echo var_dump($ttable->prepare_output()); + return $ttable->prepare_output(); + //$renderable = new \mod_timetable\output\timetable($ttable); + //return $renderable->export_for_template(new \mod_timetable\output\renderer($USER,array())); + } + + /** + * Returns description of method result value + * @return external_description + */ + public static function get_returns() { + + + return new external_single_structure( + array( + 'periods' => new external_multiple_structure( + new external_single_structure( + array( + 'number' => new external_value(PARAM_INT, 'number of period'), + 'days' => new external_multiple_structure( + new external_single_structure( + array( + 'substitution' => new external_value(PARAM_TEXT, 'substitution'), + 'lessons' => new external_multiple_structure( + new external_single_structure( + array( + 'class' => new external_value(PARAM_TEXT, 'name of class'), + 'teacher' => new external_value(PARAM_TEXT, 'name of teacher'), + 'room' => new external_value(PARAM_TEXT, 'name of room'), + 'subject' => new external_value(PARAM_TEXT, 'name of subject'), + 'status' => new external_value(PARAM_TEXT, 'status of lesson'), + 'flag' => new external_value(PARAM_TEXT, 'flag of lesson') + ) + ) + ) + ) + ) + ) + ) + ) + ), + 'type' => new external_value(PARAM_TEXT, 'The type of timetable: class, teacher, room'), + 'name' => new external_value(PARAM_TEXT, 'value of type'), + 'date' => new external_value(PARAM_TEXT, 'date'), + 'description' => new external_value(PARAM_TEXT, 'description'), + 'saturday' => new external_value(PARAM_INT, 'if timetable includes saturday'), + 'week' => new external_value(PARAM_INT, 'The week of timetable'), + 'prevweek' => new external_value(PARAM_INT, 'The next week of timetable'), + 'nextweek' => new external_value(PARAM_INT, 'The prev week of timetable'), + 'id' => new external_value(PARAM_TEXT, 'The id of timetable') + ) + ); + } + +} diff --git a/index.php b/index.php new file mode 100644 index 0000000..4602092 --- /dev/null +++ b/index.php @@ -0,0 +1,92 @@ +. + +/** + * Display information about all the mod_timetable modules in the requested course. + * + * @package mod_timetable + * @copyright 2020 Raphael Dannecker + * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +require(__DIR__.'/../../config.php'); + +require_once(__DIR__.'/lib.php'); + +$id = required_param('id', PARAM_INT); + +$course = $DB->get_record('course', array('id' => $id), '*', MUST_EXIST); +require_course_login($course); + +$coursecontext = context_course::instance($course->id); + +$event = \mod_timetable\event\course_module_instance_list_viewed::create(array( + 'context' => $modulecontext +)); +$event->add_record_snapshot('course', $course); +$event->trigger(); + +$PAGE->set_url('/mod/timetable/index.php', array('id' => $id)); +$PAGE->set_title(format_string($course->fullname)); +$PAGE->set_heading(format_string($course->fullname)); +$PAGE->set_context($coursecontext); + +echo $OUTPUT->header(); + +$modulenameplural = get_string('modulenameplural', 'mod_timetable'); +echo $OUTPUT->heading($modulenameplural); + +$timetables = get_all_instances_in_course('timetable', $course); + +if (empty($timetables)) { + notice(get_string('nonewmodules', 'mod_timetable'), new moodle_url('/course/view.php', array('id' => $course->id))); +} + +$table = new html_table(); +$table->attributes['class'] = 'generaltable mod_index'; + +if ($course->format == 'weeks') { + $table->head = array(get_string('week'), get_string('name')); + $table->align = array('center', 'left'); +} else if ($course->format == 'topics') { + $table->head = array(get_string('topic'), get_string('name')); + $table->align = array('center', 'left', 'left', 'left'); +} else { + $table->head = array(get_string('name')); + $table->align = array('left', 'left', 'left'); +} + +foreach ($timetables as $timetable) { + if (!$timetable->visible) { + $link = html_writer::link( + new moodle_url('/mod/timetable/view.php', array('id' => $timetable->coursemodule)), + format_string($timetable->name, true), + array('class' => 'dimmed')); + } else { + $link = html_writer::link( + new moodle_url('/mod/timetable/view.php', array('id' => $timetable->coursemodule)), + format_string($timetable->name, true)); + } + + if ($course->format == 'weeks' or $course->format == 'topics') { + $table->data[] = array($timetable->section, $link); + } else { + $table->data[] = array($link); + } +} + +echo html_writer::table($table); +echo $OUTPUT->footer(); diff --git a/lang/en/timetable.php b/lang/en/timetable.php new file mode 100644 index 0000000..47579ea --- /dev/null +++ b/lang/en/timetable.php @@ -0,0 +1,43 @@ +. + +/** + * Plugin strings are defined here. + * + * @package mod_timetable + * @category string + * @copyright 2020 Raphael Dannecker + * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +defined('MOODLE_INTERNAL') || die(); + +$string['pluginname'] = 'Timetable'; +$string['import_data'] = 'import_data'; +$string['labelfnamelesson'] = 'lesson import file'; +$string['descfnamelesson'] = 'Absolute path and Filename of untis export file lesson.txt'; +$string['labelfnamesubst'] = 'substitution import file'; +$string['descfnamesubst'] = 'Absolute path and Filename of untis export file GPU014.TXT'; +$string['labelfnameteacher'] = 'teacher import file'; +$string['descfnameteacher'] = 'Absolute path and Filename of untis export file teacher.txt'; +$string['labelfnameroom'] = 'room import file'; +$string['descfnameroom'] = 'Absolute path and Filename of untis export file room.txt'; +$string['labelfnameclass'] = 'class import file'; +$string['descfnameclass'] = 'Absolute path and Filename of untis export file class.txt'; +$string['labelnumperiod'] = 'max period'; +$string['descnumperiod'] = 'max period per day'; +$string['labelsaturday'] = 'saturday'; +$string['descsaturday'] = 'enabled if saturday in timetable'; \ No newline at end of file diff --git a/lib.php b/lib.php new file mode 100644 index 0000000..afae588 --- /dev/null +++ b/lib.php @@ -0,0 +1,99 @@ +. + +/** + * Library of interface functions and constants. + * + * @package mod_timetable + * @copyright 2020 Raphael Dannecker + * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +defined('MOODLE_INTERNAL') || die(); + +/** + * Return if the plugin supports $feature. + * + * @param string $feature Constant representing the feature. + * @return true | null True if the feature is supported, null otherwise. + */ +function timetable_supports($feature) { + switch ($feature) { + case FEATURE_MOD_INTRO: + return true; + default: + return null; + } +} + +/** + * Saves a new instance of the mod_timetable into the database. + * + * Given an object containing all the necessary data, (defined by the form + * in mod_form.php) this function will create a new instance and return the id + * number of the instance. + * + * @param object $moduleinstance An object from the form. + * @param mod_timetable_mod_form $mform The form. + * @return int The id of the newly inserted record. + */ +function timetable_add_instance($moduleinstance, $mform = null) { + global $DB; + + $moduleinstance->timecreated = time(); + + $id = $DB->insert_record('timetable', $moduleinstance); + + return $id; +} + +/** + * Updates an instance of the mod_timetable in the database. + * + * Given an object containing all the necessary data (defined in mod_form.php), + * this function will update an existing instance with new data. + * + * @param object $moduleinstance An object from the form in mod_form.php. + * @param mod_timetable_mod_form $mform The form. + * @return bool True if successful, false otherwise. + */ +function timetable_update_instance($moduleinstance, $mform = null) { + global $DB; + + $moduleinstance->timemodified = time(); + $moduleinstance->id = $moduleinstance->instance; + + return $DB->update_record('timetable', $moduleinstance); +} + +/** + * Removes an instance of the mod_timetable from the database. + * + * @param int $id Id of the module instance. + * @return bool True if successful, false on failure. + */ +function timetable_delete_instance($id) { + global $DB; + + $exists = $DB->get_record('timetable', array('id' => $id)); + if (!$exists) { + return false; + } + + $DB->delete_records('timetable', array('id' => $id)); + + return true; +} diff --git a/mod_form.php b/mod_form.php new file mode 100644 index 0000000..3552797 --- /dev/null +++ b/mod_form.php @@ -0,0 +1,80 @@ +. + +/** + * The main mod_timetable configuration form. + * + * @package mod_timetable + * @copyright 2020 Raphael Dannecker + * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +defined('MOODLE_INTERNAL') || die(); + +require_once($CFG->dirroot.'/course/moodleform_mod.php'); + +/** + * Module instance settings form. + * + * @package mod_timetable + * @copyright 2020 Raphael Dannecker + * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ +class mod_timetable_mod_form extends moodleform_mod { + + /** + * Defines forms elements + */ + public function definition() { + global $CFG; + + $mform = $this->_form; + + // Adding the "general" fieldset, where all the common settings are shown. + $mform->addElement('header', 'general', get_string('general', 'form')); + + // Adding the standard "name" field. + $mform->addElement('text', 'name', get_string('timetablename', 'mod_timetable'), array('size' => '64')); + + if (!empty($CFG->formatstringstriptags)) { + $mform->setType('name', PARAM_TEXT); + } else { + $mform->setType('name', PARAM_CLEANHTML); + } + + $mform->addRule('name', null, 'required', null, 'client'); + $mform->addRule('name', get_string('maximumchars', '', 255), 'maxlength', 255, 'client'); + $mform->addHelpButton('name', 'timetablename', 'mod_timetable'); + + // Adding the standard "intro" and "introformat" fields. + if ($CFG->branch >= 29) { + $this->standard_intro_elements(); + } else { + $this->add_intro_editor(); + } + + // Adding the rest of mod_timetable settings, spreading all them into this fieldset + // ... or adding more fieldsets ('header' elements) if needed for better logic. + $mform->addElement('static', 'label1', 'timetablesettings', get_string('timetablesettings', 'mod_timetable')); + $mform->addElement('header', 'timetablefieldset', get_string('timetablefieldset', 'mod_timetable')); + + // Add standard elements. + $this->standard_coursemodule_elements(); + + // Add standard buttons. + $this->add_action_buttons(); + } +} diff --git a/settings.php b/settings.php new file mode 100644 index 0000000..9d2e887 --- /dev/null +++ b/settings.php @@ -0,0 +1,66 @@ +. + +/** + * Plugin administration pages are defined here. + * + * @package mod_timetable + * @category admin + * @copyright 2020 Raphael Dannecker + * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +defined('MOODLE_INTERNAL') || die(); + +if ($ADMIN->fulltree) { + // TODO: Define the plugin settings page. + // https://docs.moodle.org/dev/Admin_settings +} + +$settings->add(new admin_setting_configcheckbox('timetable/saturday', + get_string('labelsaturday', 'mod_timetable'), + get_string('descsaturday', 'mod_timetable'), + '0')); + +$settings->add(new admin_setting_configtext('timetable/fname_lesson', + get_string('labelfnamelesson', 'mod_timetable'), + get_string('descfnamelesson', 'mod_timetable'), + '')); + +$settings->add(new admin_setting_configtext('timetable/fname_substitution', + get_string('labelfnamesubst', 'mod_timetable'), + get_string('descfnamesubst', 'mod_timetable'), + '')); + +$settings->add(new admin_setting_configtext('timetable/fname_teacher', + get_string('labelfnameteacher', 'mod_timetable'), + get_string('descfnameteacher', 'mod_timetable'), + '')); + +$settings->add(new admin_setting_configtext('timetable/fname_class', + get_string('labelfnameclass', 'mod_timetable'), + get_string('descfnameclass', 'mod_timetable'), + '')); + +$settings->add(new admin_setting_configtext('timetable/fname_room', + get_string('labelfnameroom', 'mod_timetable'), + get_string('descfnamesroom', 'mod_timetable'), + '')); + +$settings->add(new admin_setting_configtext('timetable/numperiod', + get_string('labelnumperiod', 'mod_timetable'), + get_string('descnumperiod', 'mod_timetable'), + 12, PARAM_INT)); diff --git a/templates/searchform.mustache b/templates/searchform.mustache new file mode 100644 index 0000000..e072ca7 --- /dev/null +++ b/templates/searchform.mustache @@ -0,0 +1,7 @@ +
+ Suche Stundenplan: +
+
+
+
+
diff --git a/templates/searchresult.mustache b/templates/searchresult.mustache new file mode 100644 index 0000000..4b270a0 --- /dev/null +++ b/templates/searchresult.mustache @@ -0,0 +1,50 @@ +
+ +{{^searchresults}}Keine Treffer{{/searchresults}} +
+{{# js }} +require([ + 'jquery','core/ajax','core/templates', 'core/notification' + ] , function($, ajax, templates, notification) { + + + function load_timetable(type, name, add) { + //alert(searchstring); + var promises = ajax.call([ + { methodname: 'mod_timetable_get', args: { type: type, name: name, week: 0 } }, + ]); + + if (add=='1') { + promises[0].done(function(response) { + console.log('mod_timetable/get is' + response); + templates.render('mod_timetable/timetable',response).done(function(html, js) { + $('.timetable').last().after(html); + templates.runTemplateJS(js); + }).fail(notification.exception); + }).fail(function(ex) { + // do something with the exception + }); + } else { + promises[0].done(function(response) { + console.log('mod_timetable/get is' + response); + templates.render('mod_timetable/timetable',response).done(function(html, js) { + $('.timetable').first().replaceWith(html); + templates.runTemplateJS(js); + }).fail(notification.exception); + }).fail(function(ex) { + // do something with the exception + }); + } + + } + + + $(".searchresults").click(function() { + load_timetable($(event.target).data('type'),$(event.target).data('name'),$(event.target).data('add')); + }); +}); +{{/ js }} diff --git a/templates/timetable.mustache b/templates/timetable.mustache new file mode 100644 index 0000000..f46103b --- /dev/null +++ b/templates/timetable.mustache @@ -0,0 +1,86 @@ +
+
+{{description}} +x +
+
+ + + + + + + + + +{{#saturday}} + +{{/saturday}} + +{{#periods}} + + +{{#days}} + +{{/days}} + +{{/periods}} +
+
+ ◄ + {{date}} + ► +
+
MoDiMiDoFrSamstag
{{number}} +{{#lessons}} +{{#status}} +
+
---
+
+{{/status}} +{{^status}} +
+
{{subject}}
+
{{class}}
+
{{teacher}}
+
{{room}}
+
+{{/status}} +{{/lessons}} +
+
+
+{{# js }} +require([ + 'jquery','core/ajax','core/templates', 'core/notification' + ] , function($, ajax, templates, notification) { + + + function load_timetable(type, name, week, id) { + //alert($("#"+id)); + //alert("type: "+type); + //alert("Week: "+week); + var promises = ajax.call([ + { methodname: 'mod_timetable_get', args: { type: type, name: name, week: week } }, + ]); + + promises[0].done(function(response) { + console.log('mod_timetable/get is' + response); + templates.render('mod_timetable/timetable',response).done(function(html, js) { + $("#"+id).replaceWith(html); + templates.runTemplateJS(js); + }).fail(notification.exception); + }).fail(function(ex) { + // do something with the exception + }); + } + + //alert("Hi, this is a test"); + $(".nextweek").click(function() { + load_timetable($(event.target).data('type'), $(event.target).data('name'), $(event.target).data('week'), $(event.target).data('id')); //.parentNode.parentNode.parentNode.parentNode); + }); + $(".prevweek").click(function() { + load_timetable($(event.target).data('type'), $(event.target).data('name'), $(event.target).data('week'), $(event.target).data('id')); //.parentNode.parentNode.parentNode); + }); +}); +{{/ js }} diff --git a/version.php b/version.php new file mode 100644 index 0000000..d801dcc --- /dev/null +++ b/version.php @@ -0,0 +1,31 @@ +. + +/** + * Plugin version and other meta-data are defined here. + * + * @package mod_timetable + * @copyright 2020 Raphael Dannecker + * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +defined('MOODLE_INTERNAL') || die(); + +$plugin->component = 'mod_timetable'; +$plugin->release = '0.1.0'; +$plugin->version = 2020083003; +$plugin->requires = 2020061500; +$plugin->maturity = MATURITY_ALPHA; diff --git a/view.php b/view.php new file mode 100644 index 0000000..042cdab --- /dev/null +++ b/view.php @@ -0,0 +1,84 @@ +. + +/** + * Prints an instance of mod_timetable. + * + * @package mod_timetable + * @copyright 2020 Raphael Dannecker + * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later + */ + +require(__DIR__.'/../../config.php'); +require_once(__DIR__.'/lib.php'); + +//use mod_timetable\timetable; + + +// Course_module ID, or +$id = optional_param('id', 0, PARAM_INT); + +// ... module instance id. +$t = optional_param('t', 0, PARAM_INT); + +if ($id) { + $cm = get_coursemodule_from_id('timetable', $id, 0, false, MUST_EXIST); + $course = $DB->get_record('course', array('id' => $cm->course), '*', MUST_EXIST); + $moduleinstance = $DB->get_record('timetable', array('id' => $cm->instance), '*', MUST_EXIST); +} else if ($t) { + $moduleinstance = $DB->get_record('timetable', array('id' => $n), '*', MUST_EXIST); + $course = $DB->get_record('course', array('id' => $moduleinstance->course), '*', MUST_EXIST); + $cm = get_coursemodule_from_instance('timetable', $moduleinstance->id, $course->id, false, MUST_EXIST); +} else { + print_error(get_string('missingidandcmid', 'mod_timetable')); +} + +require_login($course, true, $cm); + +$modulecontext = context_module::instance($cm->id); + +/* +$event = \mod_timetable\event\course_module_viewed::create(array( + 'objectid' => $moduleinstance->id, + 'context' => $modulecontext +)); +$event->add_record_snapshot('course', $course); +$event->add_record_snapshot('timetable', $moduleinstance); +$event->trigger(); + */ + +$PAGE->set_url('/mod/timetable/view.php', array('id' => $cm->id)); +$PAGE->set_title(format_string($moduleinstance->name)); +$PAGE->set_heading(format_string($course->fullname)); +$PAGE->set_context($modulecontext); +//$PAGE->requires->jquery(); +//$PAGE->requires->js_call_amd('mod_timetable/search', 'initialise', $params); +$PAGE->requires->js_call_amd('mod_timetable/search', 'initialize'); + +$output = $PAGE->get_renderer('mod_timetable'); +echo $output->header(); + +//echo "
Test
"; +$renderable = new \mod_timetable\output\searchform('Some text'); +echo $output->render($renderable); + +/*$ttable = new \mod_timetable\timetable('teacher','Da'); + +$ttable->read_db(0); +$renderable = new \mod_timetable\output\timetable($ttable); +echo $output->render($renderable);*/ + +echo $output->footer();