umbraco contentment

Contentement pour Umbraco

Contentement / kənˈtɛntm (ə) nt / - un état de bonheur et de satisfaction

Important

Si vous recherchez du contentement pour Umbraco 14 (Bellissima, le nouveau backoffice), veuillez consulter les dernières mises à jour de progrès!

Qu'est-ce que c'est?

Il s'agit d'une collection de composants Umbraco que j'ai développés pour une utilisation sur mes propres projets d'implémentation Umbraco .

Certains composants peuvent être innovants, d'autres peuvent être une réinvention des composants, des éditeurs de propriété, des fonctionnalités et d'autres forfaits communautaires existants.

Pourquoi devrais-je l'utiliser?

Je partage mon code avec le monde. C'est votre choix (et votre responsabilité) si vous souhaitez l'utiliser. Aucune pression ou marketing me tourne.

Veuillez garder à l'esprit que le contentement pour le package Umbraco n'est pas une entreprise, c'est un projet de passe-temps.

Qu'est-ce qui est proposé?

Jetons un coup d'œil à l'intérieur ...

Éditeurs de propriétés

• Bytes - une étiquette en lecture seule pour afficher les tailles de fichiers dans des octets relatifs.
• Éditeur de code - Un éditeur d'exnippet de code, (en utilisant la bibliothèque ACE qui est regroupée avec Umbraco).
• Blocs de contenu - un éditeur de blocs, configurable à l'aide de types d'éléments.
• Liste de données - un éditeur qui combine une source de données personnalisée avec un éditeur de liste personnalisé.
• Picker de données - Advanced Picker Editor pour interroger une source de données personnalisée.
• Remarques de l'éditeur - Similaire aux notes, avec des options d'interface utilisateur améliorées.
• Picker icône - un éditeur pour sélectionner une icône (dans la bibliothèque d'icônes Umbraco).
• Éléments de liste - un éditeur pour gérer les éléments avec un nom, une valeur, une icône et une description.
• Remarques - Une étiquette en lecture seule pour afficher des messages pédagogiques en texte riche pour les éditeurs de contenu.
• Entrée du numéro - Un éditeur numérique, avec des configurations de dimensionnement.
• Render la macro - une étiquette en lecture seule générée dynamiquement à partir d'une macro Umbraco.
• Liens sociaux - un éditeur pour gérer les liens pour les plateformes de réseaux sociaux.
• Étiquette des modèles - une étiquette d'affichage, idéale pour afficher les données des systèmes de 3e partie.
• Liste de la zone de texte - un éditeur multi-textString, ajoute une zone de texte pour chaque élément d'une source de données personnalisée.
• Entrée de texte - Un éditeur de texte, configurable avec des options HTML5.

Télémétrie

Informations sur la fonction de télémétrie.

Sorties

Les téléchargements sont disponibles sur la page des versions.

Installation

Veuillez noter...

• V5.x prend en charge ** Umbraco v13.2.0 ** (sur .net 8.0), il fonctionnera sur les dernières versions Umbraco V13.x.
• V4.x prend en charge Umbraco V8.17.0 (.NET 4.7.2), Umbraco V10 (.NET 6.0), Umbraco V12 (.NET 7.0) et Umbraco V13 (.NET 8.0), il fonctionne surtout sur V9 et V11.
• V3.x prend en charge Umbraco V8.17.0 et Umbraco V9.0.0 , il fonctionnera sur les dernières versions Umbraco V8.x et V9.x.
• V2.x prend en charge Umbraco V8.14.0 , il fonctionnera toujours sur les dernières versions Umbraco V8.x.
• V1.x prend en charge Umbraco V8.6.1 , il fonctionnera toujours sur les dernières versions Umbraco v8.x.

Avec Contentment v5, si vous avez besoin de support pour Umbraco V8 / V9 / V10 / V11 / V12, veuillez utiliser le contentement V4.

Pour mieux comprendre les versions CMS Umbraco sont activement soutenues par le siège d'Umbraco, veuillez consulter la politique de soutien à long terme (LTS) à long terme d'Umbraco et la politique de fin de vie (EOL).

Référentiel de packages NuGet

Pour installer à partir de Nuget, vous pouvez exécuter la commande suivante à partir de la CLI dotnet :

 dotnet add package Umbraco.Community.Contentment

Veuillez noter que le package Umbraco.Community.Contentment NuGet est le package principal des versions en cours. Si vous faites référence à l'un des anciens packages NuGet, par exemple Our.Umbraco.Community.Contentment ou Our.Umbraco.Community.Contentment.Core , veuillez mettre à jour vos références de package à user Umbraco.Community.Contentment .

Documentation

La documentation pour chacun des composants - avec des captures d'écran, des cas d'utilisation et des exemples de code - peut être trouvée dans le dossier /docs .

Veuillez noter que vous pouvez trouver d'autres composants dans le contentement qui n'ont pas encore été documentés.
Appelons ces «petites surprises de la vie».

Problèmes connus

• Liste de données
  • Lorsque vous utilisez la source de données de contenu Umbraco avec une requête XPATH, à l'intérieur d'un contenu imbriqué ou des éditeurs de liste de blocs, il ne pourra pas identifier l'ID de nœud contenant contextuel. Par exemple, votre requête XPath ne fonctionnera pas. Voir # 30 pour plus de détails.
  • Lorsque vous utilisez la source de données de contenu Umbraco avec une requête XPath qui contient un paramètre de préfixe $ , l'aperçu n'affichera pas les éléments. Voir # 120 pour plus de détails.

Feuille de route

Si vous souhaitez savoir ce qui se passe dans les futures versions, jetez un œil à la feuille de route.

Soutien

Je vais essayer d'aider le meilleur possible, mais je fais de l'open source depuis longtemps, et j'ai subi ma juste part d'épuisement professionnel et de fatigue de l'empathie.

Je me réserve le droit d'aborder les rapports de bogues ou les demandes de fonctionnalités à mon propre temps , ou de les ignorer complètement.

Tous les commentaires sont les bienvenus et appréciés. Veuillez garder à l'esprit que je ne suis pas votre développeur de soutien personnel.

Si vous êtes vraiment coincé, rappelez-vous que la communauté Umbraco est parmi les plus amicales de notre planète, apprenez à l'embrasser. Demandez de l'aide sur notre forum de support Umbraco ou sur le serveur Discord Community, je suis sûr que quelqu'un peut vous aider là-bas.

Contributions, collaborations, règles d'engagement

Si vous souhaitez contribuer à ce projet, veuillez commencer une discussion avant de passer du temps et de l'énergie sur une demande de traction. Votre temps est précieux.

Veuillez vous assurer que vous lisez les directives contributives.

Ce projet est régi par un code de conduite. Jouez bien ou allez ailleurs. ✌️❤️? ️

Si vous n'êtes pas satisfait du projet ou de la documentation, veuillez aider à identifier des problèmes spécifiques et à travailler pour les résoudre. Sinon, vous êtes entièrement libre de ne pas utiliser ce logiciel, de vous plaindre de votre réseau social préféré ou d'aller crier dans le vide.

Des comportements inacceptables envers moi-même (ou contributeurs) peuvent entraîner l'emploi d'accès à ce référentiel.

Licence

Copyright © Lee Kelleher.

Tout le code source est autorisé en vertu de la licence publique de Mozilla.

Une note sur les licences

Historiquement, j'ai utilisé la licence du MIT pour mes projets open source, avec regret que je ne pense plus que le MIT reflète mon esprit d'encourager la collaboration open source. La principale différence avec la licence publique de Mozilla est que si vous apportez des modifications au code source et distribuez ces modifications, vous devez effectuer ces modifications publiquement disponibles.

Plus donne, moins de prise.

Si vous n'avez pas l'intention de modifier le code source, vous aurez toujours les mêmes libertés que lorsque vous utilisez la licence MIT.

Pour plus d'informations sur la licence publique de Mozilla , veuillez visiter: https://www.mozilla.org/en-us/mp/2.0/faq/

Remerciements

Développeurs

• Lee Kelleher - (Github, Mastodon)

Effort de développement actuel: ~ 1 840 + heures (entre 2019-03-13 à 2024-04-19)

Pour vous donner une idée de la quantité de temps / effort des développeurs humains qui a été consacré à la fabrication et à la maintenance de ce package.

Merci spécial

• Merci à Umbrella d'avoir facilité le temps et les ressources pour m'aider à initier ce projet.
• Félicitations à Gibe pour avoir permis le développement de l'éditeur de sélecteur de données.

Logo

Le logo du package utilise l'icône Happy (par Nick Bluth) du projet Noun, sous licence CC par 3.0 US.

Icônes

L'éditeur de liens sociaux utilise des icônes de médias sociaux à partir de la bibliothèque impressionnante de Font (en tant que fichiers SVG téléchargés). Ceux-ci sont autorisés en vertu de l'accord de licence gratuite de Font Awesome, en particulier dans le cadre de la licence CC BY 4.0.