Documentação do Designer

O CushyCMS funciona acedendo ao seu site através de FTP e procurando classes de CSS específicas aplicadas aos elementos da página. Com base no conteúdo que encontra, o Cushy apresentará a melhor maneira de editar esse conteúdo.

Esta página documenta todas as opções de template disponíveis no Cushy.

Free Account

Pro Account


Free Account

Síntese Básica

O Cushy irá editar inteligentemente qualquer elemento no qual coloque uma classe de css cushycms.

<h1 class="cushycms" title="My Heading">Isto poderá ser editado</h1>
<div class="cushycms" title="Main Content">
  <p>Aqui, mais material que pode ser editado...</p>
</div>
<p>Não posso ser editado.</p>
<img class="cushycms" src="foo.jpg" alt="Sou uma imagem que pode ser editada!" />

Tip: Pro users can specify a class of "clienteditor" as an alternative to "cushycms".

Se o seu elemento já tiver um nome de classe pode aplicar-lhe o cushycms na mesma:

<div class="whatever cushycms">

Aqui está um vídeo mostrando como começar com CushyCMS:

Como instalar e editar em 5 minutos

Classificar Campos

Ajuda os seus editores a identificar que secção estão a editar ao aplicar etiquetas aos seus campos. Basta utilizar o atributo title do elemento a editar.

<h1 class="cushycms" title="Cabeçalho Principal">Isto poderá ser editado</h1>

O Cushy escolhe automaticamente as etiquetas dos seguintes atributos quando disponíveis::
title, alt, id

Editar Imagens

O Cushy pode permitir que os seus editores alterem as imagens numa página. Depois analisará a altura e largura das etiquetas da sua imagem para redimensionar o ficheiro de modo a caber na área correspondente.

<img src="1.jpg" class="cushycms" width="250" height="100" alt="Photo" />

A imagem será redimensionada para uma largura de 250px e uma altura de 100px. A imagem também será recortada se necessário.

<img src="1.jpg" class="cushycms" width="250" alt="Photo" />

A imagem será redimensionada para uma largura de 250px. A altura manterá a proporção.

<img src="1.jpg" class="cushycms" alt="Photo" />

A imagem não será redimensionada.

Fazer Upload de Ficheiros

O editor Cushy WYSIWYG permite aos utilizadores fazer o upload de ficheiros locais através dos botões Link e Imagem da barra de ferramentas (repare no separador Upload no diálogo pop-up).

Inicialmente os ficheiros são armazenados temporariamente no servidor do cushy, posteriormente são transferidos para o seu servidor FTP aquando da publicação da página.

Por definição estes ficheiros são publicados para os mesmos directórios da página, contudo, esta opção pode ser personalizada na página Configurar Site.

Forçar Tipos de Conteúdo

O Cushy utiliza diferentes métodos de edição dependendo do tipo de conteúdo. O Cushy escolherá um método baseado no container. Contudo, sabemos que existem ocasiões onde quer forçar a escolha de um determinado tipo de conteúdo. Se assim for, use uma das nossas classes alternativas abaixo mencionadas.:

class="cushycms-text"

Edita o conteúdo como texto simples. Exemplo de utilização":" editar o código server-side ou se preferir escrever o seu html à mão.

class="cushycms-html"

Quaisquer caracteres especiais inseridos serão convertidos para entidades html. Eg: © becomes &copy;

class="cushycms-wysiwyg"

O mesmo que acima descrito, mas aqui o editor possui botões para efectuar tarefas básicas tais como criar listas, links, etc.

class="cushycms-xml"

Quaisquer caracteres especiais digitados serão convertidos para entidades xml. Eg: < becomes &lt;

Elementos XML

Cushy tem suporte para elementos XML. O conteúdo inserido na caixa de edição para elementos XML será corretamente XML codificado de modo que seu XML não será inválido. Qualquer elemento encontrado por Cushy que é NÃO classificado como XHTML (lista cheio de elementos aqui) será tratado como XML.

<product>
  <name>Banana</name>
  <price class='cushycms'>$12.99/kg</price>
</product>

Se você está tendo problemas com elementos em seu XML ser pego como XHTML (porque eles têm o mesmo nome), confira a seção em razões imperiosas tipos de conteúdo. Basicamente você pode usar um cushycms-xml tipo de classe para forçar o seu elemento em modo de XML.

Dicas & Truques

Não há muita coisa que o Cushy não consiga editar. Em baixo estão alguns exemplos criativos::

<script type="text/javascript" class="cushycms">
  alert('Vê, até pode editar javascript!');
</script>

Editar javascript. Um exemplo pode ser o seu código do Google AdSense.

<p>Our charity has raised $<span class="cushycms">2140</span> so far</p>

Permite editar apenas uma figura ou palavra.

Utilizar o Cushy com Linguagens Dinâmicas (PHP, ASP, etc)

O Cushy pode ter por vezes dificuldades em decifrar documentos que contenham uma mistura de html e server-side scripting como o PHP.

Por esta razão sugerimos fortemente que coloque o conteúdo a editar num ficheiro estático que será posteriormente acrescentado com os seus scripts.

Por exemplo:

<html>
  <head><title>Contact Us</title></head>
  <body>
    <? include("contact_static.html"); ?>
  </body>
</html>

Acima":" conteúdos do contact.php.

<h1 class="cushycms">Contact Us</h1>
<div class"cushycms">
  <p>Aqui, conteúdo que pode ser editado...</p>
</div>

Acima":" conteúdos do content_static.html.

Neste caso apontará o Cushy para o ficheiro a editar do contact_static.html.

Codificar Caracteres

O Cushy transforma os caracteres especiais (tais como alfabetos não ocidentais) no versátil formato UTF-8. Para suportar este formato assegure-se que aparece na secção head das suas páginas de html.:

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

Saiba mais sobre as vantagens do UTF-8.

 

Pro Account

Elementos repetitivos

Uso de elementos repetitivos em CushyCMS pode ser extremamente poderosa. O primeiro passo é colocar a classe editável em seu elemento externo repetível, tags disponíveis são uma <ul>, <ol> <table> and <dl>. A partir daqui, cushy vai olhar para dentro esse elemento e determinar quais os elementos que são considerados "repetitivo", por exemplo, um <li>, <tr> or <dt>. Uma vez que esse elemento é encontrado, todas as marcas editável dentro esse elemento serão agrupados de modo que qualquer "repetir" do elemento externo irá conter todos os elementos editáveis ​​dentro.

Considere o seguinte exemplo:

<ul class="cushycms">
  <li>
    <p class="cushycms">Isto poderá ser editado</p>
    <p>Não posso ser editado.</p>
  </li>
</ul>

Aqui, o tag <li> contém uma tag <p> editável e um tag <p> não editáveis​​. Quando o editor optar por "repetir" este <li> CushyCMS vai fazer um clone do tag inteiro, incluindo ambos os elementos <p>, mesmo que o editor tem acesso apenas para editar um deles. Você pode ter muitas tags editável dentro de seu elemento repetitivo como você quer, ou você pode apenas fazer o elemento repetitivo editável como um todo.:

Aqui está um vídeo mostrando como implementar uma região repetível.

Regiões Repetitivo

Substituindo imagens / uploads

Use a caixa de seleção na atribuir / configure tela de página para alternar este recurso. Uma vez ativado, qualquer novas imagens para o seu tags <img> CushyCMS irá manter o mesmo nome. Quaisquer imagens ou arquivos enviados através do editor WYSIWYG também irá manter o nome do arquivo que tinha durante o upload. Isto é útil para coisas como price_list.pdf ou similar, mas também significa que o editor está no controle total do que o arquivo será chamado no servidor. Você precisará ter cuidado no caso de sua editores upload de um arquivo chamado print.css ou logo.gif ou similar que poderia arruinar o seu site. Por essa razão, recomendamos usar apenas esta definição quando estiver a usar um caminho de upload personalizado.

Classe Editable personalizado

Como um usuário profissional, você pode definir sua própria classe editável em vez do tradicional cushycms ou classes clienteditor. Você pode até mesmo configurar este editor por. Isto permite-lhe dar um acesso a determinadas seções editor de uma página ao mesmo tempo dando também um acesso editor diferente para outras seções. Pegue o código abaixo por exemplo:

<span class="cushycms-ferris">Only Ferris can edit this.</span>
<span class="cushycms-cameron">Only Cameron can edit this.</span>

Aqui você pode ver as classes personalizadas são cushycms-ferris e cushycms-cameron. Estes poderiam ser mycompany-ferris, se desejar. Você também pode apenas definir cada editores classe personalizada para ser apenas "mycompany" se você não precisa de nenhuma das técnicas autorização complicado. Note-se que essas classes também trabalhar com as substituições de conteúdo, de modo mycompany-ferris-html funcionaria como esperado.

Branding e Estilo

Aqui está um vídeo mostrando como personalizar CushyCMS para caber sua marca, ou marca do seu cliente.

Branding, Styling e clonagem

Clonagem página

Como um usuário pro que você tem a capacidade de deixar o seu alguns ou todos os seus editores criar novas páginas com base no conteúdo das páginas existentes. Você pode ativar isso quando a adição de um editor ou editar as permissões de um editor existente. Permitindo que isso permitirá um ícone clone ao lado de cada página no painel de controle editores (este ícone já é visível para o designer da página). O editor será solicitado o nome da nova página e um nome de arquivo será gerado com base nesse nome. A nova página será um clone exato da página antiga, que o editor pode então editar em conformidade.

E-mail Bem-vindo personalizado

Como um usuário pro você pode definir um modelo de e-mail personalizado de boas-vindas. Isso é feito em suas preferências de usuário, logo abaixo onde você define o seu domínio personalizado e escolher outras características, tais como pro branding. Há uma série de variáveis ​​que serão interpolados para o e-mail, como o nome editores, e-mail e senha gerada pelo sistema. Nós, obviamente, recomendo que inclua pelo menos a senha variável.

RSS Feeds de Alterações nas Páginas

Os utilizadores Pro ganham acesso a RSS feeds especiais para se manterem informados das alterações nos seus sites e páginas.

  • Todas as alterações: este RSS feed está disponível na sua página padrão do painel de controlo
  • Alterações num site: este RSS feed está disponível na sua página Configurar Site
  • Alterações numa página: este RSS feed está disponível na sua página Histórico de Revisões

Independentemente do leitor de RSS feed que utilize precisará de se autenticar visto que lhe serão pedidos os seus dados de login para poder ver as feeds. Se o seu leitor não suportar isso (p.e. Google Reader) uma alternativa é o serviço freemyfeed .