Listora
Um diretório local moderado: pesquisa, mapa, 10 tipos de fichas, submissões de membros, avaliações, reivindicações e um painel.
Extensão
Listora
Um diretório local moderado: pesquisa, mapa, 10 tipos de fichas, submissões de membros, avaliações, reivindicações e um painel.
Descrição
O Listora transforma um site EmDash num diretório local. Os visitantes pesquisam e exploram fichas num mapa. Os membros adicionam fichas, escrevem avaliações, guardam favoritos e reivindicam um negócio. Você aprova tudo na administração antes de ficar em direto.
O que obtém
- Diretório e pesquisa. Pesquisa por palavra-chave e localização, filtros por tipo, categoria e cidade, vistas em grelha e em lista, uma linha em destaque e um mapa.
- 10 tipos de fichas. De negócio e restaurante a evento, emprego e imóvel, cada um com os seus próprios campos e o seu próprio tipo schema.org.
- Submissões de membros. Um formulário de cinco passos com verificação de duplicados, lista de palavras bloqueadas e limite por hora.
- Avaliações e reivindicações. Uma avaliação por membro por ficha, e um proprietário pode reivindicar o seu negócio. Ambas aguardam aprovação.
- Ferramentas para proprietários. Os proprietários editam a sua ficha, adicionam fotografias, leem as mensagens dos visitantes, respondem às avaliações e renovam uma ficha prestes a expirar. As edições, fotografias e respostas aguardam a sua aprovação.
- Fotografias e expiração. Uma galeria em cada ficha e um número opcional de dias em que uma ficha fica em direto.
- Importação e exportação. Transfira as fichas como folha de cálculo ou adicione-as a partir de um ficheiro CSV como rascunhos, 100 de cada vez.
- Moderação na administração. Filas para tudo o que aguarda, um cartão do painel que o conta e uma página de Settings.
Como tudo se encaixa
O Listora é o motor: rotas, armazenamento e os ecrãs de administração. Um plugin do EmDash não pode acrescentar páginas a um site, pelo que as páginas públicas seguem como um kit que um único comando copia. Conte com dez minutos para um programador. Veja Instalação.
Os convidados exploram e enviam mensagens a uma ficha. Adicionar, avaliar, guardar e reivindicar exigem uma conta.
Permissões que pede
- Conteúdo (ler, escrever, publicar) e tipos de conteúdo (ler): as fichas são conteúdo do seu site.
- Categorias (ler, atribuir): o formulário oferece as suas próprias categorias.
- Multimédia (adicionar): as fotografias dos proprietários.
- E-mail (enviar): um breve aviso a um proprietário quando há mensagens à espera ou uma ficha está prestes a expirar. Nenhum texto de visitantes é enviado por e-mail, e cada aviso pode ser desativado.
Instalação
Antes de instalar
1. O seu site precisa de um executor de sandbox. Os plugins do registo correm numa sandbox. Enquanto o site não tiver um, Admin, Plugins mostra «No plugins configured» e não há Registry no menu.
- Node: no seu site, execute
npm install @emdash-cms/sandbox-workerd workerde depois acrescentesandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",dentro deemdash()emastro.config.mjs. - Cloudflare: ainda não suportado. No Cloudflare Workers, o EmDash dá a cada chamada de plugin 10 pedidos ao site, e várias páginas e ações deste plugin precisam de mais, pelo que falham. Está em curso uma versão que se ajusta. Os sites Node não são afetados.
Pare o servidor de desenvolvimento e volte a iniciá-lo. Registry aparece agora no menu de administração.
2. O plugin é o motor. As páginas dos visitantes vêm do seu kit de site. Um plugin do registo não pode acrescentar páginas ao seu site. Até copiar o kit, os seus endereços (por exemplo /listings/) mostram a página 404 do seu site. É o esperado. A cópia do kit abaixo demora um único comando.
3. Precisa do Node 22.16 ou posterior para o passo npx emdash seed.
Verificado no EmDash 1.3.1 com o modelo blog em Node.
Instalar
-
Admin, Registry, pesquise Listora, Install e aceite as permissões.
-
A partir da pasta raiz do seu site:
kit="$(mktemp -d)" && git clone --depth 1 \ --branch v0.6.3 \ https://github.com/wbcomdesigns/emdash-listora \ "$kit/emdash-listora" && "$kit/emdash-listora/scripts/add-to-site.sh" . -
Execute o comando seed apresentado. Reinicie o servidor de desenvolvimento.
-
Adicione as ligações de menu apresentadas em Admin, Menus.
-
Abra o Listora, Get started.
Após cada atualização, repita o passo 2 com a nova etiqueta.
Guia completo: https://github.com/wbcomdesigns/emdash-listora/blob/v0.6.3/docs/website/getting-started/install.md
Perguntas frequentes
Porque é que /listings/ dá um 404 após a instalação?
Um plugin do EmDash não pode criar páginas. Execute o comando de configuração da Instalação para as adicionar ao seu site e depois recarregue.
Os convidados podem adicionar fichas ou avaliações? Não. Os convidados exploram e podem enviar uma mensagem a uma ficha. Adicionar uma ficha, avaliar, guardar e reivindicar exigem uma conta com sessão iniciada, o que reduz o spam e dá a cada ficha um proprietário.
As novas fichas ficam em direto de imediato? Só se desativar a aprovação em Settings. Com a aprovação ativada, que é a predefinição, uma ficha aguarda na fila até a aprovar. As edições, fotografias e respostas a avaliações dos proprietários aguardam sempre a sua aprovação.
Funciona no modo escuro? Sim. As cores do kit seguem o tema do seu site.
Envia e-mail? Dois breves avisos aos proprietários das fichas, se o seu site tiver o e-mail configurado: há mensagens à espera e a sua ficha expira dentro de sete dias. Nenhum contém texto de visitantes, e cada um pode ser desativado em Settings. Sem e-mail, os proprietários continuam a ver tudo na sua conta.
Existe uma versão paga? Não. Tudo o que está aqui é gratuito.
Posso mostrar fichas dentro de um artigo do blogue?
Sim, com mais um passo. O kit inclui um bloco Listings para o texto de artigos e páginas, que ativa em astro.config.mjs. O guia de instalação indica as linhas a acrescentar.
Posso trazer fichas de uma folha de cálculo?
Sim. Um administrador do site pode importar um ficheiro CSV em /listings/import/. As linhas são verificadas primeiro e chegam como rascunhos, até 100 por ficheiro.
Registo de alterações
0.6.3
Volte a copiar o kit depois de atualizar, a partir da pasta raiz do seu site:
kit="$(mktemp -d)" &&
git clone --depth 1 \
--branch v0.6.3 \
https://github.com/wbcomdesigns/emdash-listora \
"$kit/emdash-listora" &&
"$kit/emdash-listora/scripts/add-to-site.sh" .- Correção: uma aprovação interrompida a meio devolve a ficha ou a fotografia à fila; More reviews tem espaço acima do formulário de avaliação; uma ligação de avaliações danificada mostra uma mensagem simples.
- Melhoria: os separadores da conta quebram linha no telemóvel; a conta indica o número completo de avaliações acima de 10; Settings menciona /listings/import/ num site novo.
0.6.2
Volte a copiar o kit depois de atualizar.
- Novo: Get started dá o comando do kit para a versão instalada e os endereços para visitantes que acrescenta.
- Correção: as listas já não param nas 100 linhas num site grande; as fichas de exemplo na fila podem ser aprovadas; uma segunda decisão desatualizada é recusada; um diretório vazio di-lo; os botões do modo escuro atingem 4,5:1.
- Segurança: uma nova ficha armazena cada campo com comprimento limitado; a verificação de estado pública não escreve nada.
- Melhoria: o grupo de administração chama-se Listora, a página de avaliações chama-se Listing reviews.
0.6.1
- Segurança: os pop-ups do mapa mostram os títulos das fichas como texto simples; os e-mails são armazenados apenas como endereços simples. Volte a copiar o kit depois de atualizar.
- Correção: renovar e editar seguem o proprietário atual da ficha.
0.6.0
- Segurança: as ligações a sites têm de ser um endereço http ou https completo; as chamadas do lado do servidor correm dentro do EmDash sem pedido web.
- Melhoria: definições em separadores, Find e Load more em cada lista de administração, todo o texto para visitantes num único ficheiro. Volte a copiar o kit depois de atualizar.
Versões anteriores: https://github.com/wbcomdesigns/emdash-listora/blob/main/CHANGELOG.md