scoutnet/sh-scoutnet-webservice

Tuesday, April 3, 2018
by sHorst
Repository
7 Watchers
0 Stars
80 Installations

PHP
1 Dependents
0 Suggesters
0 Forks
0 Open issues
13 Versions
0 % Grown

The README.md

, _(*1)

ScoutNet Webservice

This Typo3 plugin is intended for the ScoutNet.de JSON RPC Api., _(*2)

You need to register an account at ScoutNet.de and request an API key for your site. To do so please send an email to scoutnetconnect@scoutnet.de, _(*3)

Installation

To install You can either use the version from the TER, or install this git repo to, _(*4)

/typo3conf/ext/sh_scoutnet_webservice, _(*5)

alternatively you can use composer:, _(*6)

composer require scoutnet/sh-scoutnet-webservice, _(*7)

Setup

You need to activate The Plugin and set the AES Key/IV and the correct provider name. You can find this Informations in the rights configuration of your Group., _(*8)

https://www.scoutnet.de/community/rechte/rechte-verwalten.html, _(*9)

Development

If you want to contribute, feel free to do so. The Repo is located here:, _(*10)

https://github.com/scoutnet/plugins.typo3.sh_scoutnet_webservice, _(*11)

just run make init, _(*12)

Testing

Needed: GnuMake, PHP, Docker and docker-compose, _(*13)

Init:, _(*14)

make init, _(*15)

To Run all the Tests call:, _(*16)

make test, _(*17)

you can use the -phpx suffix to indicate which php version you want to check e.g. make test-php81, _(*18)

for only testing a special function or php version there are different suffixes. For Example:, _(*19)

make lintTest-php81
make unitTest-php83
make unitTest Will call Unit tests with php 8.1 through php 8.3

For running only certain tests use:, _(*20)

TEST_FILE=$(pwd)/Tests/Functional/Plugins/WebringPluginTest.php EXTRA_TEST_OPTIONS='--filter testRedirect' make functionalTest-php83

Testing with PhpStorm: Setup new remote PHP interpreter. Docker-Compose: - compose file: Tests/Build/docker-compose.yml - service: functional_mariadb, _(*21)

Set up new Test Framework: - path to phpunit: bin/phpunit - default config: vendor/typo3/testing-framework/Resources/Core/Build/UnitTests.xml - add path mappings: <abs. Path to this dir> -> <abs. Path to this dir> (all paths mapped like on your host), _(*22)

Set up new Run Configuration for Unit Tests: - Test Scope: <abs. Path to this dir>/Tests/Unit - Custom Working Directory: <abs. Path to this dir>/.Build/ - Test Runner options: --coverage-filter <abs. Path to this dir>/Classes, _(*23)

Set up new Run Configuration for Functional Tests: - Test Scope: <abs. Path to this dir>/Tests/Functional - Custom Working Directory: <abs. Path to this dir>/.Build/ - Use alternative configuration File: <aps. Path to this dir>/.Build/vendor/typo3/testing-framework/Resources/Core/Build/FunctionalTests.xml - Test Runner options: --coverage-filter <abs. Path to this dir>/Classes - Environment variables: typo3DatabaseUsername=root;typo3DatabasePassword=funcp;typo3DatabaseHost=mariadb10;typo3DatabaseName=func_test, _(*24)

Happy Testing, _(*25)

Without docker:

CGL Test: .Build/bin/php-cs-fixer fix -v --dry-run --diff --config=.Build/vendor/typo3/coding-standards/templates/extension _php-cs-fixer.dist.php --using-cache=no Classes/ Resources/ Tests/, _(*26)

Unit Test: .Build/bin/phpunit -c .Build/vendor/typo3/testing-framework/Resources/Core/Build/UnitTests.xml Tests/Unit, _(*27)

Update

1.x->3.0

If you update from a Version < 2.0 please note that the plugin got completely rewritten. It is now based on Extbase. Therefore the complete api changed. With Extbase you can include the webservice by dependency injection. Some of the APIs are changed as well., _(*28)

3.x->4.0

With the update there are a lot of Breaking changes. The Structures were renamed to use english names as well as use proper writing., _(*29)

In Detail:, _(*30)

Categorie -> Category
Stufe -> Section

With this the Repositorys are changed as well. The Section now knows about the Category Object and does not only store the CategoryID., _(*31)

UserRepository->findByUid was renamed to findByUsername (since this is what it does), _(*32)

4.x->5.0

TBD, _(*33)

5.x->6.0

TBD, _(*34)

Author

If you have any questions regarding this software, you can send me an email to muetze@scoutnet.de, _(*35)

TODO

License

This script 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., _(*37)

This copyright notice MUST APPEAR in all copies of the script!, _(*38)