In this fourth part I will present and explain the purpose FlexicontentViewItems that will allow us to achieve our template for Item. And so I will detail all the variables that can be helpful in building your own templates.

I will also talk about a lot of functions that can be found with the class flexicontent_html.

This tutorial is still built around my example want to display information about a football stadium.

Contents:

• The purpose FlexicontentViewItems
  • Display a set of field from a position
  • Displays a single field
  • Management comments
  • Do more ...
    • item
    • item-> fields or fields
    • item-> positions
    • use
    • params
    • menu_params
• The class flexicontent_html
  • Function striptadsandcut
  • Function extractimagesrc
  • Function printbutton
  • Function mailbutton
  • Function pdfbutton

The purpose FlexicontentViewItems

This object usable in all template for Item will allow you to bring up all the information related to content.
It is accessible through the $ this variable.
I now resume my item.php file (created in part1 of this tutorial) and I will start by reviewing the header of my.

  A
 2
 3
 4

  / / Prohibits direct access to the file
  '_JEXEC' ) or die ( 'Restricted access' ) ; defined ('_JEXEC') or die ('Restricted access');
  / / Set here the name of the template, in our case. Items.stade
  $this -> tmpl ; $ Tmpl = $ this -> tmpl; 

We will initiate our template then place a div tag by adding css class personalized according to the stage and type of content. For this I use:
$ This-> item-> id = returns the identifier of the content
$ This-> item-> type_id = returns the identifier of the type of content

It gives:

  16

  $this -> item -> id ; ?> type <?php echo $this -> item -> type_id ; ?> "> <Div id = "stade_contenu" class = "item stade_contenu <? Php echo $ this -> item -> id;?> Type <? Php echo $ this -> item -> type_id;?>"> 

Display a set of field from a position

As we saw in part 1 of the tutorial, FLEXIcontent can manage different position where we can place our fields. This entitles the user to place these new fields without modifying the template code.

Just put in our template then a loop that will go through all the fields contained in a given position. Here is the code I would use for each of the positions that I created (header, address, contact, image, description, information, gmap, bottom):

  17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30

  <! - BOF header ->
 <div id="stade_entete">
   ( isset ( $this -> item -> positions [ 'entete' ] ) ) : ?> <? Php if (isset ($ this -> item -> positions ['header'])):?>
     ( $this -> item -> positions [ 'entete' ] as $champ ) : ?> <? Php foreach ($ this -> item -> positions ['header'] as $ field):?>
       $champ -> name ; ?> "> <Div class = "Field_A <? Php echo $ field -> name;?>">
       ( $champ -> label ) : ?> <? Php if ($ field -> label):?>
         $champ -> label ; ?> </div> <div class="etiquette"> <? php echo $ field -> label;?> </ div>
       ; ?> <? Php endif;?>
       $champ -> display ; ?> </div> <div class="valeur"> <? php echo $ field -> display;?> </ div>
       </ Div>
     ; ?> <? Php endforeach;?>
   ; ?> <? Php endif;?>
 </ Div>
 <! - EOF header -> 

Explanation:

isset ($ this-> item-> positions ['header']) / / indicates whether the fields are displayed or not in this position
php foreach ($ this-> item-> positions ['header'] as $ field): / / search all the fields content of the position
$ Field-> name / / returns the name of the field, I use it to declare a unique CSS class that will allow me then to format my field as I want
$ Field-> label / / returns the label of the field where I chose my settings in the field I chose to make it appear.
$ Field-> display / / displays the field value formatted according to the parameters that I set up (prefix + value + suffix)

Displays a single field

It is also possible to display a field directly without the position. This can sometimes be useful to make a simple template without any positions (which are heavier in terms of code). I will use this part of code to display my image "image_stade."

  62
 63
 64
 65
 66
 67
 68

  <! - Soundtrack image ->
 <div id="stade_image">
 <div class="champ_image_stade">
 $this -> fields [ 'image_stade' ] -> display ; ?> <? Php echo $ this -> fields ['image_stade'] -> display;?>
 </ Div>
 </ Div>
 <! - EOF image -> 

To go directly to the values ​​and parameter fields, use the $ this-> fields ['myfield'].

Management comments

I only get the original source code of FLEXIcontent to bring up the comments:

  130
 131
 132
 133
 134
 135
 136
 137
 138
 139
 140
 141
 142
 143
 144
 145
 146
 147
 148
 149
 150

  ( $this -> params -> get ( 'comments' ) ) : ?> <? Php if ($ this -> params -> get ('comments')):?>
  <! - BOF comments ->
  <div class="comments">
  <? Php
  $this -> params -> get ( 'comments' ) == 1 ) : if ($ this -> params -> get ('comments') == 1):
    file_exists ( JPATH_SITE . DS . 'components' . DS . 'com_jcomments' . DS . 'jcomments.php' ) ) : if (file_exists (JPATH_SITE. DS. 'components.' DS. 'com_jcomments.' DS. 'jcomments.php')):
      JPATH_SITE . DS . 'components' . DS . 'com_jcomments' . DS . 'jcomments.php' ) ; require_once (JPATH_SITE. DS. 'components.' DS. 'com_jcomments.' DS. 'jcomments.php');
      showComments ( $this -> item -> id , 'com_flexicontent' , $this -> escape ( $this -> item -> title ) ) ; echo JComments: showComments ($ this -> item -> id, 'com_flexicontent', $ this -> escape ($ this -> item -> title));
    endif;
  endif;

  $this -> params -> get ( 'comments' ) == 2 ) : if ($ this -> params -> get ('comments') == 2):
    file_exists ( JPATH_SITE . DS . 'plugins' . DS . 'content' . DS . 'jom_comment_bot.php' ) ) : if (file_exists (JPATH_SITE. DS. 'plugins'. DS. 'content'. DS. 'jom_comment_bot.php')):
      JPATH_SITE . DS . 'plugins' . DS . 'content' . DS . 'jom_comment_bot.php' ) ; require_once (JPATH_SITE. DS. 'plugins'. DS. 'content'. DS. 'jom_comment_bot.php');
      $this -> item -> id , 'com_flexicontent' ) ; JomComment echo ($ this -> item -> id, 'com_flexicontent');
    endif;
  endif;
  ?>
  </ Div>
  <! - EOF comments ->
 ; ?> <? Php endif;?> 

Through $ this-> params-> get ('comments'), it allows me to retrieve the parameters of FLEXIcontent and so I have to show whether or not commantaires. (0 = no comments, 1 = 2 = JComments and Jom Comment)
FLEXIcontent can integrate the management comments of two components JComments (recommended) and Jom Comment.
So the parameters for the comments are directly managed via the component that is integrated.

Do more ...

Through the following chapters, I showed you how to display fields so basic, it may be that sometimes you need to go a little further into your template. Here are the most important information you can use in your template.

Item

This object contains all information about your content directly
A call in this way $ this-> item-> "ownership"

item-> fields or fields

This way you can get all the information about the fields in your template, either for the core fields (title, text, but all your custom fields (such as you have named) that are associated with the type being displayed.
A call in this way $ this-> item-> fields ['field name'] -> "property" or so $ this-> fields ['field name'] -> "ownership"

Each field also has parameters that can be recovered in this way (subject JParameter):
$ This-> item-> fields ['field name'] -> parameters-> get ('parameter')
Here are the main parameters that can be found, not all are used depending on the type of field.

item-> positions

As discussed previously you can browse through all positions of a template to display your fields. Here is the detailed information you can use.
A call in this way $ this-> item-> positions ['name of position] [' field name '] -> "ownership"

use

This object type juser gives you information about the currently logged
A call in this way $ this-> user -> 'property'

params

It is an object JParameter that will allow us to find the parameters related to the content.
$ This-> params-> get ('parameter')

menu_params

It is an object JParameter that will allow us to recover the parameters associated with the menu of the contents that must be displayed.
$ This-> menu_params-> get ('parameter')

The class flexicontent_html

This class of FLEXIcontent offers some useful features for our templates.

Function striptagsandcut

This feature allows us to remove html tags from a text and cut cleanly after a certain number of characters.

  / / This example will format and truncate after 100 characters $ my_text
 striptagsandcut ( $mon_texte , 100 ) ; echo flexicontent_html: striptagsandcut ($ my_text, 100); 

Function extractimagesrc

This feature allows us to generate an image tag from a field of type image.

  / / This example will format and truncate after 100 characters $ my_text
 extractimagesrc ( $this -> fields [ 'mon_champ_image' ] ) ; echo flexicontent_html: extractimagesrc ($ this -> fields ['mon_champ_image']); 

Function printbutton

This function displays the button and the link to print the current content

  / / This example will display the Print icon in our content
 printbutton ( $this -> print_link , $this -> params ) ; echo flexicontent_html: printbutton ($ this -> print_link, $ this -> params); 

Function mailbutton

This function displays the button and the link to recommend active content in mail

  / / This example will display the icon Send mail to our content
 mailbutton ( 'items' , $this -> params , null , $this -> item -> slug ) ; echo flexicontent_html: mailbutton ('items', $ this -> params, null, $ this -> item -> slug); 

Function pdfbutton

This function displays the button and the link to generate active content in pdf

  / / This example will display the icon in our PDF content
 pdfbutton ( $this -> item , $this -> params ) ; echo flexicontent_html: pdfbutton ($ this -> item, $ this -> params); 

This is the fourth game is over, the next time I will address the templates category. Once again please make your comments or to ask questions if you do not understand something.