You logged in as Guest
Login:
Recent messages · Members · Forums rules · FAQ · SEARCH Registration · Log in

Page 1 of1
UcoZ Community » UcoZ System management and tuning » Design customization » Conditional operators (<?if($VAR$)?>...<?else?>...<?endif?>)
Conditional operators
SunnyDate: Wednesday, 2008-03-26, 3:47 Am | Message # 1
Constant
Group: Administrators
Messages: 260
Reputation: 20 [6%]
Status: Offline
Conditional operators for noobs and professionals.

If you do not understand how conditional operators work and the information in the Control Panel is not enough for you, I will try to explain. First, you should believe, that it is very easy!

Conditional operators are special codes-symbols, which can perform certain scenarios (scripts). You can create an absolutely new option on your site that is not provided in the Control Panel.

First, you must understand and get used to the components of the script code. They are:

<?if($code$)?> – it is some condition (code), which points to the operator whom and what we are dealing with. We can mentally replace it by the phrase «If there is»;

<?else?> – it is the operator which will do what you say if the condition corresponds to the indicated ones. Replace it mentally by the phrase «If not»;

<?endif?> – it is the end of the conditional operator, replace it mentally by «The end»;


Now let’s examine an easy example from the Control Panel:

(from Page Editor)

<?if($USER_LOGGED_IN$)?> Hello, $USERNAME$ <?else?> You are a GUEST. Please, register. <?endif?>

In our language it means: «If there is an authorized user, then «Hello, his/her login!», if not, «Hello, guest!» and the end.»

Now the details.

What did we use?

We said to <?if($code$)?> operator that our script is intended for saying hello to authorized users. We put the following code instead of $code$ - $USER_LOGGED_IN$ , i.e. we said «If there is an authorized user - <?if($USER_LOGGED_IN$)?>». Then the information, available only to authorized users, follows. At the same time, we may use conditions if they do not correspond to the indicated ones, in our example it is Guests. Therefore, after the information for registered users we enter the information for guests.

We get
<?if($USER_LOGGED_IN$)?> Hello, $USERNAME$ <?else?> Hello, Guest!

Now we have just to close it.
<?if($USER_LOGGED_IN$)?> Hello, $USERNAME$ <?else?> Hello, Guest! <?endif?>

We can also exclude Guests and display information for registered users only. For this purpose we just do not use «If not». We get the following:

<?if($USER_LOGGED_IN$)?> We are glad that you have registered! <?endif?>

It means that only those who have logged in will see the phrase «We are glad that you have registered!».

Any code, specified as working for a certain module, can be a condition for the work of operators. In our case (Page Editor), the following examples can be used:

Login and logout:
<?if($USER_LOGGED_IN$)?> <a href="$LOGOUT_LINK$">LOG OUT</a> <?else?> <a href="$LOGIN_LINK$">LOG IN</a> <?endif?>

Days after registration:
<?if($USER_LOGGED_IN$)?> You are with us for $USER_REG_DAYS$ days! <?else?> Please, register. <?endif?>

And so on.


Conditions for a script can be changed by means of additional capabilities, supported by the operators. They are «=», «>», «<» signs. If necessary, the equated conditions are separated by a vertical line. After the sign, you say to the operator to whom the whole script is directed.

<?if($code$='condition')?> I can see this <?else?> And here I can see this <?endif?>

Or

<?if($code$='condition')?> The main thing is that I can see this <?endif?>

Example:

<?if($USER$='John')?> John, don’t forget to read e-mail every day. <?endif?>

It means «If there are usernames and there is John among them (='John'), then this is to be displayed to him…»

The same is with groups, names, gender, date etc.
More examples:

<?if($USER$='Mike' or $USER$='Lola')?> Mike and Lola, here is a secret link …. <?endif?>

Groups:
<?if($GROUP_ID$=3 or $GROUP_ID$=4)?> Moderators and Administrators, click on the ad here… <?endif?>

And so on.

However, operators can work in each other. Example:

<?if($USER_LOGGED_IN$)?> Hello $USER$! <?if($GROUP_ID$=3 || $GROUP_ID$=4)?> Don’t forget to click on the ads! <?endif?> <?else?> Please, register. <?endif?>

The script is the following: «If there are logged-in users, then Hello, if there Administrators and Moderators among them, then add Click on ads, if there are unregistered users, we ask them to register, and the end.»


The main thing is that you must think well how to write a script, what codes to use and whom they will be directed to. You may write anything, UcoZ is very flexible!

Additional mini-info:


  • The number of <?if($code$)?> and <?endif?> must be the same.
  • <?else?> is necessary if we output information for those, who don’t meet the conditions, otherwise it is not needed.
  • Alternative conditions or and and (|| and &&) are supported.
  • Nesting of operators is supported.
  • Comparing of variables to each other is supported: <?if($VAR1$=$VAR2$)?>
  • The text must be in quotes when comparing: <?if($USER$='Mike') ?>
  •  
    UcoZDate: Wednesday, 2008-03-26, 3:55 Am | Message # 2
    UcoZ Admin
    Group: Administrators
    Messages: 229
    Reputation: 19 [6%]
    Status: Offline
    Question - answer
    Quote
    When creating new pages, uploaded via FTP, $SITE_NAME$, $LOGIN_LINK$, $LOGOUT_LINK$ codes are displayed as text... Why don’t they work?

    $Codes$ work only on dynamic pages, i.e. pages, created in the Control Panel by means of "Create page" option. These $Codes$ don’t work on uploaded static pages with .html extension.
    Quote
    How can I make alternative conditions, e.g. for $GROUP_ID$ code?

    <?if($GROUP_ID$=5 or ($GROUP_ID$=4 and $USER$='Alex'))?>...<?endif?>
    Quote
    Are there operators, which allow a user to see in the list only the categories, to which he/she has access?

    It can be done by forming the list of categories manually, i.e. you check current group and output the necessary list of categories. At the next level, check against necessary section.
    Quote
    $GROUP_ID$ doesn’t work in Tag Board template, why?

    Tag Board messages are cached, so you cannot use there dynamically variable codes.
    Quote
    There is $USER_LOGGED_IN$ code. Is there $USER_LOGGED_OUT$ code?

    You should just add negation to the condition <?if(!$USER_LOGGED_IN$)?>


    Hint: you can do the following

    Code
    <img border="0" src="/path_to_file/group$GROUP_ID$.gif">

    And display in such a way the necessary image for each group.
    Note

    There is a link to the help on conditional operators in the Control Panel, there you can find out what conditional blocks mean and can see the examples.

     
    UcoZ Community » UcoZ System management and tuning » Design customization » Conditional operators (<?if($VAR$)?>...<?else?>...<?endif?>)
    Page 1 of1
    Search: