PHP Coupé

Aprendendo

Classes

Coupe_Content (0.1a)

Classe com métodos para manipulação dos arquivos de conteúdo.

Informações

Get Title

Pega o título de um conteúdo qualquer.
Sua forma de buscar pelo título é baseado nas normas de títulos da W3C, ou seja, os títulos devem estar corremente organizados de forma hierárquica.
Se um documento for pai, o programa buscará pelo que estiver dentro da tag H2, se o documento for um sublink busca pelo que estiver dentro da tag H3, e assim por diante...
Se não achar um título de acordo com seu nível, tenta achar um título em um nível maior (se não achar H3, tentar retornar H2)

Recebe: recebe: ($string=id_do_conteudo, [$bool=retornar_com_as_tags?])
Retorna: STRING (titulo do conteudo com ou sem a tag)

...
$Coupe->import('Coupe_Content');
// retorna o que estiver entre a tag H3 do documento noticias.lancada-nova-versao.cnt.php
return $Coupe->Coupe_Content->getTitle('noticias.lancada-nova-versao');
...

Hierarquia

Get Children

Busca os filhos de um documento especificado. Se tiver filho retorna um vetor, caso contrário retorna 'false'.
O segundo parâmetro indica se é para retornar todos descendentes do ID indicado ou apenas os filhos diretos.

Recebe: ($string=id_do_conteudo, $bool=todos_ou_filhos_diretos)
Retorna: ARRAY (lista dos documentos filhos) ou FALSE

...
$Coupe->import('Coupe_Content');
$childrens = $Coupe->Coupe_Content->getChildren('noticias');
// pega o vetor com os filhos do documento indicado
// 'noticias.lancada-nova-versao' seria um deles
...

Get Parent

Busca o pai de um documento especificado.
Se o documento não tiver pai, o segundo parâmetro torna-o pai de si mesmo e dos irmãos.
Isso é ideal para criar menus onde a secão não tem uma página introdutória.

Recebe: ($string=identificador, [$bool=sem_pai_torna-se_pai_de_si_mesmo_e_dos_irmaos])
Retorna: STRING (identificado do documento pai)

...
$Coupe->import('Coupe_Content');
return $Coupe->Coupe_Content->getParent('noticias.lancada-nova-versao');
// retorna 'noticias' caso o documento indicado tenha um documento pai
...

Get Level

Informa o nivel hierárquico de um conteúdo (se eh pai, filho, neto, etc.).
Por exemplo, essa função eh utilizada pela 'getTitle' para saber o tipo de 'header' a ser usado.

Recebe: ($string=id_do_conteudo)
Retorna: INT (nível hierárquico do conteúdo)

...
$Coupe->import('Coupe_Content');
// retorna 2 pois eh sublink de 'noticias'
return $Coupe->Coupe_Content->getLevel('noticias.lancada-nova-versao');
...

Navegação

Make URL

Cria links para conteúdos de um projeto feito no PHP Coupé.
Pode receber parâmetros para gerar uma URL com GETs.
Também pode receber nomes de GETs que, caso tenham sido submetidos, sejam incluidos na URL para propagar os parâmetros.
Importante utilizar essa função pois ela faz o controle se está sendo usado URLs amigáveis ou não para gerar o link.
Lembrando que o caminho da URL é construido usando a configuração do PHP Coupé onde é definido o endereço do site.

Recebe: ($string=conteudo, [$string=parametros_get], [$string=nome_gets_jah_submetidos])
Retorna: STRING (URL para o conteúdo especificado)

...
$Coupe->import('Coupe_Content');
// http://www.meusite.com.br/contato/nome:Jose/
return $Coupe->Coupe_Content->makeUrl('contato', 'nome=jose');
...