Minor documentation changes

This commit is contained in:
PMKuipers 2023-08-15 16:26:03 +02:00
parent fcfcc6570b
commit 0a6c0d8dd8
9 changed files with 48 additions and 11968 deletions

View File

@ -1,58 +1,15 @@
# moodle-local_treestudyplan
## Adding links to the primary navigation menu
The studyplan plugin will automatically add links to the flat navigation bat used in Moodle 3.11 and below
However, Moodle 4.0-4.2 use a new "primary navigation" bar, and does not yet support customizing the primary navigation bar (it is a planned feature though)
**Use the following workaround:**
You can add custom primary menu items in **Site administration** -> **Appearance** -> **Theme settings**
That page contains an item called "Custom menu items"
Add the following into that area to custimize it
// [your name for my studyplan]|/local/treestudyplan/myreport.php
// [your name for studyplan viewing]|/local/treestudyplan/view-plan.php
// [your name for studyplan managing]|/local/treestudyplan/edit-plan.php
// For example:
```
Mijn studieplan|/local/treestudyplan/myreport.php||nl
Studieplannen|/local/treestudyplan/view-plan.php||nl
Studieplannen beheren|/local/treestudyplan/edit-plan.php||nl
My study plan|/local/treestudyplan/myreport.php||en
Study plans|/local/treestudyplan/view-plan.php||en
Manage Study plans|/local/treestudyplan/edit-plan.php||en
```
## Dev Notepad
### Size matching and grid view
Link to jsfiddle for size matching with different scroll area (frozen line headings): https://jsfiddle.net/pmkuipers/sfweghr1/4/
Use proper grid styling for column resizing (see same fiddle)
## Installing
Install the plugin by adding the zip file from the
### Scroll bar syling
example style with cross-browser support
```
:root{
--primary: #006DDD;
}
div.scroll {
height: 50em;
overflow-y: scroll;
scrollbar-color: var(--primary) color-mix(in srgb, var(--primary) 20%, white);
scrollbar-width: thin;
}
div.scroll::-webkit-scrollbar {
width: 8px;
}
## Documentation / User manual
After installing the plugin, the user manual can be found under **Site administration** -> **Courses** -> **Studyplans** -> **Studyplan plugin documentation**
Alternatively, you can unpack this ZIP file and open the **doc/index.html** file.
(Note that viewing the html files directly will not five the optimal experience, since fontawesome tags and bootstrap items will not be properly rendered)
## Development
To build a release zip, you can use the script **./build.sh**. This script calls grunt to build the javascript minified files where needed and creates a relase zip file with the current plugin version (as defined in *version.php*) in the directory **/build**
/* Track */
div.scroll::-webkit-scrollbar-track {
background: color-mix(in srgb, var(--primary) 20%, white);
}
/* Handle */
div.scroll::-webkit-scrollbar-thumb {
background:var(--primary);
}
```

11912
amd/build/vue.min.js vendored

File diff suppressed because one or more lines are too long

1
amd/build/vue.min.js.map Normal file

File diff suppressed because one or more lines are too long

View File

@ -1,3 +1,6 @@
<html>
<head></head>
<body>
<div>
<h1> Studyplan user manual</h1>
<ul class="nav nav-tabs">
@ -141,4 +144,6 @@
</div>
</div>
</body>
</html>

View File

@ -1,3 +1,6 @@
<html>
<head></head>
<body>
<div>
<h1> Studyplan user manual</h1>
<ul class="nav nav-tabs">
@ -120,4 +123,6 @@
}</pre>
</div>
</div>
</body>
</html>

View File

@ -1,3 +1,6 @@
<html>
<head></head>
<body>
<div>
<h1> Studyplan user manual</h1>
<ul class="nav nav-tabs">
@ -198,4 +201,6 @@
</div>
</div>
</div>
</body>
</html>

View File

@ -1,3 +1,6 @@
<html>
<head></head>
<body>
<div>
<h1> Studyplan user manual</h1>
<ul class="nav nav-tabs">
@ -41,4 +44,6 @@ Manage Study plans|/local/treestudyplan/edit-plan.php||en
<p><img src="img/Siteconfig.png" class="border border-primary rounded-lg ml-3"></p>
<p>The page <a href="configuration.htm"><b>Configuration</b></a> gives more details about the configuration options</p>
</div>
</div>
</body>
</html>

View File

@ -1,3 +1,6 @@
<html>
<head></head>
<body>
<div>
<h1> Studyplan user manual</h1>
<ul class="nav nav-tabs">
@ -79,4 +82,6 @@
<p>By selecting <button type="button" class="list-group-item list-group-item-primary list-group-item-action">Teacher view</button>, the teacher can
return to the teacher view</p>
</div>
</div>
</body>
</html>

View File

@ -1,3 +1,6 @@
<html>
<head></head>
<body>
<div>
<h1> Studyplan user manual</h1>
<ul class="nav nav-tabs">
@ -113,4 +116,6 @@
the invitee can see the student's study plan, grades and provided feedback.
</p>
<p>Upon deleting the invitation, the unique link is immediately deactivated and all access the invitee had to view the student's studyplan is revoked.</p>
</div>
</div>
</body>
</html>