# akora-moodle
> This is a moodle Client for the MoodleAPI that was inspired by the minimalistic moodle-client
Latest version **1.0.4** (published 2021-03-12) · MIT license · 0 weekly downloads
> **Deprecated.** This package is deprecated.
## Install
```sh
npm install akora-moodle
pnpm add akora-moodle
yarn add akora-moodle
bun add akora-moodle
```
## Health
**Score 10/100 (F)** — status: deprecated.
Negative: deprecated.
## Facts
| | |
|---|---|
| Version | 1.0.4 |
| Published | 2021-03-12 |
| First published | 2021-02-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 61.2 KB |
| Known vulnerabilities | 0 (+23 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 8 |
| Maintainers | dragoncat4012, akora-studios |
| Keywords | moodle, akora, typed, typings |
## Links
- npm: https://www.npmjs.com/package/akora-moodle
- Repository: https://github.com/AKORA-Studios/MoodleClient
- Homepage: https://github.com/AKORA-Studios/MoodleClient#readme
- Issues: https://github.com/AKORA-Studios/MoodleClient/issues
- npm.io page: https://npm.io/package/akora-moodle
## Dependencies (2)
- [axios](https://npm.io/package/axios.md) ^0.21.1
- [colors](https://npm.io/package/colors.md) ^1.4.0
## Alternatives
- [localforage](https://npm.io/package/localforage.md) — 6.2M weekly downloads
- [localforage-observable](https://npm.io/package/localforage-observable.md) — 30.8K weekly downloads
- [@y/y](https://npm.io/package/@y/y.md) — 30.1K weekly downloads
- [@metaobjectsdev/render](https://npm.io/package/@metaobjectsdev/render.md) — 3.5K weekly downloads
- [@ledgerhq/coin-algorand](https://npm.io/package/@ledgerhq/coin-algorand.md) — 1.1K weekly downloads
## Recent versions
- 1.0.4 (latest) — 2021-03-12
- 1.0.3 — 2021-02-23
- 1.0.2 — 2021-02-22
- 1.0.1 — 2021-02-22
- 1.0.0 — 2021-02-21
## README
[](https://www.npmjs.com/package/akora-moodle)
[](https://www.npmjs.com/package/akora-moodle)
[](https://www.npmjs.com/package/akora-moodle)
[](https://www.npmjs.com/package/akora-moodle)
# AKORA Moodle Client
This is a simple Client for moodle, that is inspired by the [moodle-client](https://www.npmjs.com/package/moodle-client) by [mudrd8mz](https://www.npmjs.com/~mudrd8mz), it has built in typings and typings for many endpoints of the Moodle API(which are documented [here](https://learn.cineca.it/pluginfile.php/1/theme_adaptable/adaptablemarketingimages/0/api.htm)), the typings will be extended in the future till hopefully one day al endpoints are built in this package.
> The Documentation is also available on [GitBook](https://dragoncatm.gitbook.io/moodle/)
## Why should i use this package?
If you ever read the documentation of the Moodle API, then you know that there are hundrets of methods and if you dont have the right documentation the [docs](https://docs.moodle.org) can be hard to read and understand, you still need the documentation to use this package but it provides you most methods with built in types so that you know what you get back and what you need to supply to the request.
# Getting started
## Installation
```bash
npm install akora-moodle
```
## Creating an instance
To create an instance of the Client, you use the static `init` method of the Client with an object which contains all needed options to initialize the client. The method will return a Promise wich returns a instance of the `Client` class.
Here an example of an basic Login with your username, and password.
> ```js
> const { Client } = require('akora-moodle');
>
> Client.init({
> wwwroot: 'https://moodle.your-school.de/',
> username: 'Bob',
> password: 'SuPeRsecRet'
> })
> ```
You can also log in with a token. (If credentials and token are provided token will be used).
> ```js
> Client.init({
> wwwroot: 'https://moodle.your-school.de/',
> token: 'yourtokengoesbrrrrrr'
> })
> ```
----------
## Built-in Methods
At the moment all implemented methods can be found in the `client.core` property, your IDE will tell you what methods are already implemented and usable, as well as your IDE will tell you what arguments you need to provide and what the response looks like.
Here is a short example which gives you informations about the current logged in user.
> ```js
> const { Client } = require('akora-moodle');
>
> Client.init({
> wwwroot: 'https://moodle.your-school.de/',
> token: 'yourtokengoesbrrrrrr'
> }).then(async (client) => {
> var info = await client.core.getInfo();
>
> console.log('You are Logged in as %s %s', info.firstname, info.lastname)
> }).catch((err) => {
> console.log('Something went wrong ._.', err);
> });
> ```
Here is a short example which returns you an array of course contents.
> ```js
> const { Client } = require('akora-moodle');
>
> client.init({
> wwwroot: 'https://moodle.your-school.de/',
> token: 'yourtokengoesbrrrrrr'
> }).then(async (client) => {
> var contents = await client.core.course.getContents({
> courseid: 3272
> });
>
> console.log('There are %s Sections in this Course', contents.length)
> }).catch((err) => {
> console.log('Something went wrong ._.', err);
> });
> ```
----------
## Custom API Calls
At the moment not even nearly all methods are implemented, so you might often want to use the `client.call` method to make a custom API Requests.
An example
> ```js
> const { Client } = require('akora-moodle');
>
> Client.init({
> wwwroot: 'https://moodle.your-school.de/',
> token: 'yourtokengoesbrrrrrr',
> }).then(async (client) => {
> var response = await client.call({
> wsfunction: 'core_not_implemented_yet',
> method: 'POST',
> args: {
> someid: 123
> }
> //You can also provide settings > for advanced usage
> })
> }).catch((err) => {
> console.log('Something went wrong ._.', err);
> });
> ```
----------
## Advanced Client settings
All custom Settings
> ```js
> const { Client } = require('akora-moodle');
>
> Client.init({
> wwwroot: 'https://moodle.your-school.de/',
> token: 'yourtokengoesbrrrrrr',
> // The web service to use, default is moodle_mobile_app
> service: 'moodle_mobile_app',
> // If set to false, SSL certificates do not need to be valid.
> strictSSL: true,
> // Will enable the built-in Logger
> logger: true
> })
> ```