Documentação do Designer

O CushyCMS opera através do FTP, onde o seu site está hospedado, e procura classes CSS específicas inseridas nos elementos HTML. Com base no conteúdo encontrado, o Cushy irá, então, apresentar a maneira mais adequada de editar esse conteúdo.

Esta página informa todas as opções de templates do Cushy que estão disponíveis.

Free Account

Pro Account


Free Account

Resumo Geral

O Cushy editará, com precisão, qualquer elemento que você inserir a classe CSS cushycms.

<h1 class="cushycms" title="My Heading">Este elemento se tornará editável</h1>
<div class="cushycms" title="Main Content">
  <p>Aqui, material adicional para edição...</p>
</div>
<p>Eu não sou editável.</p>
<img class="cushycms" src="foo.jpg" alt="Eu sou uma imagem editável!" />

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

Se um elemento HTML/XML já possuir uma classe CSS, mesmo assim você pode inserir a classe cushycms nele.:

<div class="whatever cushycms">

O vídeo, a seguir, mostrará, em poucos minutos, como usar o CushyCMS.

Como configurar e editar em 5 minutos

Classificação dos Campos

Ajude os seus editores identificar em qual seção eles estão trabalhando, através da aplicação de etiquetas em seus campos. Basta usar title no atributo do elemento a ser editado.

<h1 class="cushycms" title="Título Principal">Este elemento se tornará editável</h1>

O Cushy irá, precisamente, identificar os seguintes atributos, onde estiverem disponíveis.:
title, alt, id

Edição de imagens

O Cushy permite aos seus editores modificar as imagens em uma página. Verificará a altura e a largura da imagem e a redimensionará para um tamanho adequado, onde se situa na página.

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

A imagem que foi transferida será redimensionada para 250px de largura e 100px de altura. A imagem poderá ser recortada se for necessário.

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

A imagem transferida será redimensionada para uma largura de 250px. A altura será mantida proporcionalmente.

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

A imagem que foi transferida não será redimensionada.

Transferência de Arquivos

O editor WYSIWYG do Cushy permite que usuários transfiram os arquivos locais através dos botões da barra de ferramentas Link e Image (observe a aba Upload na caixa de diálogo).

Inicialmente, esses arquivos são armazenados, provisoriamente, no servidor Cushy, e a seguir são transferidos para o servidor FTP, definido previamente.

Por padrão, estes arquivos são publicados no mesmo diretório onde está a página, entretanto a localização pode ser personalizada através da página de configuração.

Substituição dos Tipos de Conteúdo

O Cushy usa diversos métodos de edição, dependendo do tipo de conteúdo. O Cushy escolherá o método de acordo com o conteúdo de cada elemento HTML. Entretanto, entendemos que existirão momentos que você desejará mudar isso. Se assim for, use uma das classes alternativas, listadas a seguir.:

class="cushycms-text"

Edita o conteúdo com texto sem formatação. Editando um código no lado do servidor ou escrevendo o código HTML manualmente, por exemplo.

class="cushycms-html"

Qualquer caractere especial, digitado, será transformado em uma entidade HTML. Eg: © becomes &copy;

class="cushycms-wysiwyg"

O mesmo que acima, embora o editor é mostrado com os botões para executar tarefas básicas, assim como a criação de listas, links, etc.

class="cushycms-xml"

Qualquer caractere especial, digitado, será transformado em uma entidade XML. Eg: < becomes &lt;

Elementos XML

O Cushy suporta elementos XML. O conteúdo inserido no campo de edição, para elementos XML, serão codificados corretamente para que não se tornem inválidos. Qualquer elemento encontrado pelo Cushy que NÃO esteja classificado como XHTML, será tratado como XML. (Confira a lista completa aqui).

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

Se você está tendo problemas com elementos no XML sendo reconhecidos como XHTML (por possuírem o mesmo nome), vá para a seção, substituição dos tipos de conteúdo. Simplesmente, você pode usar uma classe cushycms-xml para forçar o elemento ser reconhecido como XML.

Dicas & Truques

Entenda que existe poucas opções que o CUshy não pode editar. A seguir, alguns exemplos criativos.:

<script type="text/javascript" class="cushycms">
  alert('Veja, você pode editar códigos em javascript!');
</script>

Edição de javascript. O código do Google AdSense, por exemplo.

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

Possibilta a edição de uma simples imagem ou palavra.

O Uso do Cushy com Linguagens Dinâmicas (PHP, ASP, etc.)

O Cushy pode ter dificuldade em decifrar os documentos que contenham uma mistura de HTML e scripts que estão no lado do servidor, como o PHP.

Por este motivo, nós sugerimos, veementemente, colocar o conteúdo a ser editado em um arquivo estático, que pode ser incluído através de scripts.

Por exemplo:

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

Acima: conteúdo de contact.php.

<h1 class="cushycms">Contact Us</h1>
<div class"cushycms">
  <p>Conteúdo editável aqui...</p>
</div>

Acima: conteúdo de content_static.html.

Nesta condição, você poderia direcionar o Cushy para editar o arquivo em contact_static.html.

Codificação de Caractere

O Cushy pode mostrar caracteres especiais (assim como alfabetos não-ocidentais) no versátil formato UTF-8. Para identificar este formato, por favor, verifique se o mesmo aparece na seção HEAD das suas páginas HTML.:

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

Informações adicionais sobre benefícios do UTF-8.

 

Pro Account

Elementos Repetitivos

O uso de elementos repetitivos no CushyCMS pode ser extremamente prático. O primeiro passo é colocar a classe editável no seu elemento repetitivo externo, os elementos disponíveis são <ul>, <ol> <table> e <dl>. Daqui em diante, o Cushy verificará o elemento e determinará quais os elementos que são considerados "repetitivo", por exemplo, um elemento <li>, <tr> ou <dt>. Assim que for encontrado, qualquer outro elemento editável, dentro desse elemento, será agrupado de modo que qualquer "repetição" do elemento externo irá conter todos os elementos editáveis ​​dentro.

Considere o exemplo, a seguir:

<ul class="cushycms">
  <li>
    <p class="cushycms">Este elemento se tornará editável</p>
    <p>Eu não sou editável.</p>
  </li>
</ul>

Aqui, o elemento <li> contém um elemento <p> editável e um outro <p> não editável. Quando o editor escolhe para "repetir" este o elemento <li> a CushyCMS vai fazer uma reprodução(clone) de todo o conteúdo que está nele, incluso os dois elementos <p>, apesar de que o editor só pode editar, apenas, um deles. Você pode ter quantas elementos editáveis, dentro de outro elemento, ​​você desejar, ou você pode apenas fazer que o elemento seja editável e repetitivo como um todo.:

Este vídeo mostrará como inserir uma região repetitiva.

Regiões Repetitivas

Substituição das imagens / transferências

Use a caixa de seleção na página de atribuição / configuração para alternar este recurso. Uma vez ativado, todas as imagens novas para o elemento <img>, o mesmo nome será mantido. Outras imagens ou arquivos transferidos através do editor WYSIWYG também manterão o nome que eles possuirem durante a transferência. É bastante útil para arquivos como o price_list.pdf ou similares, mas também significa que o editor terá total controle do arquivo que será requisitado no servidor. Você precisa ter cuidado no caso de seus editores transferirem um arquivo chamado print.css ou logo.gif ou similar que poderia danificar o seu site. Por esse motivo, recomendamos usar apenas esta definição quando for usar uma localização personalizada.

Classe Personalizada Editável

Como um usuário Pro, você pode definir o nome de uma classe editável em vez do tradicional cushycms ou classes clienteditor. Inclusive você pode definir uma classe diferente para cada editor. Permitindo assim, dar um acesso a um editor para determinadas seções de uma página e ao mesmo tempo dar acesso a outro editor para uma seção diferente. Copie o código abaixo, como 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 que as classes personalizadas são cushycms-ferris e cushycms-cameron. Mas pode ser mycompany-ferris, se você desejar. Você pode, também, definir para cada um dos editores uma classe personalizada chamada mycompany se você não necessita de qualquer autorização especial. Observe que essas classes, também, funcionam com as substituições de conteúdo, portanto mycompany-ferris-html funcionaria da forma esperada.

Marca e Estilo

Este vídeo mostrará como personalizar o CushyCMS para inserir a sua marca ou a de seu cliente.

Usar a sua marca, Estilizar e Reproduzir (Clonar)

Reprodução (clonagem) de Página

Como um usuário da conta Pro, você pode permitir que uma parte ou todos os seus editores, criem novas páginas com base no conteúdo das páginas existentes. Você pode ativar esta opção quando adicionar um editor ou permissões de edição. A ativação desta opção habilitará um ícone, no painel de controle de cada editor, onde será possível reproduzir (clonar) uma página, (este ícone já é visível para o designer da página). Será solicitado, ao editor, o nome da nova página e o nome do arquivo será gerado com base nele. A nova página será um cópia exata da página antiga, a qual o editor pode alterar.

Email de Boas-vindas Personalizado

Como um usuário Pro, você pode definir um modelo de e-mail de boas-vindas, personalizado. Isso pode ser feito em preferências do usuário, logo abaixo do local onde você define o seu domínio personalizado e escolhe outros recursos da conta Pro, assim como inserir marca. Existe uma infinidade de variáveis ​​que serão adicionadas no e-mail, como os nomes dos editores, endereço de e-mail e senha gerada pelo sistema. Nós, obviamente, recomendamos que se inclua, pelo menos, a variável senha.

RSS Feeds das Modificações Efetuadas em uma Página

Usuários da conta Pro acesso a um RSS Feed especial para se manter informado das modificações feitas nos sites e páginas.

  • Todas as modificações: este Feed está disponível na página do painel de controle
  • Alterações em um site: este Feed está disponível na página de configuração
  • Modificações em uma página: este Feed está disponível na página de Histórico de Revisões

Qualquer que seja leitor de Feeds que você usa, será necessário suportar autenticação, como aquela solicitada para acessar a sua conta no Cushy, para ler os Feeds. Se o leitor não possuir suporte como (por exemplo, o Google Reader), então a solução é o serviço freemyfeed (Leitor de Feeds online) .