1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/flohmarkt_ynh.git synced 2024-09-03 18:36:30 +02:00
integration of flohmarkt - a federated decentral classified ad software using activitypub - into yunohost
Find a file
2024-05-10 09:26:28 +00:00
conf improvements to upgrade 2024-05-10 09:15:22 +02:00
doc restore DISCLAIMER 2024-05-10 11:24:58 +02:00
scripts Merge branch 'testing' of https://github.com/YunoHost-Apps/flohmarkt_ynh into testing 2024-05-10 11:17:19 +02:00
static more formalities 2024-04-18 15:05:33 +02:00
ALL_README.md READMEs, screenshot smaller 2024-04-18 17:21:33 +02:00
LICENSE more formalities 2024-04-18 15:05:33 +02:00
logger.json test 2024-04-27 13:20:41 +02:00
manifest.toml increased ynh4 to ynh5 2024-05-09 13:59:24 +02:00
README.md Auto-update READMEs 2024-05-10 09:26:28 +00:00
README_eu.md Auto-update READMEs 2024-05-10 09:26:28 +00:00
README_fr.md Auto-update READMEs 2024-05-10 09:26:28 +00:00
README_gl.md Auto-update READMEs 2024-05-10 09:26:28 +00:00
README_zh_Hans.md Auto-update READMEs 2024-05-10 09:26:28 +00:00
run-uvicorn.example test 2024-04-27 13:20:41 +02:00
tests.toml Upgrade paths/filename part III 2024-05-08 11:18:05 +02:00

flohmarkt for YunoHost

Integration level Working status Maintenance status

Install flohmarkt with YunoHost

Read this README in other languages.

This package allows you to install flohmarkt quickly and simply on a YunoHost server.
If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

A decentral federated small advertisement platform

flohmarkt provides its own http server that can be used stand-alone to show small ads that registered users may publish.

Registration works through the server itself and can be switched off (to run a server for e.g. only one person or only the persons that had been registered until that moment).

To register it's necessary to provide an email address to which a confirmation link is send.

Registered users can access a simple form to publish there small ads. The small ads can be looked at by anybody who is able to reach the website.

Federation

To communicate with someone who published a small ad the server hints to an unregistred user "To answer this offer please log in or create an account. OR use another fediverse-account".

The small add visited turns out to be a note in the fediverse. It's url can be opened with your favourite fediverse client at the server you're already registered to. You then can boost the small ad like any other note you read.

Or you can use your account to answer the author of the small ad if - and only if - you mark your note as 'private' aka 'direct'. This way you can contact the person.

It's also possible to follow accounts on flohmarkt servers like any other account in the fediverse to get new small ads published by that account in your timeline.

Federation between flohmarkts

At time of installation the software asks for the coordinates of the community it should be for and the radius it should be used in.

This is an offer to help make the goods that might be offered travel less far. A flohmarkt can manually federate with other flohmarkts in its range showing all their goods on its page.

This is not ment to be a restriction, but a nudging to build local communities. These would have the advantage that people could trust each other more, because trades face-to-face could be more common.

More information

Generally the wiki is a good source of information.

Shipped version: 0.0~ynh5

Demo: https://flohmarkt.ween.de/

Screenshots

Screenshot of flohmarkt

Disclaimers / important information

support

For questions about running flohmarkt on yunohost please use the yunohost support matrix channel or the forum.

To get help for flohmarkt itself please look at its wiki, open an issue with your request or join the IRC channel flohmarkt on libera.chat.

bugs, requesting features

Please use the issue tracker at https://codeberg.org/flohmarkt/flohmarkt_ynh/issues

upstream repository

The yunohost integration of flohmarkt is developed by the flohmarkt organization on https://codeberg.org/ .

Please refer to https://codeberg.org/flohmarkt/flohmarkt_ynh/ to take part in development.

More about development of flohmarkts yunohost integration can be found in DEVELOPMENT.md

🔴 Antifeatures

  • Alpha software: Early development stage. May contain changing or unstable features, bugs, and security vulnerability.
  • Arbitrary limitations: Features arbitrary limitations. Please refer to the README.

Documentation and resources

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that:

sudo yunohost app install https://github.com/YunoHost-Apps/flohmarkt_ynh/tree/testing --debug
or
sudo yunohost app upgrade flohmarkt -u https://github.com/YunoHost-Apps/flohmarkt_ynh/tree/testing --debug

More info regarding app packaging: https://yunohost.org/packaging_apps