umbraco contentment

Contentamento para Umbraco

contentamento / kənˈtɛntm (ə) nt / - um estado de felicidade e satisfação

Importante

Se você está procurando contentamento para o Umbraco 14 (Bellissima, o novo backoffice), consulte as últimas atualizações de progresso!

O que é?

Esta é uma coleção de componentes Umbraco que desenvolvi para uso em meus próprios projetos de implementação da Umbraco .

Alguns componentes podem ser inovadores, outros podem ser uma reimaginação de componentes, editores de propriedades, recursos e outros pacotes comunitários existentes.

Por que devo usá -lo?

Estou compartilhando meu código com o mundo. É sua escolha (e responsabilidade), quer você queira usá -la. Sem pressão ou marketing girando de mim.

Lembre -se de que o conteúdo do pacote Umbraco não é um negócio, é um projeto de hobby.

O que está em oferta?

Vamos dar uma olhada dentro ...

Editores de propriedades

• Bytes - uma etiqueta somente leitura para exibir tamanhos de arquivo em bytes relativos.
• Editor de código - um editor de snippet de código (usando a biblioteca ACE que é agrupada com umbraco).
• Blocos de conteúdo - um editor de bloco, configurável usando tipos de elementos.
• Lista de dados - um editor que combina uma fonte de dados personalizada com um editor de lista personalizado.
• Picker de dados - Editor avançado de seleção para consultar uma fonte de dados personalizada.
• Notas do editor - semelhante às notas, com opções aprimoradas da interface do usuário.
• Picker de ícone - um editor para selecionar um ícone (na biblioteca Ícone Umbraco).
• Listar itens - um editor para gerenciar itens com um nome, valor, ícone e descrição.
• Notas-Um rótulo somente leitura para exibir mensagens instrucionais de texto rico para editores de conteúdo.
• Entrada do número - um editor numérico, com configurações de dimensionamento.
• Render Macro - Uma etiqueta somente leitura gerada dinamicamente a partir de uma macro Umbraco.
• Links sociais - um editor para gerenciar links para plataformas de redes sociais.
• Rótulo modelado - um rótulo de exibição, ideal para mostrar dados de sistemas de terceiros.
• Lista de caixas de texto - um editor de múltiplas textos, adiciona uma caixa de texto para cada item em uma fonte de dados personalizada.
• Entrada de texto - um editor de texto de texto, configurável com opções HTML5.

Telemetria

Informações sobre o recurso de telemetria.

Liberações

Downloads estão disponíveis na página de lançamentos.

Instalação

Observe...

• V5.x suporta ** Umbraco v13.2.0 ** (ON .NET 8.0), ele funcionará nas mais recentes liberações de Umbraco v13.x.
• V4.x suporta Umbraco v8.17.0 (.NET 4.7.2), Umbraco V10 (.NET 6.0), Umbraco v12 (.NET 7.0) e Umbraco v13 (.NET 8.0), provavelmente também funciona em V9 e V11.
• O v3.x suporta Umbraco v8.17.0 e Umbraco v9.0.0 , ele funcionará nas últimas liberações de Umbraco V8.x e V9.x.
• V2.x suporta Umbraco v8.14.0 , ele ainda funcionará nas últimas versões do Umbraco V8.x.
• V1.x suporta Umbraco v8.6.1 , ele ainda funcionará nas últimas versões do Umbraco V8.x.

Com o contentamento v5, se você precisar de suporte para Umbraco V8/V9/V10/V11/V12, use o conteúdo v4.

Para entender mais sobre quais versões Umbraco CMS são ativamente apoiadas pela HQ Umbraco, consulte a política de apoio a longo prazo da Umbraco (LTS) e Fim of-Life (EOL).

Repositório de pacote NUGET

Para instalar na Nuget, você pode executar o seguinte comando da dotnet CLI:

 dotnet add package Umbraco.Community.Contentment

Observe que o pacote Nuget Umbraco.Community.Contentment Nuget é o principal pacote para lançamentos em andamento. Se você estiver referenciando um dos pacotes NUGET mais antigos, por exemplo, Our.Umbraco.Community.Contentment ou Our.Umbraco.Community.Contentment.Core , atualize as referências do seu pacote para usar Umbraco.Community.Contentment .

Documentação

A documentação para cada um dos componentes - com capturas de tela, casos de uso e exemplos de código - pode ser encontrada na pasta /docs .

Observe que você pode encontrar outros componentes dentro da satisfação que ainda não foram documentados.
Vamos chamar essas "pequenas surpresas da vida".

Questões conhecidas

• Lista de dados
  • Ao usar a fonte de dados de conteúdo de Umbraco com uma consulta XPath, dentro de um conteúdo aninhado ou editores da lista de blocos, ele não poderá identificar o ID do nó contextual contendo contextual. Por exemplo, sua consulta XPath não funcionará. Veja #30 para obter detalhes.
  • Ao usar a fonte de dados de conteúdo de Umbraco com uma consulta XPath que contém um parâmetro $ prefix, a visualização não exibirá os itens. Veja #120 para obter detalhes.

Roteiro

Se você gostaria de saber o que está por vir em lançamentos futuros, dê uma olhada no roteiro.

Apoiar

Vou tentar ajudar o melhor que puder, mas faço o código aberto há muito tempo e sofri meu quinhão de cansaço de esgotamento e empatia.

Reservo o direito de abordar relatórios de bug ou solicitações de recursos no meu próprio tempo ou ignorá -los completamente.

Qualquer feedback é bem -vindo e apreciado. Lembre -se de que não sou seu desenvolvedor de suporte pessoal.

Se você está realmente preso, lembre -se de que a comunidade Umbraco está entre os mais amigáveis ​​do nosso planeta, aprenda a abraçá -lo. Peça ajuda no nosso fórum de suporte ao Umbraco, ou no servidor comunitário Discord, tenho certeza de que alguém pode ajudá -lo lá.

Contribuições, colaborações, regras de engajamento

Se você deseja contribuir para este projeto, inicie uma discussão antes de gastar tempo e energia em uma solicitação de tração. Seu tempo é precioso.

Certifique -se de ler as diretrizes contribuintes.

Este projeto é governado por um código de conduta. Jogue bem ou vá para outro lugar. ✌️❤️? ️

Se você estiver descontente com o projeto ou documentação, ajude a identificar problemas específicos e trabalhar para resolvê -los. Caso contrário, você será totalmente livre para não usar este software, reclamar da sua rede social favorita ou gritar no vazio.

Comportamento inaceitável em relação a mim mesmo (ou colaboradores) pode resultar em ser impedido de acessar este repositório.

Licença

Copyright © Lee Kelleher.

Todo o código -fonte é licenciado sob a licença pública de Mozilla.

Uma nota sobre licenciamento

Historicamente, usei a licença do MIT para meus projetos de código aberto, lamentavelmente não sinto mais o MIT reflete meu espírito de incentivar a colaboração de código aberto. A principal diferença com a licença pública de Mozilla é que, se você fizer alguma modificação no código -fonte e distribuir essas modificações, deverá disponibilizar essas alterações publicamente.

Mais dê, menos tomada.

Se você não pretende modificar o código -fonte, ainda terá as mesmas liberdades ao usar a licença do MIT.

Para mais informações sobre a licença pública de Mozilla , visite: https://www.mozilla.org/en-us/mpl/2.0/faq/

Agradecimentos

Desenvolvedores

• Lee Kelleher - (Github, Mastodon)

Esforço de desenvolvimento atual: ~ 1.840+ horas (entre 2019-03-13 e 2024-04-19)

Para dar uma idéia de quanto tempo/esforço do desenvolvedor humano foi colocado na fabricação e manutenção deste pacote.

Obrigado especial

• Obrigado ao Umbrella por facilitar o tempo e o recurso para me ajudar a iniciar este projeto.
• Parabéns a Gibe por permitir o desenvolvimento do editor de seleção de dados.

Logotipo

O logotipo do pacote usa o ícone Happy (por Nick Bluth) do Projeto Substantivo, licenciado no CC pelo 3.0 US.

Ícones

O Editor de Links Sociais utiliza ícones de mídia social da Biblioteca Awesome da Fonte (como baixados arquivos SVG). Estes são licenciados sob o contrato de licença gratuito incrível da fonte, especificamente sob a licença CC por 4.0.