Fonctionnalité de partage entre les utilisateurs du serveur nextcloud ainsi que sur les réseaux sociaux.
L’application News ne comportait aucune fonctionnalité de partage avant la réalisation de ce projet. Il a été identifié le besoin de partager des articles entre utilisateur, la fonctionnalité présentée ci-dessous répond à ce besoin.
L'interface se présente de la manière suivante :
L'utilisateur peut rechercher à l'aide de la barre de recherche un autre utilisateur pour lequel il veut envoyer un article.
Quand une requête de recherche est en attente de réponse, la recheche passe dans un état de loading (isLoading = true) et informe l'utilisateur que sa requête est en cours de traitement.
Afin d’obtenir les contacts présents sur le serveur avec lesquels nous pouvons partager les articles, il est nécessaire de l'interroger depuis la partie front-end. L’implémentation actuelle de la partie front-end est implémentée en angularJS. Cette technologie est ancienne et n’a pas profité des dernières mises à jour de l’API Nextcloud. Nous avons alors été contraints d’utiliser une forme de l’API obsolète.
Dans la table stockant les différents articles de news, le champ suivant a été ajouté :
shared_by :
stringavec valeur par défautnull. Le champ contient l’id de l’utilisateur ayant réalisé le partage. Ainsi les articles qui ne comportent pas ce champ à null correspond aux articles partagés.
Il a été décidé de réaliser une duplication des articles à la place d’un référencement lors du partage d'un article. Cette solution a été retenue pour que l’utilisateur recevant l’article partagé dispose d’un contrôle total sur ce dernier. Ainsi, si l’utilisateur à l’origine du partage change l’état de l’article (passage à “vu” ou suppression), les modifications ne seront pas répercutées sur l’article qui a été partagé.
Côté back-end, voici l'architecture utilisée :
Le service
ShareServicea entièrement été crée. C'est ce service qui pourra intéragir avec le moduleitemMapperqui communique directement via les modèles avec la tableoc_news_item. Le service comprend la méthode permettant de partager entre les utilisateur :
shareItemWithUser(string $userId, int $itemId, string $shareRecipientId) //Partage d'un article d'un utilisateur à l'autre
Les flux par défaut sont paramétrables uniquement par les administrateurs du serveur Nextcloud depuis la page “paramètres” de l’application news.
Lors de l'ajout d'un flux, celui-ci se retrouve dans le dossier "Flux par défaut". Si le dossier n'existe pas, il est créé.
Démarche pour modifier la liste.
Les flux par défaut sont ajoutés pour un utilisateur lors de sa connexion.
Comme l'indique la documentation Nextcloud, un Event listener a été créé (UserLoggedInListener) afin de détecter la connexion d'un utilisateur. Une fois la connexion détectée (UserLoggedInEvent de Nextcloud), un traitement compare la liste des flux par défaut présents dans le dossier en question de l'utilisateur : si un flux est manquant, il est ajouté.
Il est important de noter que ce traitement prolonge le temps de connexion d'un utilisateur lorsqu'un article par défaut est manquant (quelques secondes pour l'ajout d'un article).
Les flux par défaut sont stockés dans la table des paramètres d'application sous forme de JSON (attributdefaultFeedsdansoc_appconfig).
Pour partager des articles avec des personnes n'étant pas forcément présentes sur le serveur Nextcloud, il a été intégré une fonctionnalitée de partage sur les réseaux sociaux à l'aide de 3 boutons.
- Partage sur Facebook.
- Partage sur Twitter.
- Partage par Mail.
Afin de réaliser une intégration plus forte sur le partage des réseaux sociaux, des hashtags peuvent être ajoutés manuellement ou automatiquement.
Il est important de noter que sur Facebook, pour des raisons de limitations techniques du côté du réseau social, il n'est possible d'importer qu'un seul hashtag.
Comme le montre la capture ci-dessus, Les administrateurs du serveur Nextcloud ont la possibilité d'ajouter des hashtags qui seront proposés par défaut lors d'un partage sur les réseaux sociaux. L'utilisateur choisi lors du partage les hashtags par défaut qu'il a sélectionné.
Démarche pour modifier la liste.
Les hashtags par défaut sont stockés dans la table des paramètres des applications (attribut
customHashtagsdansoc_appconfig).
Il faut nécessairement être administrateur pour modifier cette liste.
Afin de mieux référencer le tweet, les catégories qui ont pu être importées depuis le flux RSS sont importés sur le post. Cela permet d'ajouter des hashtags de manière automatique.
Pour réaliser cette fonctionnalité, les catégories de l'article sont stockées depuis le flux RSS dans la table
oc_news_itemssous un format JSON. Les catégories de chacun des articles sont transmises dans la réponse provenant du serveur lors de l'affichage de ces derniers.
Veuillez consulter ce lien pour obtenir plus d'informations.
Ci-dessous les pulls requests concernée par ce projet :
- ✔️ Share feature / Back-end
- ✔️ Share feature / Front-end
- ✔️ Import catagories
- ❌ Default feeds (Mainteners non intéressés mais fonctionnalité présente dans la version de notre dépôt)