Difference between revisions of "How do you put a module inside an article?/pt-br"

From Joomla! Documentation

(Created page with "#Atribua o módulo a '''todos''' os itens de menus. Isso garantirá que ele sempre apareça, não importa como o visitante chegou ao artigo. O módulo não será exibido a men...")
 
(15 intermediate revisions by the same user not shown)
Line 11: Line 11:
 
Para inserir um módulo dentro de um artigo, você publica o módulo em uma posição e carrega essa posição no artigo da seguinte forma:
 
Para inserir um módulo dentro de um artigo, você publica o módulo em uma posição e carrega essa posição no artigo da seguinte forma:
  
#Crie um módulo e defina sua posição para '''''minha posição'''''. '''''minha posição''''' pode ser qualquer valor que não entre em conflito com uma posição do tema existente. Digite a posição '''''minha posição''''' e pressione enter em vez de selecioná-la na lista suspensa.  
+
#Crie um módulo e defina sua posição para '''''minhaposição'''''. '''''minhaposição''''' pode ser qualquer valor que não entre em conflito com uma posição do tema existente. Digite a posição '''''minhaposição''''' e pressione enter em vez de selecioná-la na lista suspensa.  
 
#Atribua o módulo a '''todos''' os itens de menus. Isso garantirá que ele sempre apareça, não importa como o visitante chegou ao artigo. O módulo não será exibido a menos que você coloque o comando para carregar o módulo em um [[S:MyLanguage/article|artigo]].
 
#Atribua o módulo a '''todos''' os itens de menus. Isso garantirá que ele sempre apareça, não importa como o visitante chegou ao artigo. O módulo não será exibido a menos que você coloque o comando para carregar o módulo em um [[S:MyLanguage/article|artigo]].
#Edite os artigos onde deseja que este módulo apareça e insira o texto '''''{loadposition minha posição}''''' no artigo, no local onde deseja o módulo.
+
#Edite os artigos onde deseja que este módulo apareça e insira o texto '''''{loadposition minhaposição}''''' no artigo, no local onde deseja o módulo.
  
{{dablink|*Note that this only works when the [[S:MyLanguage/Help25:Extensions_Plugin_Manager_Edit#Content_-_Load_Modules|''Content - Load Module'' plugin is enabled]]. If this plugin is disabled, the text ''{loadposition myposition}'' shows unchanged in the article.
+
{{dablink|*Observe que isso só funcionará se o [[S:MyLanguage/Help25:Extensions_Plugin_Manager_Edit#Content_-_Load_Modules|plugin ''Conteúdo - Carregar módulo'']] (apenas em inglês) estiver habilitado. Se este plugin estiver desabilitado, o texto ''{loadposition minhaposição}'' será exibido inalterado no artigo.
  
Also, the name of the position should be all lowercase. CamelCapitalization will fail.}}
+
Além disso, o nome da posição deve ser todo em minúsculas. A "CapitalizaçãoCamelo" falhará.}}
  
 
==loadmodule==
 
==loadmodule==
An alternative to "{loadposition xx}" is the "{loadmodule yyy}" variation which is handled by the same plugin.
+
Uma alternativa para "{loadposition xx}" é a variação "{loadmodule yyy}" que é tratada pelo mesmo plugin.
  
In this case the plugin looks for the first module who's '''type''' matches the string 'yyy'. So you could load a "mod_login" module by placing {loadmodule login} in your text. If you wish to load a specific instance of a module, because you have more than one login module e.g. titled as Login 1, Login 2, etc. you have to use {loadmodule mod_modType, modTitle} where mod_'''modType''' would be mod_login and '''modTitle''' is name/title given to your instance of that module. So in the example above you end up with '''{loadmodule mod_login Login 2}'''. You can also add the style that is used for rendering the module. To do so, add the style as the third parameter like {loadmodule login,login2,xhtml}. If you don't add a style, then "none" is used.
+
Neste caso, o plugin procura o primeiro módulo cujo '''tipo''' corresponde à string "yyy". Então você pode carregar um módulo "mod_login" colocando {loadmodule login} em seu texto. Se você deseja carregar uma instância específica de um módulo, talvez pelo fato de você tem mais de um módulo de início de sessão (por exemplo, intitulado como "Login 1", "Login 2", etc.), terá que usar {loadmodule mod_tipodomódulo, títulodomódulo} onde mod_'''tipodomódulo''' seria "mod_login" e '''títulodomódulo''' seria o nome/título dado à sua instância desse módulo. Então, no exemplo acima, você teria '''{loadmodule mod_login Login 2}'''. Você também pode adicionar o estilo usado para renderizar o módulo. Para fazer isso, adicione o estilo como o terceiro parâmetro (como, por exemplo, {loadmodule login,login2,xhtml}). Se você não adicionar um estilo, "nenhum" será usado.
  
 
==loadmoduleid==
 
==loadmoduleid==
Since Joomla! version 3.9.0 an alternative to <code>{loadposition xx}</code> and <code>{loadmodule yyy}</code> is the variation <code>{loadmoduleid z}</code> which is handled by the same plugin.
+
Desde a versão 3.9.0 do Joomla!, uma alternativa para <code>{loadposition xx}</code> e <code>{loadmodule yyy}</code> é a variação <code>{loadmoduleid z}</code> que é tratada pelo mesmo plugin.
  
In this case the plugin looks for the module who's <code>id</code> matches the number <code>z</code>. So you could load the module with id 200 by placing <code>{loadmoduleid 200}</code> in your text. This variant does not "understand" additional parameters like the <code>style</code> parameter.
+
Neste caso, o plugin procura o módulo cujo <code>id</code> corresponde ao número <code>z</code>. Então você pode carregar o módulo com id 200 colocando <code>{loadmoduleid 200}</code> em seu texto. Esta variante não "entende" parâmetros adicionais como o parâmetro <code>style</code>.
  
==Editor Button (since Joomla! version 3.5)==
+
==Botão do editor (desde a versão 3.5 do Joomla!)==
If the editor-xtd plugin "Button - Module" is activated you can use the editor button "Module" to insert above described tags more easily into the editor text. Since Joomla! 3.9 also the <code>loadmouleid</code> variant.
+
Se o "Botão - Módulo" do plugin do editor-xtd estiver ativado, você poderá usar o botão "Módulo" do editor para inserir as tags descritas acima mais facilmente no texto do editor. Desde a versão  3.9 do Joomla! também está disponível a variante <code>loadmouleid</code>.
  
==Modules within Modules==
+
==Módulos dentro de módulos==
It is possible in Joomla! 2.5+ and Joomla! 3.x+ to include a module within a "Custom HTML" module. They are processed by content plugins in the same way as articles.
+
É possível, nas versões 2.5+ e 3.x+ do Joomla!,  incluir um módulo dentro de um módulo de "HTML personalizada". Eles são processados por plugins de conteúdo da mesma forma que os artigos.
  
To make this work, the option '''Prepare content''' must be enabled as shown in this screenshot.
+
Para que isso funcione, a opção '''Preparar conteúdo''' deve estar habilitada conforme mostrado nesta captura de tela.
  
[[File:j3x_custom_html_prepare_content_option-en.png||Showing the Prepare Content option in a Custom HTML module.]]
+
[[File:j3x_custom_html_prepare_content_option-en.png||Mostrando a opção "Preparar conteúdo" em um módulo de "HTML personalizada".]]
  
You should remember when doing this that you might experience formatting issues as the "chrome" of the "Custom HTML" module will surround the "chrome" of the included module potential having undesirable effects of the formatting or layout. That's the reason why the "Module" editor button is not available in modules of type "Custom".
+
Ao fazer isso, você deve se lembrar que pode ter problemas de formatação, pois o "cromo" do módulo de "HTML personalizada" envolverá o "cromo" do módulo incluído, possibilitando causar efeitos indesejáveis de formatação ou disposição (layout). É por isso que o botão "Módulo" do editor não está disponível em módulos dos tipos "Personalizados".
  
 
<noinclude>
 
<noinclude>
[[Category:Content Management FAQ]]
+
[[Category:Content Management FAQ/pt-br]]
[[Category:Article Management FAQ]]
+
[[Category:Article Management FAQ/pt-br]]
 
</noinclude>
 
</noinclude>

Latest revision as of 13:46, 28 July 2022

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎español • ‎français • ‎português do Brasil • ‎中文(台灣)‎
Joomla! 
≥ 2.5
series

Você geralmente desejará associar módulos a artigos de alguma forma. Os módulos são alocados nas posições de módulos e as posições de módulos aparecem em algum lugar na página web conforme determinado pelo tema. No entanto, às vezes é útil ter um módulo realmente incorporado no artigo. O núcleo do Joomla! oferece três maneiras de fazer isso: loadposition, loadmodule e loadmoduleid. O plugin "Conteúdo - Carregar módulos" deve estar habilitado.

Sintaxe:

  • {loadposition position,[style]}
  • {loadmodule mod_type,the title,[style]}
  • {loadmoduleid moduleId}

loadposition

Para inserir um módulo dentro de um artigo, você publica o módulo em uma posição e carrega essa posição no artigo da seguinte forma:

  1. Crie um módulo e defina sua posição para minhaposição. minhaposição pode ser qualquer valor que não entre em conflito com uma posição do tema existente. Digite a posição minhaposição e pressione enter em vez de selecioná-la na lista suspensa.
  2. Atribua o módulo a todos os itens de menus. Isso garantirá que ele sempre apareça, não importa como o visitante chegou ao artigo. O módulo não será exibido a menos que você coloque o comando para carregar o módulo em um artigo.
  3. Edite os artigos onde deseja que este módulo apareça e insira o texto {loadposition minhaposição} no artigo, no local onde deseja o módulo.

loadmodule

Uma alternativa para "{loadposition xx}" é a variação "{loadmodule yyy}" que é tratada pelo mesmo plugin.

Neste caso, o plugin procura o primeiro módulo cujo tipo corresponde à string "yyy". Então você pode carregar um módulo "mod_login" colocando {loadmodule login} em seu texto. Se você deseja carregar uma instância específica de um módulo, talvez pelo fato de você tem mais de um módulo de início de sessão (por exemplo, intitulado como "Login 1", "Login 2", etc.), terá que usar {loadmodule mod_tipodomódulo, títulodomódulo} onde mod_tipodomódulo seria "mod_login" e títulodomódulo seria o nome/título dado à sua instância desse módulo. Então, no exemplo acima, você teria {loadmodule mod_login Login 2}. Você também pode adicionar o estilo usado para renderizar o módulo. Para fazer isso, adicione o estilo como o terceiro parâmetro (como, por exemplo, {loadmodule login,login2,xhtml}). Se você não adicionar um estilo, "nenhum" será usado.

loadmoduleid

Desde a versão 3.9.0 do Joomla!, uma alternativa para {loadposition xx} e {loadmodule yyy} é a variação {loadmoduleid z} que é tratada pelo mesmo plugin.

Neste caso, o plugin procura o módulo cujo id corresponde ao número z. Então você pode carregar o módulo com id 200 colocando {loadmoduleid 200} em seu texto. Esta variante não "entende" parâmetros adicionais como o parâmetro style.

Botão do editor (desde a versão 3.5 do Joomla!)

Se o "Botão - Módulo" do plugin do editor-xtd estiver ativado, você poderá usar o botão "Módulo" do editor para inserir as tags descritas acima mais facilmente no texto do editor. Desde a versão 3.9 do Joomla! também está disponível a variante loadmouleid.

Módulos dentro de módulos

É possível, nas versões 2.5+ e 3.x+ do Joomla!, incluir um módulo dentro de um módulo de "HTML personalizada". Eles são processados por plugins de conteúdo da mesma forma que os artigos.

Para que isso funcione, a opção Preparar conteúdo deve estar habilitada conforme mostrado nesta captura de tela.

Mostrando a opção "Preparar conteúdo" em um módulo de "HTML personalizada".

Ao fazer isso, você deve se lembrar que pode ter problemas de formatação, pois o "cromo" do módulo de "HTML personalizada" envolverá o "cromo" do módulo incluído, possibilitando causar efeitos indesejáveis de formatação ou disposição (layout). É por isso que o botão "Módulo" do editor não está disponível em módulos dos tipos "Personalizados".