|
|
### Como contribuir ao Moodle da USP?
|
|
|
A USP oferece espaços online em apoio às suas disciplinas em https://edisciplinas.usp.br (antigo Stoa) por meio de software chamado [Moodle](https://moodle.org). A equipe Moodle da USP mantem uma versão customizada do software (em particular o tema visual e a integração com os sistemas de matriculas da USP, Júpiter e Janus). Como em qualquer software livre, é possível baixar o código, ver como funciona, fazer modificações e sugerir melhorias.
|
|
|
|
|
|
Em resumo, o processo é
|
|
|
1. Entrar no https://git.uspdigital.usp.br/ com sua Senha Única da USP
|
|
|
2. Fazer um fork do [repositório moodle](https://git.uspdigital.usp.br/stoa/moodle)
|
|
|
3. Baixar o código para sua máquina local
|
|
|
4. [Instalar Moodle[(http://docs.moodle.org/en/Installing_Moodle) localmente
|
|
|
5. hack hack hack, fazendo suas modificações.
|
|
|
6. Comittar, git push e fazer merge request.
|
|
|
|
|
|
#### Conta no gitlab da USP
|
|
|
Se esqueceu sua Senha Única da USP, entre em https://id.usp.br/ e recupere-a. Após se logar, acesse https://git.uspdigital.usp.br/stoa/moodle e faça um fork. Não vai adiantar fazer clone deste repositório, porque não vai ter permissão de fazer git push. Ao vez disso, trabalha no seu próprio repositório e faz um merge request.
|
|
|
|
|
|
#### Clonar repo localmente
|
|
|
Uma vez que tem um fork do repo no seu próprio espaço, deve clonar (baixar) o repositório na sua máquina de desenvolvimento. Usaria o seguinte comando que somente baixa o branch 'edisc' (o branch da Moodle da USP, existem outros branches no repositório para outros Moodles da USP):
|
|
|
|
|
|
```bash
|
|
|
ewout@riobaldo:~$ git clone -b edisc --single-branch git@git.uspdigital.usp.br:suaconta/moodle.git edisc
|
|
|
Cloning into 'edisc'...
|
|
|
remote: Counting objects: 883763, done.
|
|
|
remote: Compressing objects: 100% (240997/240997), done.
|
|
|
remote: Total 883763 (delta 623906), reused 876009 (delta 616528)
|
|
|
Receiving objects: 100% (883763/883763), 493.22 MiB | 5.49 MiB/s, done.
|
|
|
Resolving deltas: 100% (623906/623906), done.
|
|
|
Checking connectivity... done.
|
|
|
Checking out files: 100% (23061/23061), done.
|
|
|
ewout@riobaldo:~$ cd edisc/
|
|
|
ewout@riobaldo:~/edisc$ git branch -a
|
|
|
* edisc
|
|
|
remotes/origin/edisc
|
|
|
```
|
|
|
|
|
|
#### Instalar versão local do Moodle
|
|
|
Moodle é software PHP e fácil de instalar. Instale Apache, Mysql e PHP e os pacotes {php5|php7.0}-{mysql,curl,zip,gd,mbstring,intl}. Crei um symlink /var/www/html/edisc->repo e acesse http://localhost/edisc, siga as instruções.
|
|
|
|
|
|
* Dica: coloque `$CFG->alternateloginurl = 'http://localhost/edisc/acessar';` no config.php.
|
|
|
* Dica: vá para http://localhost/edisc/admin/settings.php?section=themesettings (Administração / Appearance / Themes / Theme settings e coloque pelo menos uma linha no item `custommenuitems`, por exemplo Moodle community|https://moodle.org
|
|
|
|
|
|
#### Merge request
|
|
|
Após testar suas modificações e ter feito `git push` para seu repo, entre novamente no Gitlab da USP e faça um merge request: https://git.uspdigital.usp.br/suaconta/moodle/merge_requests/new (ou seja, na *sua* conta.) |
|
|
\ No newline at end of file |