The idea behind this app is to provide a proper search page to Nextcloud. I know about the on provided by fulltextsearch but wasn't convinced.
Place this app in one of the application folders of your nextcloud server (e.g. nextcloud/apps/).
This application only uses official APIs provided by Nextcloud.
It works as described below (fresh arrival on page):
- User arrives on the application page
- Page fetches list of provider of the Nextcloud instance
- User types a search query
- Page fetches the result of each provider for the given search query
If the URL contains predefined values, the step 3 is not necessary.
The application must not depend on other applications (except the core Nextcloud). This brings the following caveats
- not possible (yet) to fetch more information on results as the existing search API is quite light
- not possible to make specific behaviors for a given provider
The app can be built by using the provided Makefile by running:
make
This requires the following things to be present:
- make
- which
- tar: for building the archive
- curl: used if phpunit and composer are not installed to fetch them from the web
- npm: for building and testing everything JS
This app only provide a controller to serve the main page
First get an account for the App Store then run:
make && make appstore
The archive is located in build/artifacts/appstore and can then be uploaded to the App Store.
You can use the provided Makefile to run all tests by using:
make test
This will run the PHP unit and integration tests and if a package.json is present will execute npm run test
Of course you can also install PHPUnit and use the configurations directly:
phpunit -c phpunit.xml
or:
phpunit -c phpunit.integration.xml
for integration tests