mirror of
https://github.com/MetaProvide/nextcloud-swarm-plugin.git
synced 2025-03-14 16:22:51 +00:00
63221db916
* Improving github and NC app store documentation (#102) * fix(curl): upload SSL verification (#105) - remove: verify parameters to default to curl - add: only in dev env * feat(upload): add filename as meta param when uploading (#103) * Improve settings information (#104) * Improve settings information * feat(settings): add server host URL as default value * style(settings): remove extra wordings --------- Co-authored-by: Mahyar Iranibazaz <mahiarirani@pm.me> * Feature: secure API communication upgrade (#107) * feat(exception): throw separate exceptions * feat(api): separate token from api link - update: merge getLink into a single function - add: Dto for Links results - pass: token in authorization header - update: upload and download to use new api links - refactor: remove extra isVersion input * chore: fix code style --------- Co-authored-by: mahiarirani <10583381+mahiarirani@users.noreply.github.com> * bugfix: exception handling to ensure the response is handled correctly (#109) * bugfix: correct exception handling to ensure the response is handled correclty by calling test() function. - update: do not assume an array (json) response from the api. The response is not always json which cause the json_decode() to return null; - add: use StorageNotAvailableException to ensure a user-friendly error message to be displayed on the front.end; - update: return value can be a string * chore: fix code style * feat(api): check status - update: response based on status code - add: specific error for invalid code * chore: fix code style --------- Co-authored-by: Take one <rontrevor@hotmail.com> Co-authored-by: Mahyar Iranibazaz <mahiarirani@pm.me> Co-authored-by: mahiarirani <10583381+mahiarirani@users.noreply.github.com> * feat(docker): add install ocs api viewer app (#108) * bugfix/correct-install-docker-windows (#106) * - Correction to docker-compose for Windows installations. - Added README for known issues * Update README.md bugfix(correct-install-docker-windows): add supporting images * - add: formatting changes to README.md --------- Co-authored-by: Take one <rontrevor@hotmail.com> * Feature #1192 feedback form js (#111) * Adding Feedback form * Not working yet. Probably need to change strategy and send request to nc first * Feedback js working. Something might be improved: // TODO - Get API Url from beeswarmtrait or another place // TODO - Improve layout with css // TODO - Remove wiget when not is not in swarm folders * chore: fix code style * feat(env): upgrade get - update: return null if key is not found * feat(feedback): add api url - add: app const - add: env example * feat(curl): add post and get methods - update: swarm endpoints to use new methods * feat(feedback): update feedback request * refactor(curl): rename curl to request * feat(curl): add accept headers to getLink - refactor: use get for download instead of exec * style(feedback): improve feedback from ui * style(feedback): improve feedback from ui * feat(feedback): use custom exception * feat(feedback): add status code to exception * feat(feedback): return correct status code * feat(feedback): add feedback js as dependency - remove: manual added js file - add: npm package - update: the code usage --------- Co-authored-by: JoaoSRaposo <1598265+JoaoSRaposo@users.noreply.github.com> Co-authored-by: Mahyar Iranibazaz <mahiarirani@pm.me> * feat(curl): check url for protocol * bugfix(feedback): remove the removed script load * feat(toast): add nextcloud dialogs (#112) - add: library package - update: fileactions.js usage - update: swarm logo remove xml * Fix/#1085 adding moodle to the documentation (#100) * Adding moodle documentation * FIxing link formating error --------- Co-authored-by: JoaoSRaposo <joaosraposo@gmail.com> Co-authored-by: Mahyar Iranibazaz <mahiarirani@pm.me> Co-authored-by: mahiarirani <10583381+mahiarirani@users.noreply.github.com> Co-authored-by: retrevor <75954541+retrevor@users.noreply.github.com> Co-authored-by: Take one <rontrevor@hotmail.com> Co-authored-by: JoaoSRaposo <1598265+JoaoSRaposo@users.noreply.github.com>
97 lines
5.4 KiB
XML
97 lines
5.4 KiB
XML
<?xml version="1.0"?>
|
||
<info xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance"
|
||
xsi:noNamespaceSchemaLocation="https://apps.nextcloud.com/schema/apps/info.xsd">
|
||
<id>files_external_ethswarm</id>
|
||
<name>External Storage: Hejbit Swarm</name>
|
||
<summary>Bring decentralized, sovereign cloud storage to Nextcloud with the Hejbit Swarm plugin!</summary>
|
||
<description>< (a decentralized, blockchain-connected file storage system) directly into your [Nextcloud ](https://nextcloud.com/)instance.
|
||
|
||
## **Table of Contents**
|
||
|
||
- [Dependencies](https://apps.nextcloud.com/apps/files_external_ethswarm#dependencies)
|
||
- [Setup and Installation](https://apps.nextcloud.com/apps/files_external_ethswarm#setup-and-installation)
|
||
- [Usage](https://apps.nextcloud.com/apps/files_external_ethswarm#usage)
|
||
- [Settings](https://apps.nextcloud.com/apps/files_external_ethswarm#settings)
|
||
- [Using Hejbit Swarm](https://apps.nextcloud.com/apps/files_external_ethswarm#using-hejbit-swarm)
|
||
- [Additional Integration with Moodle](https://apps.nextcloud.com/apps/files_external_ethswarm#additional-integration-with-moodle)
|
||
- [Get Hejbit License](https://apps.nextcloud.com/apps/files_external_ethswarm#get-hejbit-license)
|
||
- [License](https://apps.nextcloud.com/apps/files_external_ethswarm#license)
|
||
|
||
[](#dependencies)## **Dependencies**
|
||
|
||
Before using the plugin, ensure you have the following:
|
||
|
||
- An active Nextcloud instance (version 28,29 or 30)
|
||
- A valid license and URL to activate the service
|
||
- [Request Your Free Nextcloud Swarm Plugin Trial License](https://metaprovide.org/hejbit/start)
|
||
|
||
[](#setup-and-installation)## **Setup and Installation**
|
||
|
||
Follow these steps to configure Hejbit Swarm in Nextcloud:
|
||
|
||
1. Ensure the **External Storage** plugin is enabled.
|
||
2. Install the **External Storage: Hejbit Swarm** app from the Nextcloud App Store.
|
||
3. Navigate to External Storage Administration: Profile menu -> Settings -> External Storage.
|
||
4. Create a new external storage with a folder name of your choice and select *'Swarm'* as the storage type. Then, enter the license key and URL configuration.
|
||
|
||
[](#usage)## **Usage**
|
||
|
||
Once installed, Hejbit integrates Swarm directly with Nextcloud’s "Files" section, allowing seamless file operations:
|
||
|
||
- **Upload:** Transfer files to decentralized storage.
|
||
- **Download:** Retrieve and view files from decentralized storage.
|
||
- **Copy/Move:** Shift files between any external storage and decentralized storage
|
||
|
||
[](#settings)### **Settings**
|
||
|
||
Users with administrative credentials can configure the plugin through the standard External Storage settings. Here, you can input your license key and URL for Hejbit.
|
||
|
||
[](#using-hejbit-swarm)### **Using Hejbit Swarm**
|
||
|
||
Once setup and configured, the Decentralized Storage is ready to use.
|
||
|
||
- Access the Decentralized Storage folder under "All Files" or via the "Files" menu under "External Storage."
|
||
- Once uploaded, it can be viewed internally or downloaded. It can also be copied to another storage.
|
||
- Files from another Nextcloud storage can also be copied/moved to the decentralized storage. Choose the decentralized storage folder as the target Folder.
|
||
- Right-click on a Swarm file to copy the Swarm reference (hash) to your clipboard. Alternatively, click the three dots in the Actions menu and select 'Copy Swarm Reference.' The Swarm reference is the unique address of the file on the Swarm network.
|
||
|
||
[](#additional-integration-with-moodle)### Additional Integration with Moodle
|
||
|
||
You can also enhance your experience by integrating the Hejbit Swarm plugin with the **Moodle Nextcloud plugin**. This integration allows users to access decentralized storage directly within the Moodle environment, providing a seamless experience for educational content management. For more information on how to set up this integration, visit the [Moodle Nextcloud repository documentation](https://docs.moodle.org/405/en/Nextcloud_repository).
|
||
|
||
For detailed guidance on using the integrated features, please refer to the [Metaprovide Learning Platform](https://learning.metaprovide.org/login/index.php).
|
||
|
||
[](#get-hejbit-license)## **Get Hejbit Licence**
|
||
|
||
Experience the future of data storage with 5GB of free, decentralized storage on the Ethereum Swarm network. Our plugin seamlessly integrates with your existing Nextcloud interface, providing true data sovereignty without the complexity.
|
||
|
||
[Get your free licence here!](https://metaprovide.org/hejbit/start)
|
||
]]></description>
|
||
<version>0.5.11</version>
|
||
<licence>agpl</licence>
|
||
<author>MetaProvide</author>
|
||
<namespace>Files_External_Ethswarm</namespace>
|
||
<types>
|
||
<filesystem/>
|
||
<dav/>
|
||
</types>
|
||
<category>files</category>
|
||
<category>tools</category>
|
||
<website>https://github.com/MetaProvide/nextcloud-swarm-plugin</website>
|
||
<bugs>https://github.com/MetaProvide/nextcloud-swarm-plugin/issues</bugs>
|
||
<repository type="git">https://github.com/MetaProvide/nextcloud-swarm-plugin.git</repository>
|
||
<screenshot>https://raw.githubusercontent.com/MetaProvide/nextcloud-swarm-plugin/main/assets/images/swarm_Files.png</screenshot>
|
||
<dependencies>
|
||
<nextcloud min-version="28" max-version="30"/>
|
||
</dependencies>
|
||
<sabre>
|
||
<plugins>
|
||
<plugin>OCA\Files_External_Ethswarm\Sabre\PropfindPlugin</plugin>
|
||
<plugin>OCA\Files_External_Ethswarm\Sabre\PostPlugin</plugin>
|
||
</plugins>
|
||
</sabre>
|
||
</info>
|