View source

Note: This article applies only to Joomla! version 1.0.x. For Administration FAQs for Joomla! version 1.5, see [[:Category:Version 1.5 FAQ]].

=== Why don't all of my menu items show up in the module assignment lists?===

Modules are assigned to specific pages using a list of menu links that is visible when you edit the module in the module manager (on the right of the page). In older versions of Joomla! this list does NOT include menu links of the type "URL."
This is an anomaly from the history of the development of Joomla! carried over from Mambo. Although you can use the URL type for any link, including internal Joomla! links, the original idea was that these would be used for links to external sites which would not display Joomla! modules.
Some Joomla! component extensions use URL links (rather than component links with parameters) as a simple way to access specific views of the components.

'''In Joomla! 1.0.12 and later this issue was partially addressed by allowing modules to be assigned to URL links that did not include ItemId. Therefore, one way to address this issue is to make sure that your site is running the current version of Joomla! and that URL links that are internal to your site do not include ItemId values. '''

=== How do I redirect users after a successful login?===

After logging into the Administration backend, go the module manager. A list of all the modules installed on your site will appear. Edit the one that says "Login Form" under Module Name ("mod_login" under the Type column).

Under Parameters, enter the URL of  page where you want to redirect successful logins to where it says "Login Redirection URL."

=== What do the types of links for menus mean?===

When you create a new link on a menu you need to select from a number of different types of links. Which type you select depends on what you are linking to and how you want it to appear. The following types exist:

'''Content'''

These types allow you to link to a section, a category or individual content items, static content and archives. Sections and categories can be linked either blog style or list/table style. In addition there is a link type that allows submission to specific content sections.

'''Miscellaneous'''

Separator/placeholder allows you to insert a non active link.

Wrapper creates an Iframe which displays an external page within your Joomla! site.

'''Submit'''

Submit--Content allows you to link to a form to submit content to specific sections.

'''Components'''

Component links allow you to link to components you have installed or that are preinstalled in Joomla!. In some instances components will allow you to set parameters to define the display in more detail.
There are also some predefined links to components that are included with Joomla! by default, such as weblinks and contacts.

'''Links'''

Links include specific kinds of links, most of which are also included under other headings. URL link is a generic link that allows you to link any specific url, either internal to Joomla! or externally.

=== How do I get rid of "This Category is Currently Empty"?===

When you make a content category table link to an empty category, by default a "This Category is Currently Empty" message will display (or the equivalent in another language).  You can eliminate or modify this message by editing your language file.

In /language/english.php change line 113 from
   define('_EMPTY_CATEGORY', 'This Category is currently empty');
to
   define('_EMPTY_CATEGORY', <nowiki>''</nowiki>); 

You can also change the text in the menu link to weblinks.

=== How do I add a link to a menu?===

To add a new item to an exisiting menu, you must log in to the administrative interface (back end) of Joomla!

* Go to the menu manager (Menu>>Menu Manager).

* Find the menu you wish to add to and click on the icon in the Menu Items column.

This will give a list of existing menu items.

* To create a new item, click on the New icon.

* Select the type of link you want.

* Click on the continue icon.

* Fill in or select the appropriate information and parameters.

* Save.

Note: For some component links you need to edit the new link in order to apply parameters.


'''1.5'''

* Select the menu item you want from the list displayed.

* Continue making selections until you have reached the end of the choice tree for your menu link type.

=== What is php defined( '_VALID_MOS' ) or die( 'Restricted access' ) ===

Most php files within Joomla! 1.0.x begin with the following statement:

      defined( '_VALID_MOS' ) or die( 'Restricted access' )

This statement checks to see if the file is being called from within a Joomla! session. This protects your site by making it more difficult for a cracker/hacker to damage your site.

However, this line should NOT be included in your main index.php file, since this is the program that starts the Joomla! session.

=== How do I stop users from being able to register?===

Go to your site >> global configuration and change "allow user registration" to no.

=== How do I control whether modules are vertically or horizontally arranged?===

If you edit the html of your template, you will see that each position is assigned to a location using mosLoadModules.

Usually it looks something like this:

 <?php if (mosCountModules('top')>0) mosLoadModules ( "top" ); ?>

By default, modules are arranged in a vertical list. However, you can control this by changing the line. For example, to make a horizontal layout use
 <?php if (mosCountModules('top')>0) mosLoadModules ( "top", 1 ); ?>

For vertical
 <?php if (mosCountModules('top')>0) mosLoadModules ( "top", 0 ); ?>

Here are the definitions of the numbers for mosLoadModules:
1 = horizontal, 0 = normal, -1 = raw, -2 = XHTML and -3 = extra divs.

=== How do you display an RSS feed?===

The easiest way to display an RSS feed is:

In administrator, 

* go to modules>>site modules
* Click new.
* Give it a title
* Scroll down and put the link for the rss feed where it says RSS URL
* Set your details.
* Then display your feed as you would any module.

A second way is to use the News Feeds component that comes with Joomla! 
* In the administrator go to components>>News Feeds
* In the component you can manage your news feeds and assign them to categories.
* To show the feeds on the front end make a component link in your menu.

=== How do I assign a module to a position?===

You assign a module to a position using the module manager.

Modules>>Site Modules

On the left side of the page, on the third line, there is a drop down menu that lets you select the position.
Modules that are not published will not display.

Modules can be assigned to unused positions (positions not in the template) if you want to have them published but not displayed in a position (for example, if you want to display a module in content).

Multiple modules may be assigned to the same position. They will be displayed in the order shown for modules in that position in the module manager.

If you want to display a module in more than one position, use the module manager to copy the module and assign the copy to the second position.

=== How do you put modules in or remove them from specific pages?===

Modules are assigned to "pages" using the module manager. In the administrator (back end) go to 

Module>>Site Modules of 

On the right you will see a list with a heading Pages/Items.

At the top of the list, you can pick all, none or unassigned to make an assignment for the entire site.

Underneath this list, there is a list of all the menu links in your site except those that are of type URL.
Using this list you can select individual pages on which your module will or will not appear.

'''Notes:'''
If your module is assigned to a position that does not exist in the template used to display a page, the module will not appear even if it is assigned to a specific page.

If your module is not published/enabled it will not appear even if assigned to a page.

You cannot assign a module to a URL link. This is because URL links do not have Itemids assigned to them. You also cannot assign modules to pages that are only linked via content or other, non-menu modules, because these also do not have Itemids.

One work-around for this problem is to have an unpublished menu that contains links to the items you wish to link through non-menus. This will create an itemid that can be included in the url you link to. You will see a list with a heading Pages/Items.

At the top of the list, you can pick all, none or unassigned to make an assignment for the entire site.

Underneath this list, there is a list of all the menu links in your site except those that are of type URL.
Using this list you can select individual pages on which your module will or will not appear.

=== How do you change the title of a module?===

From the adminisrator (backend) go to the  module manager ('''1.0''' Modules>Site Modules  '''1.5''' Extensions>Module Manager).
Find the module you want to change and click on its name.
Change the name and save.

=== Can I control what is shown in the Latest News Module?===

Waiting for licensing

=== What does This site is temporarily unavailable - Database ERROR NUMBER CODE mean===

waiting for licensing

=== Why are the admin menus not working or missing?===


waiting for licensing

=== How do I change the footer?===
=== How do I add my own php to a content item?===

You can either create your own joomla component or else install a mambot, such as kl_php or moslate.

Another option is to use the wrapper menu item, so you can add your own custom made php files.

=== How do I recover my admin password?===

'''1.0''' or '''1.5'''

If you know the email address that was used, the simplest thing is to do is to use the "lost password" Front-end function if you have made it available.

If not, you will need access to the MySQL database.

You have two choices, either add a new super administrator or change the password stored in the data base.
To do this you need to go to phpMyAdmin (or use a similar tool) and manually edit the database. Before doing this ''back up our complete database''.

Run this to create a new user known as <var>admin2</var>.

<source lang="sql">
INSERT INTO `jos_users` VALUES 
    (62, 'Administrator2', 'admin2', 'your-email@email.com', '21232f297a57a5a743894a0e4a801fc3',  
    'Super Administrator', 0, 1, 25, '2005-09-28 00:00:00', '2005-09-28 00:00:00', '', '');
INSERT INTO `jos_core_acl_aro` VALUES (10,'users','62',0,'Administrator2',0);
INSERT INTO `jos_core_acl_groups_aro_map` VALUES (25,'',10);
</source>

The password will be <var>admin</var>. Immediately log in and change this password.

Or

You can change the password in the table for your admin user (assuming you never changed the user name; if you have just change the instructions below to .

The password is stored in the MySQL database jos_users table password field. (change this for your table prefix if different)

Open the table, find your admin username, and then select that row for editing.

The password must be hashed, you cannot simply enter text into this field.

Set the password to a known value

<pre>
- password = "this is the MD5 hashed password"
------------------------------------------------------
- admin  = 21232f297a57a5a743894a0e4a801fc3
- secret = 5ebe2294ecd0e0f08eab7690d2a6ee69
- OU812  = 7441de5382cf4fecbaa9a8c538e76783
</pre>

Paste the hashed password into the field, save the change, and log-in using the new password.
Immediately change your password to something more secure!

=== How do I implement the core Search Engine Friendly URLs (SEF) on a Windows Server?===

Many Joomla! Community members are using ther local Windows based PC's to test and develop Joomla! sites on and one of the most frustrating items about Apache on Windows is that Winodws cannot support many of the Apache functions that can be used on Linux/Unix based production sites.

Joomla! SEF Capability on Windows/Apache

1 ) Ensure that you have the Apache Rewrite Module ( mod_rewrite.so ) installed/available in the Apache " modules/ " directory.

2 ) Enable Apache " mod_rewrite " in httpd.conf by removing the " # " ( hash sign ) from the following line in httpd.conf

        # Remove the "#" if it exists from the following line in the modules section
        LoadModule rewrite_module modules/mod_rewrite.so 

3 ) Restart Apache to check that the ReWrite Module is loading correctly and not crashing Apache
        apache -k restart


4 ) Again, modify the following lines in your httpd.conf to support Windows File Naming conventions
<pre>
          # AccessFileName: The name of the file to look for in each directory
          # for additional configuration directives.  See also the AllowOverride
          # directive.
          #
          #AccessFileName .htaccess
          # Allows for Joomla! SEF functionality on Windows (Notice, No dot)
          AccessFileName htaccess
         #
         # The following lines prevent .htaccess and .htpasswd files from being viewed by Web clients.
         #
         #<FilesMatch "^\.ht">
         # Allows for Joomla! SEF functionality on Windows (Notice, No dot)
         <FilesMatch "^\ht">
            Order allow,deny
            Deny from all
            Satisfy All
        </FilesMatch> 
</pre>

3 ) Restart Apache to check that the FileMatch Rule is not in error and not crashing Apache
        apache -k restart

6 ) Rename htaccess.txt to " htaccess " (notice, no "dot", unlike the *nix equivalent)

7 ) Modify $mosConfig_sef = 0 to now be a 1 (turning on SEF)

8 ) Access you local WebSite and check your SEF is working.

=== Can I import users from a CSV file?===

There is not a native bulk import function. However, users can be imported using MySQL. If importing, make sure that each user must have a record in the following tables: jos_users jos_core_acl_aro jos_core_acl_groups_aro_map (assuming that jos is your prefix) Passwords should be encrypted, i.e. in Joomla! 1.0.x  md5(password).

=== Why does the html disappear when I edit in my wysiwyg editor?===

Many of the wysiwyg editors strip all but a limited number of html tags. The list of tags is often configurable. This is to prevent potential problems on your site. You can overcome this limitation by selecting "no WYSIWYG" as your editor (in the user manager or your profile).

Some editors will also allow you to specify which html tags are allowed.

=== Will my existing extensions work in Joomla! 1.5?===

There is a legacy system in place that MAY allow extensions that are not 1.5 compatible to continue to operate. However, we strongly recommend that you update to the current version of all extensions prior to migration and that you check each extension's home page for specific recommendations about migration for that extension. 

It is very wise to use a staging server or test server to try out extensions before deploying them on a production server.

There is no guarantee that all extensions will work.

=== What do I do to prepare to upgrade?===

Prior to migrating a site it is absolutely essential that your database and all files be backed up . It is recommended that you migrate on a copy of your database while leaving your existing site in operation. Once you are satisfied that your 1.5 site is working as expected, you can switch to the new site. If this is not possible because your host limits the number of databases you have available, you can still install the 1.5 files in a new folder. In this situation, you should use the global settings on your old site to take the site offline while you make the transition.

To make a backup of your site, you must backup both the files and the database. There are several extensions which can help with this or you can use the options offered by your host. Ask your host for instructions on how to do a backup if you are unsure.

[[Category:FAQ]]
[[Category:Administration FAQ]]
[[Category:Version 1.0 FAQ]]