JHTML::_('behavior.modal', $selector, $arrayparams)

Calls javascript to display ligthboxes, popups with good visual appearance, to display images, external pages, or views of own component.

Defined in

/joomla/html/html/behavior.php ( line 117 )

Importing

JHTML::_('behavior.modal');
Note: This is the basic import. If someone more know the adicional params, please email me.

Examples

The code below illustrates how to call an external site to open in a lightbox

<?php JHTML::_('behavior.modal'); ?>
<a rel="{handler: 'iframe', size: {x: 750, y: 600}}" 
href="http://www.fititnt.org/joomla-api.html" target="_blank"> Click me :D</a>

Output :

   Click me :D

The code below illustrates how to receive data from a view called the lightbox - Good for complex popups

Description: On this example you will need make a new component or implement in your component. At the end of this page you will find one download link to one example component that is done with this logic.

<?php
JHTML::_('behavior.modal');
$jspop2 = "<script type=\"text/javascript\">
               function jSelectPopupfromview(vara, varb) {
                       document.getElementById('pophello1').value = vara;
                       document.getElementById('pophellohiden1').value = varb;
                       document.getElementById('sbox-window').close();
               }
  </script>";
$document =& JFactory::getDocument();
$document->addCustomTag($jspop2);
?>

On the same file, add this form com_wedmodal/views/wedmodals/tmpl/default.php:

<form method="post" name="adminForm" id="adminForm" />
<input name="pophello1" id="pophello1" type="text" />
<input name="pophellohiden1" id="pophellohiden1" type="hidden" value="value" />
<a rel="{handler: 'iframe', size: {x: 950, y: 200}}" 
href="/component/wedmodal/?controller=popup&task=mypopuptask&tmpl=component" 
class="modal" target="_blank"> Take data from view</a>
  <input type="submit" value="Submit" />

Ok. Now you have the basic main page to receive the data. But as you see on heref of the link on last code, you will need call one task from the controller. Lets put code of the task mypopuptask on com_wedmodal/controllers/popup.php:

class WedmodalsControllerPopup extends WedmodalsController
{
    /**
     * constructor (registers additional tasks to methods)
     * @return void
     */
    function __construct()
    {
        parent::__construct();
    }// function
    
    function mypopuptask() {
    //Here you set what the task will do
    //Set the View
     $view = & $this->getView('popup', 'html');
    // Get/Create the model
    $model = & $this->getModel('popup');        
    // Push the model into the view (as default)
    $view->setModel($model, true);
    // Display the entire view
    $view->display($tpl = null);
    } 
}// class

On last controller code, you will call one Model 'popup' that in this example no do not have some special code. Just add one empty model with the class WedmodalsModelPopup for do not have errors.

Also, on com_wedmodal/views/popup/view.html.php do not need any special code, just add like any other view.html.php

Finaly, we will set what will appear on com_wedmodal/views/popup/tmpl/default.php, the real content that you will see when click on link of this fist code of this example:

<a onclick="window.parent.jSelectPopupfromview('Hiho World :D',
'I have one secret for you');"> Click me world!  </a>

The code below illustrates how to receive data from a funtion inside of view.html.php called the lightbox - Good for simple popups

Download example code

Component WEDModal

See also

API JHTML

DOCs

JHTML::image($url, $alt, $arrayattribs)

Write a < img > < /img > element
(string $url, string $alt, [array $attribs = null])

Defined in

/joomla/html/html.php

Importing

jimport('joomla.html.html');

Examples

jimport('joomla.html.html');
echo  JHTML::image('images/save.png','save.png');

Output :

See also

API JHTML

DOCs

Atualmente, não se tem muito conteúdo realmente explicando como programar em joomla, a não ser alguns livros em inglês. Mesmo a wiki oficial ( aka docs.joomla.org ) não tem tudo que deveria em tese ter. A API é sempre a API, e estará lá porque é um pre-requisito minimo que se deveria ter, e a equipe oficial de documentação faz questão de pelo menos isso deixar bem organizado. Mas... e o resto? Cada um tem que eu correr atrás, ou então vai sofrer, porque muit coisa falta, e que só é abrangida por alguns livros em inglês, ou nem isso. O que acredito que vou fazer é fazer documentação de alguns detalhes que hoje não estão no docs.joomla.org, e esse blog vai servir como rascunho ou pelo menos um ponto fixo de onde qualquer conteúdo que eu publique em outros sites, haverá uma cópia aqui também.

Espero que seja útil aos programadores que querem encarar joomla um pouco mais a sério, ou também a usuáriso comuns que estão passando pro algum detalhe ou querem fazer algo um pouco diferente e que com algum empurraozinho vão conseguir.

Um detalhe importante a ressaltar é que, embora o layout aqui seja do tipo blog, alguns desses artigos que estou escrevendo referente a API não estão prontos e, dentro do possivel, estarão sendo atualizados com alguma frequência, até terem um contedúdo relativamente 'sólido' e que não precise de mais atualizações.

Outro ponto importante também, é que sim, pelo menos por enquanto o que é relativo a API está e vai ser escrito em inglês. Como estou preparando para publicar em no Joomla Docs, jpa vou deixar preparado em inglês. De qualquer forma, em geral não vai ser complicado para quem quer programar ler os exemplos aqui. Ainda mais por ser inglês tecnico, e boa parte das principais palavras se repetirem.

JHTML::link($url, $text, $arrayattribs)

Write a element
(string $url, string $text, [array $attribs = null])

Defined in

/joomla/html/html.php

Importing

jimport('joomla.html.html');

Examples

Code:

jimport('joomla.html.html');
echo  JHTML::link('http://www.joomla.org','Joomla Site');

Output :

See also

JOOMLA API

JOOMLA DOCs