Observe que esta resposta já tem alguns anos e não foi atualizada. Sinta-se livre para editar / comentar se você acha que algo não é mais exato.
Abstrato
Quase não existe uma maneira oficial de lidar com isso, depende muito da complexidade e do quanto você deseja confiar no padrão MVC para fazer o trabalho.
Abaixo estão algumas soluções possíveis que devem funcionar no Joomla 2.5 e 3.x. O código não é apresentado para um trabalho de copiar e colar, mas como uma idéia geral.
Antes do Joomla! 3.2 a única coisa que você precisa para usar os exemplos abaixo é a component. Após o Joomla 3.2 (para tarefas menos complexas), você pode lidar com solicitações de módulos e plugins.
Resposta HTML genérica (após MVC herdado)
Seu URL para a tarefa precisa ter a seguinte aparência:
index.php?option=com_similar&task=abc&format=raw
Você criou o controlador que usará a visualização, digamos Abc, que conterá o arquivo view.raw.html (idêntico a um arquivo de visualização normal).
Abaixo você tem o código para gerar uma resposta HTML bruta:
/controller.php
public function abc()
{
// Set view
// Joomla 2.5
JRequest::setVar('view', 'Abc');
// (use JInput in 3.x)
$this->input->set('view', 'Abc');
parent::display();
}
/views/abc/view.raw.php
<?php
defined('_JEXEC') or die;
jimport('joomla.application.component.view');
class SimilarViewAbc extends JViewLegacy
{
function display($tpl = null)
{
parent::display($tpl);
}
}
/views/abc/tmpl/default.php
<?php
echo "Hello World from /views/abc/tmpl/default.php";
Nota: Esta é a solução que eu usaria se tivesse que retornar HTML (é mais limpo e segue a lógica do Joomla). Para retornar dados JSON simples, veja abaixo como colocar tudo no controlador.
Subcontroladores
Se você fizer sua solicitação do Ajax para um subcontrolador , como:
index.php?option=com_similar&controller=abc&format=raw
Do que o nome do seu subcontratado (para a visualização bruta) precisa ser abc.raw.php.
Isso significa também que você terá / poderá ter 2 subcontroladores chamados Abc.
Se você retornar JSON, pode fazer sentido usar format=jsone abc.json.php. No Joomla 2.5. Eu tive alguns problemas para que essa opção funcionasse (de alguma forma, a saída foi corrompida), então usei raw.
Resposta JSON válida (após o MVC novo / legado)
Se você precisar gerar uma resposta JSON válida , consulte a página de documentos Gerando saída JSON
// We assume that the whatver you do was a success.
$response = array("success" => true);
// You can also return something like:
$response = array("success" => false, "error"=> "Could not find ...");
// Get the document object.
$document = JFactory::getDocument();
// Set the MIME type for JSON output.
$document->setMimeEncoding('application/json');
// Change the suggested filename.
JResponse::setHeader('Content-Disposition','attachment;filename="result.json"');
echo json_encode($response);
Você geralmente colocaria esse código no controlador (você chamará um modelo que retornará os dados que você codifica - um cenário muito comum). Se você precisar ir além, também poderá criar uma visualização JSON (view.json.php), semelhante ao exemplo bruto.
Segurança
Agora que a solicitação do Ajax está funcionando, não feche a página ainda. Leia abaixo.
Não se esqueça de procurar falsificações de pedidos. JSession::checkToken()venha a calhar aqui. Leia a documentação em Como adicionar anti-spoofing CSRF aos formulários
Sites multilíngues
Pode acontecer que, se você não enviar o nome do idioma na solicitação, o Joomla não traduzirá as seqüências de caracteres desejadas.
Considere anexar de alguma forma o parâmetro lang à sua solicitação (como &lang=de).
Joomla! Interface Ajax
Novo no Joomla 3.2! - permitiu que você fizesse solicitações de manipulação sem criar um componente
Joomla! Interface Ajax - O Joomla agora oferece uma maneira leve de lidar com a solicitação do Ajax em um plug-in ou módulo. Você pode querer usar o Joomla! Interface Ajax se você ainda não possui um componente ou se precisa fazer solicitações de um módulo que já possui.