Existe um serviço no Liferay que é muito interessante e tem nos ajudado bastante, é a classe PermissionChecker.

Com ela conseguimos testar se um usuário tem a permissão sobre um determinado objeto, pode ser um conteúdo web, um post de um forum ou até mesmo acesso a uma determinada comunidade ou organização. Tudo isso pode ser verificado utilizando essa classe e seus métodos.

Para ficar mais claro, alguns exemplos de uso dessa classe:

A classe permissionchecker pode ser importada para um arquivo utilizando o seguinte código:

import com.liferay.portal.security.permission.PermissionChecker;

Um exemplo de um método dessa classe é:

permissionChecker.isCommunityAdmin(group.getGroupId()));

Esse método testa se o usuário é administrador de uma comunidade.

O permissionChecker também pode ser usado como instancia para a passagem de parametro para outras classes que fazem testes mais específicos, como no exemplo abaixo:

hasSavePermission = JournalArticlePermission.contains(permissionChecker, groupId, articleId, ActionKeys.UPDATE);

Nós já utilizamos esse método em alguns artigos aqui na Weblibre, confira:

• http://www.weblibre.com.br/problema-permissoes-no-resultado-do-portlet-busca/
• http://www.weblibre.com.br/negar-edicao-de-conteudos-web-aprovados/
• http://www.weblibre.com.br/alterar-a-listagem-dos-conteudos-no-liferay/

Existe um bug no Liferay que os usuários comuns, ou seja, usuários não autenticados como administradores do sistema, não consegue visualizar o link que está dentro de um conteúdo web.

Esse bug foi descoberto após colocarmos a opção no portal-ext.properties de que o usuário não poderia mais ter páginas pessoais públicas e privadas.


layout.user.private.layouts.enabled=false
layout.user.public.layouts.enabled=false


Resolvemos esse problema eliminando essa informação do portal-ext.properties e ainda limpando o cache do Lucene, que fica no diretório:

liferay-portal-5.2.3\data

Exclua o conteúdo desta pasta, isso forçará o Lucene a reindexar todas as suas buscas e deve solucionar o problema.

Esse BUG está relacionado com outro bug já descrito nos nossos artigos, confira aqui:

• http://www.weblibre.com.br/como-arrumar-bug-de-permissoes-de-download-no-liferay/

O Liferay possui um repositório onde as alterações que são feitas no código são armazenadas.

Esse repositório pode ser acessado por qualquer usuário com o usuário guest e sem senha.

Para facilitar o uso do repositório é muito interessante o download de uma ferramenta que seja um gerenciador de svn, nós particularmente recomendamos o Tortoise, que pode ser baixado no link:

http://tortoisesvn.net/downloads

Após fazer o download do Tortoise você já pode acessar o repositótio inserindo o link :

svn://svn.liferay.com/repos/public/portal/trunk

Esse links deve ser inserido na opção Repo-browser. Após o login com o usuário citado acima você já consegue ver a estrutura de pastas do repositório e informações úteis como a data que o arquivo foi modificado e o autor dessa modificação.

Para fazer o download, chamado aqui de checkout, apenas clique com o botão direito sobre uma pasta na estrutura a esquerda e selecione chekout, ou se quiser fazer apenas o download de um arquivo, clique sobre ele com o botão direito e selecione “save as”.

O portal Liferay realiza busca dentro de arquivos, como por exemplo, arquivos pdf, word, etc…

Por algum motivo, essa busca pode começar a dar problemas e um deles é a inserção de caracteres inválidos dentro do xml que o portlet de Busca utiliza para fazer a leitura.

Para identificar esse problema observe que o log começará a avisar sobre um erro na leitura do xml no momento em que o portal tenta fazer a busca nos arquivos.

A maneira como corrigimos esse problema foi identificar o local onde ele faz essa leitura e utilizar um método em java que retira os caracteres inválidos do xml, como é narrado abaixo:

O método que criamos é o seguinte:


String stripNonValidXMLCharacters(String in) {
StringBuffer out = new StringBuffer(); // Used to hold the output.
char current; // Used to reference the current character.

if (in == null || ("".equals(in))) return ""; // vacancy test.
for (int i = 0; i < in.length(); i++) { current = in.charAt(i); // NOTE: No IndexOutOfBoundsException caught here; it should not happen. if ((current == 0x9) || (current == 0xA) || (current == 0xD) || ((current >= 0x20) && (current <= 0xD7FF)) || ((current >= 0xE000) && (current <= 0xFFFD)) || ((current >= 0x10000) && (current <= 0x10FFFF)))
out.append(current);
}
return out.toString();
}

E inserimos esse método no arquivo liferay-portal-5.2.3\tomcat-6.0.18\webapps\ROOT\html\portlet\search\search.jsp

No momento em que ele faz a leitura do xml, na linha # 169 inserimos o seguinte código:


xml = stripNonValidXMLCharacters(xml);


O “hook” foi desenvolvido pelo Brian Chan e como nome sugere ele permitem um “gancho” no Liferay. Especificamente, eles permitem que você “hook” nos eventos do sistema, nos listeners, nos JSPS, basicamente em todo as propriedades do portal.

Sendo assim, você pode “enxertar” código em quase qualquer lugar do seu portal Liferay. Isso é muito útil e deve ser usado dessa maneira sempre que possível, pois mantém o sistema o mais dentro do padão possível, ao contrário das modificações no ambiente de extensão.

Para conhecer mais sobre o assunto, verifique esses links:

• http://www.liferay.com/web/raymond.auge/blog/-/blogs/portal-hook-plugins
• http://wiki.github.com/azzazzel/liferay-maven-sdk/creating-a-hook

Por muitas vezes é interessante saber como recuperar o usuário que está logado no sistema e dependendo do local de onde essa informação é necessária, você pode recuperar de maneira diferente.

Uma forma é através do request:

request.getRemoteUser()

Esse método retornará um id do usuário, com o qual você consegue recuperar o usuário em si.

Outra forma é através do theme, com o seguinte código:

themeDisplay.getUserId()

Que retornará o id do usuário.

Com o id é fácil de recuperar uma instancia desse usuário, onde será possivel recuperar mais informações dele, como por exemplo sua organização.

Para isso faça o seguinte:

String userId = request.getRemoteUser();
User user = UserLocalServiceUtil.getUserById(userId);

Para recuperar a Organização ao qual o usuário pertence, utilize o seguinte método:

organizations = OrganizationLocalServiceUtil.getUserOrganizations(UserId);

E para recuperar os grupos aos quais esse usuário pertence, faça o seguinte:

user.getGroupIds()

Esse método retorna os Ids dos grupos, mas se quiser uma lista de grupos, utilize o método abaixo:

user.getUserGroups()

Roteiro para Criação de Papeis do Blog

Blogs são ferramentas bastante simples para inserção de conteúdo.

Os Blogs no Liferay trabalham com escopos diferentes, ou seja, se um post é visto em uma comunidade ele pode não ser visto em outra, pois ele pertence ao escopo da comunidade que o criou.

Os Blogs podem ser configurados se acessarmos a opção “Blogs” no painel de controle ou através da inserção do portlet “Blogs” em uma página.

Ambos os modos permitem ao usuário registrado a opção de inserir uma nova postagem, editar as postagem já realizadas pelo usuário ou simplesmente apagar uma certa postagem.

A listagem mostra as ultimas postagens que o usuário tem visualização, seja pelo escopo ou por alguma permissão que ele possua.

Definindo os Papeis do Blog

Para definirmos os papeis que envolvem o Blog, precisamos acessar o item Papeis dentro do painel de controle.

Crie um novo Papel para administrador do Blog, depois selecione “Definir Permissões”:

Para um Papel de Administrador, selecione as seguintes opções com escopo Portal:

• Configuração
• Vista
• Access in Control Panel
• Adicione Entrada
• Adicione Discussão
• Apagar
• Apagar Discussão
• Permissões
• Atualizar
• Atualizar Discussão
• Vista

Para um Papel de administrador que não deseja inserir postagens, retire as opções de adição de entrada e atualizar.

Para um Papel de moderador, selecione as seguintes opções:

• Acesses in Control Panel
• Adicione Entrada
• Adicione Discussão
• Atualizar
• Atualizar Discussão
• Vista

Para um papel de criador, selecione as seguintes opções:

• Adicione Entrada
• Adicionar Discussão

Agregador de Blogs

A visualização dos posts criados em um blog pode ser feita pelo portlet “Agregador de Blog’s”.

Esse portlet tem a opção de definir quais usuários irão ter a visualizarão do conteúdo que ele está listando. Temos a possibilidade de mostrar conteúdos por autores ou por escopos.

Para configurar esse portlet, primeiramente o adicione a uma página.

Selecione a opção de configuração, a seguinte interface será mostrada:

Na opção de Visualização, você pode selecionar Papeis pré-definidos a terem Visão ou poder Configurar o portlet.

Com a Opção “Escopo”, podemos definir a qual escopo pertencem as postagens listadas.

Wikis no Liferay

A Wiki do Liferay trabalha com subdivisões chamadas “nós”. Portanto uma mesma entidade (Organização ou Comunidade) pode ter mais de uma wiki, dentro de uma mesma estrutura de wiki.

Cada nó pode ser visível para usuários diferentes, tornando a estrutura extremamente bem organizada e adaptativa.

Para criar uma Wiki, devemos acessar o Painel de Controle com um usuário Administrador. Escolha a opção wiki, a seguinte interface será exibida:

Selecione a opção Gerenciar Wikis, que está em destaque na imagem acima.

Na interface que abrir, terá as opções para edição do “Nó” da wiki ou a a criação de um novo nó, que se faz através do botão “Adicione Wiki”. Faça isso e crie um novo nó como exemplo.

Retorne para a página inicial da Wiki e perceba que agora você tem a opção de edição dos nós da wiki, podendo alternar entre o antigo e o que acabou de ser criado.

Observe os ícones de edição e detalhamento da wiki. Na opção de edição aparecerá uma interface para que possa editar/criar a página wiki.

No item detalhes, podem ser configurados mais detalhes da wiki, como por exemplo subscrever a wiki e receber um e-mail quando ela for atualizada.

Criação dos Papeis para Wiki

A idéia da wiki é que todos possam colaborar para que se possa dividir o conhecimento de todos, mas nem sempre isso é desejado, as vezes é conveniente que apenas alguns usuários tenham permissão para editar os campos da wiki.

Para a criação dos papeis da wiki, acesse o Painel de Controle e na opção “Papeis”, comece criando um papel para o administrador da wiki.

Ele deve ter as seguintes permissões:

• Configuração e Vista
• Adicionar Anexo, Página e Discussão
• Adicionar Nó
• Apagar, atualizar, subscrever e importar

Para a criação de um “revisor” da wiki, repita o mesmo procedimento mas apenas selecione os seguintes papeis:

• Apagar, atualizar, subscrever e importar
• Adicionar Anexo, Página e Discussão

Um usuário que apenas pode criar paginas wikis apenas ter as opções de:

• Adicionar Página e Anexo
• Subscrever
• Adicionar Discussão

Criação do Fórum:

Para criar um fórum, acesse o menu Mensagens de Fórum presente nas opções do Painel de Controle:

Outra forma é entrar diretamente na página onde o fórum será exibido e adicionar o portlet de fórum, esse portlet terá as opções idênticas as apresentadas no painel de controle, confira:

Com esse procedimento o fórum já está criado e agora devemos configurar os papeis que irão ser responsáveis pela manutenção do Fórum.

Primeiramente, iremos criar a função de Administrador do Fórum, para isso acesse “Papeis” em “Painel de Controle”. Adicione um Papel e o defina como “Administrador do Fórum”.

Acesse a opção “Adicionar permissões ao Portlet” e procure pelo portlet “Mensagens de Fórum”.

Coloque com visibilidade Portal para todos os itens com exceção do “Access in Control Panel”, que não tem necessidade.

Para a criação de um Moderador para o fórum, o usuário provavelmente terá as seguintes permissões:

• Adicionar uma Mensagem
• Adicionar uma Subcategoria
• Apagar
• Mover um Linha de Discussão
• Subscrever
• Atualizar
• Prioridade da Linha de Discussão
• Resposta a Mensagem

Esse são os dois principais papeis que um fórum precisa ter, a partir deles deve ser feita um ajuste para melhorar a adaptação ao seu sistema.

O Liferay pode ser configurado a partir de modificações em um arquivo que fica no diretório classes, o portal-ext.properties.

Esse contém todas as modificações que desejamos fazer ao Liferay, e é arquivo que pode ser visto como um espelho do arquivo portal.properties. Esse ultimo contém todas as configurações padrões do portal.

Ou seja, se precisar alterar uma configuração padrão, procure no arquivo portal.properties e encontre o que necessita. Copie no arquivo portal-ext.properties, faça suas alterações, grave e reinicie o servidor. Observe que as alterações serão feitas.

Nós já listamos aqui algumas configurações sobre esse arquivo, são elas:

• http://www.weblibre.com.br/cache-de-javascript-e-css-no-liferay-como-remover/
• http://www.weblibre.com.br/instalacao-do-liferay-no-linux-red-hat/
• http://www.weblibre.com.br/como-arrumar-bug-de-permissoes-de-download-no-liferay/
• http://www.weblibre.com.br/configurando-mysql-no-liferay/