Incluindo arquivos externos no vBulletin

Ola...
Bem, eu procurei tópicos para poder incluir arquivos externos no vBulletin e não tive sorte.
Então, tomei a liberdade de traduzir a parte do manual do vBulletin que fala sobre o assunto.
Estou colocando à disposição da comunidade e principalmente para aqueles que tiverem a mesma necessidade que eu estou tendo no momento.

Incluindo arquivos externos
Aviso:
Isto é considerado como código alterado. Para conseguir ajuda e suporte com a inclusão de arquivos externos, você precisa visitar vBulletin.org Forum - The Official vBulletin Resource!.

Se você tem um arquivo PHP ou HTML que deseja incluir em seu fórum vBulletin, crie um plugin que referencie o arquivo. Então acrescente uma variável ao modelo de sua escolha onde os conteúdos daquele arquivo devem se aparecer.

Note:
O sistema de Plugin deve estar abilitado no vBulletin para poder trabalhar: Options -> Plugin. Ele esta desabilitado por default.

Incluindo um arquivo HTML:
1. Crie um Plugin para global_start com este código:
$includedhtml = implode('', file('path/to/this/file/myfile.html'));
Substitua o path e o nome do arquivo com o path e o nome do arquivo HTML que você quer incluir. Serão copiados os conteúdos da myfile.html para a variável $includedhtml.

2. Coloque a variável $includedhtml em um de seus modelos, como cabeçalho, navbar, FORUMHOME, dependendo aonde você quer que o conteúdo de seu arquivo de HTML apareça.


Incluindo um arquivo PHP:
1. Crie um Plug-in para global_start com esses conteúdos:
ob_start(); include('path/to/this/file/myfile.php'); $includedphp = ob_get_contents(); ob_end_clean();
Substitua o path e o nome do arquivo com o path e nome do arquivo PHP correto que você quer incluir. O código em myfile.php executará qualquer saida gerada por este manuscrito o qual será armazenado na variável $includedphp.

2. Coloque a variável $includedphp em um de seus modelos, como cabeçalho, navbar, FORUMHOME, dependendo onde você quer que os conteúdos de seu arquivo de PHP apareçam.



Aviso:
Plugins que contém código inválido ou malicioso pode fazer seu foro deixar de funcionar ou até mesmo conduzir a perda de dados. Usando Plugins não compatíveis será pedido a você que os incapacite quando solicitar suporte técnico. Se um Plugin fez seu fórum ficar inacessível, por favor, incapacite plugins. Para diagnosticar plugins errados e manipular produtos acesse nosso site, http://www.vBulletin.org.

O que é Ulitização de Proteção Memória (buffered)?

A maioria dos arquivos PHP que você pode desejar incluir em seu fórum contêm eco ou outras declarações de saídas do seu arquivo PHP, e ele deve interromper o vBullegtin porque ainda vai estar no processo de inicialização quando seu arquivo PHP for carregado. Todos os ecos e saídas de outros comandos de produção de buffered usam os comandos ob_start, ob_clean, etc. As saidas de seu script PHP será buffered para uso posterior e inserido em uma variável. Todas as outras declarações dos scripts PHP serão executas normalmente.

Uma palavra sobre variáveis.

É muito importante que qualquer variável iniciada em seu script PHP não sobreponha variáveis incluidas no vBulletin ou você ter resultados imprevisíveis. É aconselhável criar um script PHP só para inclusão em seu fórum em lugar de um script maior usado em outra parte de seu web site.

Que gancho eu devo usar?

O gancho usado acima (global_start) faz seu arquivo HTML ou PHP disponível em quase todo modelo em seu foro vBulletin. Você pode desejar só incluir um arquivo de PHP ou HTML em certas páginas ou partes de seu foro. Você precisará selecionar o gancho correto onde seu código deve ser carregado. Para determinar qual gancho você deve usar, faça um Debug e então realize a mudança para o funcionamento apropriado do arquivo php.

Como entro em modo de depuração?

Por favor, observe que você não deve entrar em modo de depuração em um ambiente ao vivo (ambiente de produção).

Abra o arquivo config.php.
No topo, em uma nova linha abaixo de <?php
inclua: $config['Misc']['debug'] = true;
Nota:
Se você deseja usar include() para multiplos arquivos PHP, esteja certo de que você utiliza ob_clean() antes de cada include() para reiniciar o buffer.

Copyright ©2000 - 2008 Jelsoft Enterprises Limited. All rights reserved. vBulletin® is a registered trademark.

Bem, espero que seja útil...
Abraços e até a próxima...