jcom.xml
O arquivo /conf/jcom.xml contém os parâmetros que determinam o comportamento da loja, formas de pagamento, serviços adicionais e validadores de formulário. Diversas opções estão pré-definidas no arquivo de exemplo, e outras podem ser acrescentadas se necessário.
Abra o arquivo com um editor de textos como o Notepad do Windows, um editor XML ou o Macromedia Dreamweaver.
O conteúdo do arquivo é semelhante ao conteúdo abaixo:
<?xml version="1.0" encoding="ISO-8859-1"?>
<store>
<properties>
<property name="locale">pt_BR</property>
<property name="minOrder">10.00</property>
<property name="itemsPerPage">8</property>
<property name="contact.email">suporte@minhaloja.com.br</property>
<property name="from.email">suporte@minhaloja.com.br</property>
<property name="from.name">Minha Loja</property>
<property name="picture.width">300</property>
<property name="picture.height">300</property>
<property name="thumb.width">120</property>
<property name="thumb.height">120</property>
</properties>
(...)
</store>
Verifique atentamente as tags "properties" deste arquivo. O valor da propriedade "locale" é "pt_BR", que indica que o país da loja é o Brasil e a língua é o Português. Esta configuração afeta a língua das mensagens do sistema, o formato de datas e formatação de dados monetários (que serão apresentados com R$ automaticamente). Se a loja utilizar a língua Inglesa e dólares como moeda, pode-se trocar esta propriedade para "en_US", por exemplo.
Cada propriedade serve um propósito específico da configuração. A propriedade "minOrder" indica qual o valor mínimo de pedidos aceitos pela loja; já a propriedade "itemsPerPage" indica quantos produtos serão apresentados em cada página da loja. Em alguns casos é possível criar páginas que ignorem estas propriedades - é permitido ao designer criar uma lista de produtos sem paginação, por exemplo.
Todas as propriedades configuradas neste arquivo estão disponíveis para uso dentro de templates e páginas, através do objeto $store. Para inserir em uma página o valor da propriedade "minOrder" podemos utilizar:
<font color="blue">O pedido mínimo desta loja é $store.minOrder</font>
Além das propriedades definidas pelo jCom, você pode adicionar outras propriedades conforme necessário, com o nome que desejar. Desta forma, é possível parametrizar aspectos do comportamento ou até mesmo do layout da loja.
Além das propriedades contidas dentro da tag <properties>, este arquivo contém também as tags <paymentTypes>, para as formas de pagamento disponíveis, <services> para os serviços customizados e <validators> para os validadores de formulário. Veremos como configurar estes itens em outras seções a seguir.
Propriedades Básicas
| locale | Localização e língua do site, como pt_BR (Português/Brasil) ou en_US (Inglês/Estados Unidos) |
|---|---|
| managerLogo | URL do logo que aparece na administração da loja. Pode ser uma url relativa à raiz da loja, por exemplo /images/meu_logo.gif |
| itemsPerPage | Quantidade de itens a serem mostrados em cada página do catálogo de produtos |
| minOrder | Valor mínimo aceitavel para um pedido. Pedidos abaixo deste valor não poderão ser finalizados. Este valor deve ser informado com ponto no lugar de vírgula, ou seja, 15.50 representa 15 reais e 50 centavos. |
| mail.smtp.host | Servidor de e-mail a ser utilizado para o envio de e-mails. Normalmente é "mail.isnet.com.br" |
| picture.width | Largura padrão em pixels das fotos dos produtos, quando reduzidas automaticamente pelo sistema. |
| picture.height | Altura padrão em pixels das fotos dos produtos . |
| thumb.width | Largura padrão em pixels das fotos reduzidas dos produtos, apresentadas no catálogo. |
| thumb.height | Altura padrão em pixels das fotos reduzidas dos produtos. |
| contact.to | E-mail que receberá os contatos do site |
| contact.from.email contact.from.name |
Nome e e-mail que aparecerão como remetente dos contatos do site |
| order.client.mail.from.email order.client.mail.from.name |
Nome e e-mail que aparecerão como remetente dos e-mails de confirmação de pedido, enviados para o cliente |
| order.client.mail.subject | Assunto dos e-mails de confirmação de pedido, enviados para o cliente |
| order.store.mail.subject | Assunto do e-mail de aviso de pedido, enviado para o lojista |
| order.store.mail.to | Endereço de e-mail que receberá os avisos de recebimento de pedidos |
| sendPassword.from.email sendPassword.from.name |
Nome e e-mail do remetente dos e-mails de "esqueci minha senha" |
| templateEngine | Indica se deve ser utilizado o gerenciamento interno de templates do jCom. Deve ser true em caso positivo, e geralmente false quando utilizados templates do Dreamweaver. |
| defaultTemplate | Arquivo do template padrão, utilizado em todas as páginas se a propriedade "templateEngine" for true. O valor padrão é "default.htm" e os templates precisam estar dentro do diretório "templates". |
| newsPage | Página ou URL para onde apontam as notícias RSS. Para mais informações, veja a seção sobre RSS. O valor default é /noticia.htm?id= |

