2008-01-19T22:54:00Z

Mroswell: /* short and sweet */

Joomla! is a terrific content management system.

* Installation is straightforward.
* Websites are easy to maintain
* Lots of built-in features
* Lots of extensions available for things like video display, image galleries, event management, tagging, document management, etc.
* Many free and commercial templates are available to make your website attractive.

'''Main Joomla! website'''
http://www.joomla.org

Joomla Support forums
http://forum.joomla.org/

Joomla!

2008-01-19T22:48:21Z

Mroswell: New page: {{inuse}}

JDOC:Joomla! Doc Sprints/Start Here

2008-01-19T22:48:03Z

Mroswell: /* Doc Camp Cookie Jar */

__NOTOC__
{| cellspacing="0" cellpadding="0" style="margin:0em 0em 1em 0em; width:100%"
| style="width:50%; vertical-align:top; border:1px solid Gold; background-color: LightYellow;" rowspan="1"|
<div style="border-bottom:1px solid Gold; background-color:#ffffaa; padding:0.2em 0.5em 0.2em 0.5em; font-size:110%; font-weight:bold;">Instructions</div>
<div style="padding:0.4em 1em 0.3em 1em;">
Below is a list of tasks, categorised by intended audience. There will be overlap so treat this as a rough guide only. Please feel free to add new topics to this list.

To start writing on a topic, change the item in this list into a link (unless it's already a link of course!). To do this you simply surround the text by a pair of square brackets. For example, to make "text" into a link, change it to <nowiki>"[[text]]"</nowiki>. Save your change. The link text should now appear in red. Click on this new link and you will be taken to an editor screen for the new page. Enter your new topic text and click save. Simple as that. If you encounter any problems, ask for help on the [irc://irc.freenode.net/joomladocs IRC channel].

'''When you begin editing a page please add <nowiki>{{inuse}}</nowiki> to the top of the page before you start working on it so that others do not create conflicting changes to the same page. And don't forget to remove it again when you have finished! Thank you.'''
</div>

| style="padding:0em 0.5em 0em 0.5em;" |

| colspan="1" style="width:50%; vertical-align:top; border:1px solid #abd5f5; background-color:#f1f5fc;" |
<div style="border-bottom:1px solid #abd5f5; background-color:#d0e5f5; padding:0.2em 0.5em 0.2em 0.5em; font-size:110%; font-weight:bold;">Reference Information</div>
<div style="padding:1em 1em 1em 1em;"> 
* If you are new to MediaWiki then you should consult the '''[http://meta.wikimedia.org/wiki/Help:Contents User's Guide]''' for information on using the wiki software.
* List of '''[[local wiki templates]]''' that can be used in your wiki pages. Templates reduce repetition and are the basis of modular documentation.
* List of '''[[local wiki extensions]]''' that have been installed on this wiki. Extensions provide additionally functionality to the wiki such as syntax highlighting and conditional expressions.
* List of '''[[local interwiki links]]''' that are available on this wiki. These provide useful shortcuts to creating URLs to other websites including the Joomla! forum, help screens and issue tracker; as well as links to the PHP documentation.
* Please read the '''[http://help.joomla.org/workshop/documents/Editorial%20Style%20Guide%20v1.0.5.pdf Joomla! Editorial Style Guide]'''.
</div>
|}

==Doc Camp Cookie Jar==
This is a list of small tasks that should be quick to get done and might be a good introduction to working on the documentation.
* [[Joomla!]] - basic introduction to what Joomla! is, why you might want to download it, and where to go to get more information.
* [[Copying a Joomla website]]
* [[Using an FTP client to upload files]]
* [[Using a terminal session]]
* [[Migrating from 1.0.x to 1.5 Stable]] - see [http://dev.joomla.org/component/option,com_jd-wiki/Itemid,/id,migration:migration-component/]

==Audience: Users/Administrators==
Users are visitors to a Joomla! website; administrators are people who install and maintain the website. The assumption is that these people will not know how to write code.

* [[Installation notes for specific platforms]]
* [[Help screens]].
* [[Marketing Information]] such as features and benefits.
* Create one or more demo/showcase sites then create tutorials explaining how each was put together. For inspiration see: [http://www.adobe.com/devnet/blueprint/]
* [[Beginners|Absolute Beginners Guide to Joomla!]]
* [[Landing Pages]] for this wiki.
* [[FAQs]] Frequently Asked Questions

==Audience: Web Designers==
Web designers are those people tasked with creating a Joomla! website that will later be looked after by an administrator. These people can be assumed to know about HTML and CSS but may have only minimal knowledge of PHP.

* [[Creating clickable background images using CSS]].
* There is quite a lot for web designers in the [[Joomla! 1.5 Template Tutorials Project]]. In particular, look at the [[Outline for Template Tutorials]].
* [[jdoc statements]] for templates
* Modify the [[favicon]]

==Audience: Core Developers==
By "core developers" we mean developers who are contributing to the Joomla! core distribution which includes the core extensions as well as the Framework.

* Developer guidelines.
* Participating in the community: a brief description of how people can get involved.
* Coding style and standards.
* Secure coding guidelines.
* Error message conventions.
* Exception handling.
* [[Patch submission guidelines]].
* [[Filing bugs/issues]].
* [[How to release a distribution tarball]].
* Release numbering, compatibility and deprecation.
* Localisation (L18N): an explanation of how localisation is implemented in Joomla! 1.5 and how to use it.
* [[Routing]]: how it works and how to use it

==Audience: Third-party Developers==
By "third-party developers" we mean developers who are working on extensions to Joomla! (components, modules, plugins and templates) which are made available separately from the Joomla! distribution.

* Complete/update/review the wiki API reference (assumes this has been moved from DocuWiki to MediaWiki).
* Update developer tutorials and how-to's currently on dev.joomla.org
** Review all material under the tutorials heading at http://dev.joomla.org/component/option,com_jd-wiki/Itemid,32/
** Recommend material to be migrated over to docs.joomla.org
** Update material that is to be migrated over to docs.joomla.org
* [[How to debug your code]].
** Write a tutorial giving debugging tips for new developers. Perhaps list different kinds of problems code might have and suggested approaches to locating the problem and fixing it.
* [[Using the core parameter types]]
* [[Creating custom XML parameter types]].
** Write a document detailing the steps to creating a custom XML Parameter type. Explain how these types can be used in templates, modules, components and plugins.
* [[Creating component preferences]].
** Write a document describing how to create an xml file for modifying component preferences and how to add a Parameters button to an administrator toolbar.
* [[Adding JavaScript and CSS to the page]].
** Write a document describing how to add JavaScript and CSS to the page. Explain how to decide whether JavaScript should go in the head block or in the page itself and how to insert the JavaScript.
* [[Accessing the current user object]].
** Write a document describing how to access the current user object and also indicate what type of information can be found in the object, and how that data should be retrieved and/or set.
* [[Adding AJAX to your component]].
** Write a document describing how to add AJAX to an MVC component. If desired, use the MVC Hello World tutorial as a base. Describe where various elements should go in the MVC design pattern. Also describe how to implement MVC in a module (these need supporting components to do AJAX).
* [[Using JPagination in your component]] (frontend and backend).
** Describe the steps necessary to add pagination to a component using the JPagination class. Describe the differences between frontend and backend.
* [[Creating a toolbar for your component]].
* [[Adding configuration objects to modules and plugins]].
* [[Storing data in the session between page loads]].
* [[Using the caching system in your component]].
* [[Creating a file uploader in your component]].
* [[Suppressing output of extra HTML]].
* [[Supporting plugins in your component]].
** Explain how to add triggers so that your component can fire custom events.
* [[Adding multi-language support]].
* [[Retrieving data from GET and POST requests]] - the Joomla! way.
* [[Adding view layout configuration parameters]].
** Explain how to create an XML file that will allow users to configure views.
* [[Using the installer API to support package installation]].
** Explain how to use the JInstaller API to install add-ons to components
* [[How to implement XML-RPC in a component]]
** There are two ways to do this:
*** Implement it using an XML-RPC plugin
*** Implement it in the component itself using raw views
* [[How to use the filesystem package]]
* [[How to use the filter package]]
** Describe how and when to use the Filter package and explain what needs to be filtered for various situations (for queries, for URLs, etc)
* [[How to use the registry package]]
* [[How to use JSimpleXML]]
** How to load and store XML files and how to work with them
* [[How to use JDate]]
** What JDate does and how to use it...
* [[How to add CSRF anti-spoofing to forms]]
** How to use JHTML::_( 'form.token' ) and token checking to secure components
* [[How to add breadcrumbs]]
* [[How to use the JTable class]]
* [[How to create component feeds]] (RSS/ATOM)
* [[How to create PDF views]]
* [[How to send email from components]]
* [[What's available in the JFactory class]]
* [[How to generate paths for client side and server side]]
* How to access information from the request/browser
** This focuses on using the JBrowser class to retrieve information about the features available in the user's browser.
* [[How to create a search plugin]] (To be reviewed)
* [[How to create a content plugin]]
* [[How to create an editor plugin]]
* [[How to create a system plugin]]
* [[What can be done with a user plugin]]
* [[How to create a module]]
* [[How to create a stand-alone application using the Joomla! Framework]]
* [[How to work with parameters]]
* [[How to use the JToolBar class in the frontend]]
* [[How to create a custom button]]
* [[How to use the editor in a component]]
* [[How to use the JPane classes in a component]]
* [[How to cloak email addresses]]

==Audience: Testers==
These people may be testing functionality from a user perspective; or they may be developers testing the code itself.

* Automated testing.

==Audience: Various==
Stuff that pertains to multiple audiences.

* [[Joomla! 1.5 Template Tutorials Project]]
* Integrate GHOP student work
* [[:Category:Landing Pages|Landing pages in this wiki]]
* Pages that define terms can be added to the [[:Category:Glossary|Glossary]] category by adding <nowiki>[[Category:Glossary]]</nowiki> at the end of the page.

==Audience: Documentors==
This is meta documentation for use by the Documentation Working Group and other documentors.

[[MediaWiki setup notes]]

==License==
{{license}}

[[Category:DocCamp]]

Joomla

2008-01-19T22:47:21Z

Mroswell: /* replacing with version with exclamation point */

Joomla

2008-01-19T22:46:44Z

Mroswell: New page: {{inuse}}

Using an FTP client to upload files

2008-01-19T22:45:32Z

Mroswell:

Since many hosting companies do not allow their users shell/local access to their files, users wishing to send (upload) new files to their hosting space must make use of a File Transfer Program. [[wikipedia:FTP_client|FTP]] clients allow users to upload files that have been locally edited to a server. There are a variety [[wikipedia:FTP_client|FTP]] clients available and [[wikipedia:Comparison_of_FTP_clients|this chart]] nicely details the strengths of numerous popular programs, many of which are open source and/or free to download.

If you are using Firefox, may we suggest [http://fireftp.mozdev.org/ FireFTP] as a useful add-on.

You may want enable the display of hidden files so that you don't lose your .htaccess file (on a linux box) when you upload.

Portal:Beginners

2008-01-19T22:39:25Z

Mroswell: /* */

=Absolute Beginners Guide to Joomla!=

Welcome to Joomla!, a leading open-source Content Management System (or "CMS") platform. You have made a great choice to use Joomla! for your website. Joomla! is a well-tested, extensible and effective tool supported by a very active and friendly community of developers and users.

'''Planning Your Web Project'''

Before you get your feet wet with Joomla!, you may want to think about the bigger picture aspects of your Web site. For example, most Web site projects benefit from advanced planning and defining the nature and scope of your project. Ask yourself questions like:
* What do you want to accomplish with your website?
* What is the nature and quantity of content you wish to present?
* Who is your audience, and how do you want to interact with them?
* What types of budgets or timetables are you working within?
* Writing down these key questions and their answers will help focus your efforts and guide the decisions you make as you implement your project.

'''So what is Joomla!, and what can it do for my Web site?'''

Joomla! is a Content Management System (or "CMS") which enables easy control and editing of the content and presentation of your website. With Joomla!, you can do things like:
<ul><li>Edit the content of every page of your site through a word processor-style interface.</li>
<li>Add new pages to your site using a point-and-click interface.</li>
<li>Add images and other media through Web-based uploads.</li>
<li>Control site elements like navigation menus and page layout.</li>
</ul>
Many additional functions are available within Joomla!'s default user interface. Essentially, Joomla! removes the need to have a "geek" involved in the day-to-day management of your Web site content: If you are able to surf the Web, interact with Web-based forms and interfaces, and handle basic desktop computing tasks, you will be able to use the Joomla! interface to manage the content of your Web site.

Out of the box, Joomla! provides all of the primary functions of managing Web page content. It also includes a number of specialized elements which support specific functionality, for example, end user registration, interactive polls, advertising banners, a contacts directory, and much more. Included with Joomla!'s native capabilities is an "Extensions" system which enables additional features via third-party Extensions software packages. (See http://extensions.joomla.org for more information.)

Joomla!-powered Web sites are different from Web sites which contain manually updated, or "static," HTML files. Instead, Joomla! is a dynamic Web application. Joomla! uses a database (MySQL) to store all of the content and information about your site, and it uses a programming language (PHP) to power Joomla!'s interactive functionality and dynamic Web pages.

'''How much knowledge do I need to implement Joomla! ?'''

Although a low level of technical knowledge is required to use Joomla! on a day-to-day basis, you will need to know a bit more in order to install it. Joomla!'s installation process includes uploading files to a Web server via FTP, creating a new mySQL database, and then proceeding through Joomla!'s Web-based installation wizard. (Fortunately, many Web hosting companies include Web site control panels which make it easy to handle technical tasks, including adding a mySQL database, and installing Joomla!.)

Customizing the structure, content and presentation of your Joomla! site involves working within Joomla!'s Web-based interfaces; if you want to significantly change the Web site design from the default templates, you will need to either install a third-party template package or create your own template out of Web-ready images and HTML, Cascading Style Sheet and/or Javascript code.

Knowledge of the PHP programming language or programming concepts in general is '''not''' required in order to install, customize and administer Joomla!

This was originally [http://forum.joomla.org/index.php/topic,47524.0.html here]. This is its new home.

[[Category:Landing Pages]]

You want to install joomla, now!. Please follow the available documentation for the installation process:
[http://downloads.joomlacode.org/docmanfileversion/1/7/4/17471/1.5_Installation_Manual_version_0.5.pdf Manual_version_0.5]

Let's make a quick review of the installation instructions provided:
<ul>
<li>Requirements</li>
<li>Download Joomla!</li>
<li>Upload files and create database</li>
<li>Install (Web or Manually)</li>
<li>Known Issues</li>
</ul>

After follow the steps described above, you will probably have a functional Joomla! site, what's next?, made it your own site by custom features:
<ul>
<li>[http://help.joomla.org/component/option,com_easyfaq/task,view/id,167/Itemid,268/ Check security]</li>
<li>Look for 3rd party extensions for Joomla</li>
<li>Subscribe to the security forums</li>
</ul>

As a general rule, minimize 3rd party software, please look first in the
[http://help.joomla.org/component/option,com_easyfaq/task,view/id,186/Itemid,268/ 3rd party black list]

Now, with basic security enabled, the minimum 3rd party modules activated, is time to plane your support plan, yeah!
<ul>
<li>Backup, BACKUP, BACKUP</li>
<li>Implement a offline version of your site for testing</li>
<li>Perfom statistics of your site, and keep an eye in logs</li>
</ul>

Archived:Administration FAQs Version 1.0

2008-01-19T22:29:25Z

Mroswell:

{{review}}

=== 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).

'''1.0.x'''

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

'''1.5'''

Select the redirection page from the list of menu links offered. Make sure that the link is to a published item.

Note: The same procedure is used for redirecting users on successful logout except you enter the page where you want to redirect successful logouts to where it says "Logout Redirection URL."

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

''' VERSION 1.0'''

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.

'''VERSION 1.5'''

'''Articles'''

This gives you access to content.

You can then choose from section, category, archive, articles, front page.

Within section, category and archive you can choose list or blog layouts.

'''Blog Layout'''

Blog layout will show a listing of all Articles of the selected blog type (Section or Category) in the mainbody position of your template.

'''List Layout'''

Table layout will simply give you a tabular list of all the titles in that particular Section or Category.

'''Wrapper'''

Wrappers allow you to place stand alone applications and Third Party Web sites inside your Joomla! site. The content within a Wrapper appears within the primary content area defined by the "mainbody" tag and allows you to display their content as a part of your own site. A Wrapper will place an IFRAME into the content Section of your Web site and wrap your standard template navigation around it so it appears in the same way an Article would.

'''Each Component'''

Each component will have its own link. Some may require you to make additional choices of options.

'''External Link'''

Lets you link to an external site. There may be occasions where you also want to point to a link directly to a apage on your site.

'''Separator'''

This lets you make a text or image only (non-linkable) menu item.

'''Alias'''

Lets you make a link matching an existing menu item. This avoids the problem of having multiple URLs pointing to the same content.

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

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

Code:
DEFINE('_EMPTY_CATEGORY','This Category is currently empty');
to

Code:
DEFINE('_EMPTY_CATEGORY','');

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.

'''1.0.x'''

* 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.

compat_15_native.png

'''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' ) or defined('_JEXEC') or die('Restricted access')?===

'''1.0'''
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.

'''1.5'''

Most PHP files within Joomla! 1.5 begin with the following statement:

defined('_JEXEC') 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?===

'''1.0'''

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.

'''1.5'''

See [[http://docs.joomla.org/Jdoc_statements]]

The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used by default. The standard styles which are declared in %%/templates/system/html/modules.php%% include:

* table
* horz
* xhtml
* rounded
* outline

Template designers may add additional chrome names by adding a custom version of this file to %%/user-template/html/modules.php%%.

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

The easiest way to display an RSS feed is:

In administrator,

'''1.0'''
* 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.

'''1.5'''
* Go to extensions>>Module Manager
* Find the Feed Display module
* Enter the URL of the feed.
* Save and display the module like any other module.

'''Both'''
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.

'''1.0'''

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.

'''1.5'''

Extensions>>Module manager.

On the left side of the page, on the third line, there is a menu that lets you select the position. You also can create a new position name on the fly but typing it in the same space as the menu. (In that case, make sure the same position name also appears in the template file.)

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 new icon to create an additional copy and assign that 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

'''1.0'''
Module>>Site Modules of

'''1.5'''
Extensions>>Module Manager

Select the module you want to assign and edit it.

'''1.0'''

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.

'''1.5'''

On the left there is a list of menu items. You can chose between None, All and Select Menu Item(s) from the List.
To assign to some but not all pages choose the third option and select the menu links that you want the module associated with.

'''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.

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 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.

=== 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?===

'''1.0'''
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?===

waiting for licensing

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

'''1.0'''

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 will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly reccommend 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.

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.

=== How do I implement the core Search Engine Friendly URLs (SEF)?===

'''1.5'''

#Rename htaccess.txt to .htaccess
#In Global configuration, select yes to all three SEF options.
#Make sure that Mod_rewrite is working.

Archived:Administration FAQs Version 1.0

2008-01-19T22:28:35Z

Mroswell: /* Can I import users from a Csv file? */

{{inuse}}

=== 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).

'''1.0.x'''

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

'''1.5'''

Select the redirection page from the list of menu links offered. Make sure that the link is to a published item.

Note: The same procedure is used for redirecting users on successful logout except you enter the page where you want to redirect successful logouts to where it says "Logout Redirection URL."

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

''' VERSION 1.0'''

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.

'''VERSION 1.5'''

'''Articles'''

This gives you access to content.

You can then choose from section, category, archive, articles, front page.

Within section, category and archive you can choose list or blog layouts.

'''Blog Layout'''

Blog layout will show a listing of all Articles of the selected blog type (Section or Category) in the mainbody position of your template.

'''List Layout'''

Table layout will simply give you a tabular list of all the titles in that particular Section or Category.

'''Wrapper'''

Wrappers allow you to place stand alone applications and Third Party Web sites inside your Joomla! site. The content within a Wrapper appears within the primary content area defined by the "mainbody" tag and allows you to display their content as a part of your own site. A Wrapper will place an IFRAME into the content Section of your Web site and wrap your standard template navigation around it so it appears in the same way an Article would.

'''Each Component'''

Each component will have its own link. Some may require you to make additional choices of options.

'''External Link'''

Lets you link to an external site. There may be occasions where you also want to point to a link directly to a apage on your site.

'''Separator'''

This lets you make a text or image only (non-linkable) menu item.

'''Alias'''

Lets you make a link matching an existing menu item. This avoids the problem of having multiple URLs pointing to the same content.

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

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

Code:
DEFINE('_EMPTY_CATEGORY','This Category is currently empty');
to

Code:
DEFINE('_EMPTY_CATEGORY','');

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.

'''1.0.x'''

* 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.

compat_15_native.png

'''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' ) or defined('_JEXEC') or die('Restricted access')?===

'''1.0'''
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.

'''1.5'''

Most PHP files within Joomla! 1.5 begin with the following statement:

defined('_JEXEC') 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?===

'''1.0'''

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.

'''1.5'''

See [[http://docs.joomla.org/Jdoc_statements]]

The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used by default. The standard styles which are declared in %%/templates/system/html/modules.php%% include:

* table
* horz
* xhtml
* rounded
* outline

Template designers may add additional chrome names by adding a custom version of this file to %%/user-template/html/modules.php%%.

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

The easiest way to display an RSS feed is:

In administrator,

'''1.0'''
* 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.

'''1.5'''
* Go to extensions>>Module Manager
* Find the Feed Display module
* Enter the URL of the feed.
* Save and display the module like any other module.

'''Both'''
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.

'''1.0'''

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.

'''1.5'''

Extensions>>Module manager.

On the left side of the page, on the third line, there is a menu that lets you select the position. You also can create a new position name on the fly but typing it in the same space as the menu. (In that case, make sure the same position name also appears in the template file.)

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 new icon to create an additional copy and assign that 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

'''1.0'''
Module>>Site Modules of

'''1.5'''
Extensions>>Module Manager

Select the module you want to assign and edit it.

'''1.0'''

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.

'''1.5'''

On the left there is a list of menu items. You can chose between None, All and Select Menu Item(s) from the List.
To assign to some but not all pages choose the third option and select the menu links that you want the module associated with.

'''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.

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 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.

=== 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?===

'''1.0'''
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?===

waiting for licensing

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

'''1.0'''

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 will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly reccommend 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.

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.

=== How do I implement the core Search Engine Friendly URLs (SEF)?===

'''1.5'''

#Rename htaccess.txt to .htaccess
#In Global configuration, select yes to all three SEF options.
#Make sure that Mod_rewrite is working.

Archived:Administration FAQs Version 1.0

2008-01-19T22:27:39Z

Mroswell: /* spelling, formatting */

{{inuse}}

=== 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).

'''1.0.x'''

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

'''1.5'''

Select the redirection page from the list of menu links offered. Make sure that the link is to a published item.

Note: The same procedure is used for redirecting users on successful logout except you enter the page where you want to redirect successful logouts to where it says "Logout Redirection URL."

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

''' VERSION 1.0'''

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.

'''VERSION 1.5'''

'''Articles'''

This gives you access to content.

You can then choose from section, category, archive, articles, front page.

Within section, category and archive you can choose list or blog layouts.

'''Blog Layout'''

Blog layout will show a listing of all Articles of the selected blog type (Section or Category) in the mainbody position of your template.

'''List Layout'''

Table layout will simply give you a tabular list of all the titles in that particular Section or Category.

'''Wrapper'''

Wrappers allow you to place stand alone applications and Third Party Web sites inside your Joomla! site. The content within a Wrapper appears within the primary content area defined by the "mainbody" tag and allows you to display their content as a part of your own site. A Wrapper will place an IFRAME into the content Section of your Web site and wrap your standard template navigation around it so it appears in the same way an Article would.

'''Each Component'''

Each component will have its own link. Some may require you to make additional choices of options.

'''External Link'''

Lets you link to an external site. There may be occasions where you also want to point to a link directly to a apage on your site.

'''Separator'''

This lets you make a text or image only (non-linkable) menu item.

'''Alias'''

Lets you make a link matching an existing menu item. This avoids the problem of having multiple URLs pointing to the same content.

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

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

Code:
DEFINE('_EMPTY_CATEGORY','This Category is currently empty');
to

Code:
DEFINE('_EMPTY_CATEGORY','');

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.

'''1.0.x'''

* 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.

compat_15_native.png

'''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' ) or defined('_JEXEC') or die('Restricted access')?===

'''1.0'''
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.

'''1.5'''

Most PHP files within Joomla! 1.5 begin with the following statement:

defined('_JEXEC') 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?===

'''1.0'''

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.

'''1.5'''

See [[http://docs.joomla.org/Jdoc_statements]]

The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used by default. The standard styles which are declared in %%/templates/system/html/modules.php%% include:

* table
* horz
* xhtml
* rounded
* outline

Template designers may add additional chrome names by adding a custom version of this file to %%/user-template/html/modules.php%%.

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

The easiest way to display an RSS feed is:

In administrator,

'''1.0'''
* 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.

'''1.5'''
* Go to extensions>>Module Manager
* Find the Feed Display module
* Enter the URL of the feed.
* Save and display the module like any other module.

'''Both'''
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.

'''1.0'''

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.

'''1.5'''

Extensions>>Module manager.

On the left side of the page, on the third line, there is a menu that lets you select the position. You also can create a new position name on the fly but typing it in the same space as the menu. (In that case, make sure the same position name also appears in the template file.)

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 new icon to create an additional copy and assign that 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

'''1.0'''
Module>>Site Modules of

'''1.5'''
Extensions>>Module Manager

Select the module you want to assign and edit it.

'''1.0'''

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.

'''1.5'''

On the left there is a list of menu items. You can chose between None, All and Select Menu Item(s) from the List.
To assign to some but not all pages choose the third option and select the menu links that you want the module associated with.

'''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.

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 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.

=== 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?===

'''1.0'''
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?===

waiting for licensing

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

'''1.0'''

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 will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly reccommend 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.

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.

=== How do I implement the core Search Engine Friendly URLs (SEF)?===

'''1.5'''

#Rename htaccess.txt to .htaccess
#In Global configuration, select yes to all three SEF options.
#Make sure that Mod_rewrite is working.

Archived:Administration FAQs Version 1.0

2008-01-19T22:24:31Z

Mroswell: /*Spelling corrections*/

{{inuse}}

=== 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).

'''1.0.x'''

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

'''1.5'''

Select the redirection page from the list of menu links offered. Make sure that the link is to a published item.

Note: The same procedure is used for redirecting users on successful logout except you enter the page where you want to redirect successful logouts to where it says "Logout Redirection URL."

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

''' VERSION 1.0'''

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.

'''VERSION 1.5'''

'''Articles'''

This gives you access to content.

You can then choose from section, category, archive, articles, front page.

Within section, category and archive you can choose list or blog layouts.

'''Blog Layout'''

Blog layout will show a listing of all Articles of the selected blog type (Section or Category) in the mainbody position of your template.

'''List Layout'''

Table layout will simply give you a tabular list of all the titles in that particular Section or Category.

'''Wrapper'''

Wrappers allow you to place stand alone applications and Third Party Web sites inside your Joomla! site. The content within a Wrapper appears within the primary content area defined by the "mainbody" tag and allows you to display their content as a part of your own site. A Wrapper will place an IFRAME into the content Section of your Web site and wrap your standard template navigation around it so it appears in the same way an Article would.

'''Each Component'''

Each component will have its own link. Some may require you to make additional choices of options.

'''External Link'''

Lets you link to an external site. There may be occasions where you also want to point to a link directly to a apage on your site.

'''Separator'''

This lets you make a text or image only (non-linkable) menu item.

'''Alias'''

Lets you make a link matching an existing menu item. This avoids the problem of having multiple URLs pointing to the same content.

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

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

Code:
DEFINE('_EMPTY_CATEGORY','This Category is currently empty');
to

Code:
DEFINE('_EMPTY_CATEGORY','');

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.

'''1.0.x'''

* 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.

compat_15_native.png

'''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' ) or defined('_JEXEC') or die('Restricted access')?===

'''1.0'''
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.

'''1.5'''

Most PHP files within Joomla! 1.5 begin with the following statement:

defined('_JEXEC') 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?===

'''1.0'''

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.

'''1.5'''

See [[http://docs.joomla.org/Jdoc_statements]]

The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used by default. The standard styles which are declared in %%/templates/system/html/modules.php%% include:

* table
* horz
* xhtml
* rounded
* outline

Template designers may add additional chrome names by adding a custom version of this file to %%/user-template/html/modules.php%%.

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

The easiest way to display an RSS feed is:

In administrator,

'''1.0'''
* 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.

'''1.5'''
* Go to extensions>>Module Manager
* Find the Feed Display module
* Enter the URL of the feed.
* Save and display the module like any other module.

'''Both'''
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.

'''1.0'''

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.

'''1.5'''

Extensions>>Module manager.

On the left side of the page, on the third line, there is a menu that lets you select the position. You also can create a new position name on the fly but typing it in the same space as the menu. (In that case, make sure the same position name also appears in the template file.)

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 new icon to create an additional copy and assign that copy to the second position.

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

Modules are assigned to "pages" using the module manager. In the administrator (back end) go to '''1.0''' Module>>Site Modules of '''1.5''' Extensions>>Module Manager.

Select the module you want to assign and edit it.

'''1.0'''

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.

'''1.5'''

On the left there is a list of menu items. You can chose between None, All and Select Menu Item(s) from the List.
To assign to some but not all pages choose the third option and select the menu links that you want the module associated with.

'''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 unpiblished 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. ou 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 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.

=== 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?===

'''1.0'''
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?===

waiting for licensing

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

'''1.0'''

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 will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly reccommend 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.

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.

=== How do I implement the core Search Engine Friendly URLs (SEF)?===

'''1.5'''

#Rename htaccess.txt to .htaccess
#In Global configuration, select yes to all three SEF options.
#Make sure that Mod_rewrite is working.

Archived:Administration FAQs Version 1.0

2008-01-19T22:22:31Z

Mroswell: /* How do you display an RSS feed? */

{{inuse}}

=== 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).

'''1.0.x'''

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

'''1.5'''

Select the redirection page from the list of menu links offered. Make sure that the link is to a published item.

Note: The same procedure is used for redirecting users on successful logout except you enter the page where you want to redirect successful logouts to where it says "Logout Redirection URL."

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

''' VERSION 1.0'''

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.

'''VERSION 1.5'''

'''Articles'''

This gives you access to content.

You can then choose from section, category, archive, articles, front page.

Within section, category and archive you can choose list or blog layouts.

'''Blog Layout'''

Blog layout will show a listing of all Articles of the selected blog type (Section or Category) in the mainbody position of your template.

'''List Layout'''

Table layout will simply give you a tabular list of all the titles in that particular Section or Category.

'''Wrapper'''

Wrappers allow you to place stand alone applications and Third Party Web sites inside your Joomla! site. The content within a Wrapper appears within the primary content area defined by the "mainbody" tag and allows you to display their content as a part of your own site. A Wrapper will place an IFRAME into the content Section of your Web site and wrap your standard template navigation around it so it appears in the same way an Article would.

'''Each Component'''

Each component will have its own link. Some may require you to make additional choices of options.

'''External Link'''

Lets you link to an external site. There may be occasions where you also want to point to a link directly to a apage on your site.

'''Separator'''

This lets you make a text or image only (non-linkable) menu item.

'''Alias'''

Lets you make a link matching an existing menu item. This avoids the problem of having multiple URLs pointing to the same content.

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

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

Code:
DEFINE('_EMPTY_CATEGORY','This Category is currently empty');
to

Code:
DEFINE('_EMPTY_CATEGORY','');

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.

'''1.0.x'''

* 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.

compat_15_native.png

'''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' ) or defined('_JEXEC') or die('Restricted access')?===

'''1.0'''
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.

'''1.5'''

Most PHP files within Joomla! 1.5 begin with the following statement:

defined('_JEXEC') 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?===

'''1.0'''

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.

'''1.5'''

See [[http://docs.joomla.org/Jdoc_statements]]

The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used by default. The standard styles which are declared in %%/templates/system/html/modules.php%% include:

* table
* horz
* xhtml
* rounded
* outline

Template designers may add additional chrome names by adding a custom version of this file to %%/user-template/html/modules.php%%.

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

The easiest way to display an RSS feed is:

In administrator,

'''1.0'''
* 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.

'''1.5'''
* Go to extensions>>Module Manager
* Find the Feed Display module
* Enter the URL of the feed.
* Save and display the module like any other module.

'''Both'''
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 postion?===

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

'''1.0'''

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 pubished 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.

'''1.5'''

Extensions>>Module manager.

On the left side of the page, on the third line, there is a menu that lets you select the position. You also can create a new position name on the fly but typing it in the same space as the menu.

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 new icon to create an additional copy and assign that copy to the second position.

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

Modules are assigned to "pages" using the module manager. In the administrator (back end) go to '''1.0''' Module>>Site Modules of '''1.5''' Extensions>>Module Manager.

Select the module you want to assign and edit it.

'''1.0'''

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.

'''1.5'''

On the left there is a list of menu items. You can chose between None, All and Select Menu Item(s) from the List.
To assign to some but not all pages choose the third option and select the menu links that you want the module associated with.

'''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 unpiblished 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. ou 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 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.

=== 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?===

'''1.0'''
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?===

waiting for licensing

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

'''1.0'''

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 will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly reccommend 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.

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.

=== How do I implement the core Search Engine Friendly URLs (SEF)?===

'''1.5'''

#Rename htaccess.txt to .htaccess
#In Global configuration, select yes to all three SEF options.
#Make sure that Mod_rewrite is working.

Archived:Administration FAQs Version 1.0

2008-01-19T22:19:43Z

Mroswell: /* How do I add a link to a menu? */

{{inuse}}

=== 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).

'''1.0.x'''

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

'''1.5'''

Select the redirection page from the list of menu links offered. Make sure that the link is to a published item.

Note: The same procedure is used for redirecting users on successful logout except you enter the page where you want to redirect successful logouts to where it says "Logout Redirection URL."

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

''' VERSION 1.0'''

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.

'''VERSION 1.5'''

'''Articles'''

This gives you access to content.

You can then choose from section, category, archive, articles, front page.

Within section, category and archive you can choose list or blog layouts.

'''Blog Layout'''

Blog layout will show a listing of all Articles of the selected blog type (Section or Category) in the mainbody position of your template.

'''List Layout'''

Table layout will simply give you a tabular list of all the titles in that particular Section or Category.

'''Wrapper'''

Wrappers allow you to place stand alone applications and Third Party Web sites inside your Joomla! site. The content within a Wrapper appears within the primary content area defined by the "mainbody" tag and allows you to display their content as a part of your own site. A Wrapper will place an IFRAME into the content Section of your Web site and wrap your standard template navigation around it so it appears in the same way an Article would.

'''Each Component'''

Each component will have its own link. Some may require you to make additional choices of options.

'''External Link'''

Lets you link to an external site. There may be occasions where you also want to point to a link directly to a apage on your site.

'''Separator'''

This lets you make a text or image only (non-linkable) menu item.

'''Alias'''

Lets you make a link matching an existing menu item. This avoids the problem of having multiple URLs pointing to the same content.

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

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

Code:
DEFINE('_EMPTY_CATEGORY','This Category is currently empty');
to

Code:
DEFINE('_EMPTY_CATEGORY','');

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.

'''1.0.x'''

* 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.

compat_15_native.png

'''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' ) or defined('_JEXEC') or die('Restricted access')?===

'''1.0'''
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.

'''1.5'''

Most PHP files within Joomla! 1.5 begin with the following statement:

defined('_JEXEC') 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?===

'''1.0'''

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.

'''1.5'''

See [[http://docs.joomla.org/Jdoc_statements]]

The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used by default. The standard styles which are declared in %%/templates/system/html/modules.php%% include:

* table
* horz
* xhtml
* rounded
* outline

Template designers may add additional chrome names by adding a custom version of this file to %%/user-template/html/modules.php%%.

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

The easiest way to display an RSS feed is:

In administrator,

'''1.0'''
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.

'''1.5'''

Go to extensions>>Module Manager

Find the Feed Display module

Enter the url of the feed.

Save and display the module like any other module.

'''Both'''

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 postion?===

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

'''1.0'''

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 pubished 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.

'''1.5'''

Extensions>>Module manager.

On the left side of the page, on the third line, there is a menu that lets you select the position. You also can create a new position name on the fly but typing it in the same space as the menu.

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 new icon to create an additional copy and assign that copy to the second position.

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

Modules are assigned to "pages" using the module manager. In the administrator (back end) go to '''1.0''' Module>>Site Modules of '''1.5''' Extensions>>Module Manager.

Select the module you want to assign and edit it.

'''1.0'''

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.

'''1.5'''

On the left there is a list of menu items. You can chose between None, All and Select Menu Item(s) from the List.
To assign to some but not all pages choose the third option and select the menu links that you want the module associated with.

'''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 unpiblished 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. ou 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 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.

=== 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?===

'''1.0'''
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?===

waiting for licensing

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

'''1.0'''

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 will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly reccommend 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.

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.

=== How do I implement the core Search Engine Friendly URLs (SEF)?===

'''1.5'''

#Rename htaccess.txt to .htaccess
#In Global configuration, select yes to all three SEF options.
#Make sure that Mod_rewrite is working.

Archived:Administration FAQs Version 1.0

2008-01-19T22:18:23Z

Mroswell: /* What is php defined( '_VALID_MOS' ) or die( 'Restricted access' ) or defined('_JEXEC') or die('Restricted access')? */

{{inuse}}

=== 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).

'''1.0.x'''

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

'''1.5'''

Select the redirection page from the list of menu links offered. Make sure that the link is to a published item.

Note: The same procedure is used for redirecting users on successful logout except you enter the page where you want to redirect successful logouts to where it says "Logout Redirection URL."

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

''' VERSION 1.0'''

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.

'''VERSION 1.5'''

'''Articles'''

This gives you access to content.

You can then choose from section, category, archive, articles, front page.

Within section, category and archive you can choose list or blog layouts.

'''Blog Layout'''

Blog layout will show a listing of all Articles of the selected blog type (Section or Category) in the mainbody position of your template.

'''List Layout'''

Table layout will simply give you a tabular list of all the titles in that particular Section or Category.

'''Wrapper'''

Wrappers allow you to place stand alone applications and Third Party Web sites inside your Joomla! site. The content within a Wrapper appears within the primary content area defined by the "mainbody" tag and allows you to display their content as a part of your own site. A Wrapper will place an IFRAME into the content Section of your Web site and wrap your standard template navigation around it so it appears in the same way an Article would.

'''Each Component'''

Each component will have its own link. Some may require you to make additional choices of options.

'''External Link'''

Lets you link to an external site. There may be occasions where you also want to point to a link directly to a apage on your site.

'''Separator'''

This lets you make a text or image only (non-linkable) menu item.

'''Alias'''

Lets you make a link matching an existing menu item. This avoids the problem of having multiple URLs pointing to the same content.

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

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

Code:
DEFINE('_EMPTY_CATEGORY','This Category is currently empty');
to

Code:
DEFINE('_EMPTY_CATEGORY','');

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.

'''1.0.x'''

* 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.

compat_15_native.png

'''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' ) or defined('_JEXEC') or die('Restricted access')?===

'''1.0'''
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.

'''1.5'''

Most PHP files within Joomla! 1.5 begin with the following statement:

defined('_JEXEC') 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?===

'''1.0'''

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.

'''1.5'''

See [[http://docs.joomla.org/Jdoc_statements]]

The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used by default. The standard styles which are declared in %%/templates/system/html/modules.php%% include:

* table
* horz
* xhtml
* rounded
* outline

Template designers may add additional chrome names by adding a custom version of this file to %%/user-template/html/modules.php%%.

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

The easiest way to display an RSS feed is:

In administrator,

'''1.0'''
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.

'''1.5'''

Go to extensions>>Module Manager

Find the Feed Display module

Enter the url of the feed.

Save and display the module like any other module.

'''Both'''

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 postion?===

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

'''1.0'''

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 pubished 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.

'''1.5'''

Extensions>>Module manager.

On the left side of the page, on the third line, there is a menu that lets you select the position. You also can create a new position name on the fly but typing it in the same space as the menu.

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 new icon to create an additional copy and assign that copy to the second position.

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

Modules are assigned to "pages" using the module manager. In the administrator (back end) go to '''1.0''' Module>>Site Modules of '''1.5''' Extensions>>Module Manager.

Select the module you want to assign and edit it.

'''1.0'''

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.

'''1.5'''

On the left there is a list of menu items. You can chose between None, All and Select Menu Item(s) from the List.
To assign to some but not all pages choose the third option and select the menu links that you want the module associated with.

'''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 unpiblished 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. ou 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 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.

=== 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?===

'''1.0'''
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?===

waiting for licensing

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

'''1.0'''

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 will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly reccommend 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.

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.

=== How do I implement the core Search Engine Friendly URLs (SEF)?===

'''1.5'''

#Rename htaccess.txt to .htaccess
#In Global configuration, select yes to all three SEF options.
#Make sure that Mod_rewrite is working.

Archived:Administration FAQs Version 1.0

2008-01-19T22:15:02Z

Mroswell: /* How do I add a link to a menu? */

{{inuse}}

=== 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).

'''1.0.x'''

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

'''1.5'''

Select the redirection page from the list of menu links offered. Make sure that the link is to a published item.

Note: The same procedure is used for redirecting users on successful logout except you enter the page where you want to redirect successful logouts to where it says "Logout Redirection URL."

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

''' VERSION 1.0'''

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.

'''VERSION 1.5'''

'''Articles'''

This gives you access to content.

You can then choose from section, category, archive, articles, front page.

Within section, category and archive you can choose list or blog layouts.

'''Blog Layout'''

Blog layout will show a listing of all Articles of the selected blog type (Section or Category) in the mainbody position of your template.

'''List Layout'''

Table layout will simply give you a tabular list of all the titles in that particular Section or Category.

'''Wrapper'''

Wrappers allow you to place stand alone applications and Third Party Web sites inside your Joomla! site. The content within a Wrapper appears within the primary content area defined by the "mainbody" tag and allows you to display their content as a part of your own site. A Wrapper will place an IFRAME into the content Section of your Web site and wrap your standard template navigation around it so it appears in the same way an Article would.

'''Each Component'''

Each component will have its own link. Some may require you to make additional choices of options.

'''External Link'''

Lets you link to an external site. There may be occasions where you also want to point to a link directly to a apage on your site.

'''Separator'''

This lets you make a text or image only (non-linkable) menu item.

'''Alias'''

Lets you make a link matching an existing menu item. This avoids the problem of having multiple URLs pointing to the same content.

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

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

Code:
DEFINE('_EMPTY_CATEGORY','This Category is currently empty');
to

Code:
DEFINE('_EMPTY_CATEGORY','');

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.

'''1.0.x'''

* 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.

compat_15_native.png

'''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' ) or defined('_JEXEC') or die('Restricted access')?===

'''1.0'''
Most php files within Joomla! 1.0.xbegin 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.

'''1.5'''

Most php files within Joomla! 1.5 begin with the following statement:

defined('_JEXEC') 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?===

'''1.0'''

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.

'''1.5'''

See [[http://docs.joomla.org/Jdoc_statements]]

The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used by default. The standard styles which are declared in %%/templates/system/html/modules.php%% include:

* table
* horz
* xhtml
* rounded
* outline

Template designers may add additional chrome names by adding a custom version of this file to %%/user-template/html/modules.php%%.

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

The easiest way to display an RSS feed is:

In administrator,

'''1.0'''
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.

'''1.5'''

Go to extensions>>Module Manager

Find the Feed Display module

Enter the url of the feed.

Save and display the module like any other module.

'''Both'''

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 postion?===

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

'''1.0'''

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 pubished 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.

'''1.5'''

Extensions>>Module manager.

On the left side of the page, on the third line, there is a menu that lets you select the position. You also can create a new position name on the fly but typing it in the same space as the menu.

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 new icon to create an additional copy and assign that copy to the second position.

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

Modules are assigned to "pages" using the module manager. In the administrator (back end) go to '''1.0''' Module>>Site Modules of '''1.5''' Extensions>>Module Manager.

Select the module you want to assign and edit it.

'''1.0'''

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.

'''1.5'''

On the left there is a list of menu items. You can chose between None, All and Select Menu Item(s) from the List.
To assign to some but not all pages choose the third option and select the menu links that you want the module associated with.

'''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 unpiblished 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. ou 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 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.

=== 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?===

'''1.0'''
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?===

waiting for licensing

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

'''1.0'''

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 will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly reccommend 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.

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.

=== How do I implement the core Search Engine Friendly URLs (SEF)?===

'''1.5'''

#Rename htaccess.txt to .htaccess
#In Global configuration, select yes to all three SEF options.
#Make sure that Mod_rewrite is working.

Archived:Administration FAQs Version 1.0

2008-01-19T22:12:50Z

Mroswell: /* Mostly formatting changes */

{{inuse}}

=== 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).

'''1.0.x'''

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

'''1.5'''

Select the redirection page from the list of menu links offered. Make sure that the link is to a published item.

Note: The same procedure is used for redirecting users on successful logout except you enter the page where you want to redirect successful logouts to where it says "Logout Redirection URL."

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

''' VERSION 1.0'''

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.

'''VERSION 1.5'''

'''Articles'''

This gives you access to content.

You can then choose from section, category, archive, articles, front page.

Within section, category and archive you can choose list or blog layouts.

'''Blog Layout'''

Blog layout will show a listing of all Articles of the selected blog type (Section or Category) in the mainbody position of your template.

'''List Layout'''

Table layout will simply give you a tabular list of all the titles in that particular Section or Category.

'''Wrapper'''

Wrappers allow you to place stand alone applications and Third Party Web sites inside your Joomla! site. The content within a Wrapper appears within the primary content area defined by the "mainbody" tag and allows you to display their content as a part of your own site. A Wrapper will place an IFRAME into the content Section of your Web site and wrap your standard template navigation around it so it appears in the same way an Article would.

'''Each Component'''

Each component will have its own link. Some may require you to make additional choices of options.

'''External Link'''

Lets you link to an external site. There may be occasions where you also want to point to a link directly to a apage on your site.

'''Separator'''

This lets you make a text or image only (non-linkable) menu item.

'''Alias'''

Lets you make a link matching an existing menu item. This avoids the problem of having multiple URLs pointing to the same content.

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

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

Code:
DEFINE('_EMPTY_CATEGORY','This Category is currently empty');
to

Code:
DEFINE('_EMPTY_CATEGORY','');

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.

'''1.0.x'''

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.

compat_15_native.png

'''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' ) or defined('_JEXEC') or die('Restricted access')?===

'''1.0'''
Most php files within Joomla! 1.0.xbegin 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.

'''1.5'''

Most php files within Joomla! 1.5 begin with the following statement:

defined('_JEXEC') 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?===

'''1.0'''

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.

'''1.5'''

See [[http://docs.joomla.org/Jdoc_statements]]

The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used by default. The standard styles which are declared in %%/templates/system/html/modules.php%% include:

* table
* horz
* xhtml
* rounded
* outline

Template designers may add additional chrome names by adding a custom version of this file to %%/user-template/html/modules.php%%.

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

The easiest way to display an RSS feed is:

In administrator,

'''1.0'''
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.

'''1.5'''

Go to extensions>>Module Manager

Find the Feed Display module

Enter the url of the feed.

Save and display the module like any other module.

'''Both'''

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 postion?===

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

'''1.0'''

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 pubished 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.

'''1.5'''

Extensions>>Module manager.

On the left side of the page, on the third line, there is a menu that lets you select the position. You also can create a new position name on the fly but typing it in the same space as the menu.

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 new icon to create an additional copy and assign that copy to the second position.

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

Modules are assigned to "pages" using the module manager. In the administrator (back end) go to '''1.0''' Module>>Site Modules of '''1.5''' Extensions>>Module Manager.

Select the module you want to assign and edit it.

'''1.0'''

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.

'''1.5'''

On the left there is a list of menu items. You can chose between None, All and Select Menu Item(s) from the List.
To assign to some but not all pages choose the third option and select the menu links that you want the module associated with.

'''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 unpiblished 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. ou 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 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.

=== 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?===

'''1.0'''
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?===

waiting for licensing

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

'''1.0'''

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 will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly reccommend 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.

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.

=== How do I implement the core Search Engine Friendly URLs (SEF)?===

'''1.5'''

#Rename htaccess.txt to .htaccess
#In Global configuration, select yes to all three SEF options.
#Make sure that Mod_rewrite is working.

Archived:Administration FAQs Version 1.0

2008-01-19T22:06:08Z

Mroswell: /* How do I redirect users after a successful login? */

{{inuse}}

=== 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).

'''1.0.x'''

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

'''1.5'''

Select the redirection page from the list of menu links offered. Make sure that the link is to a published item.

Note: The same procedure is used for redirecting users on successful logout except you enter the page where you want to redirect successful logouts to where it says "Logout Redirection URL."

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

'''1.0'''

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.

'''1.5'''

Articles

This gives you access to content.

You can then choose from section, category, archive, articles, front page.

Within section, category and archive you can choose list or blog layouts.

Blog Layout

Blog layout will show a listing of all Articles of the selected blog type (Section or Category) in the mainbody position of your template.

List Layout

Table layout will simply give you a tabular list of all the titles in that particular Section or Category.

Wrapper

Wrappers allow you to place stand alone applications and Third Party Web sites inside your Joomla! site. The content within a Wrapper appears within the primary content area defined by the "mainbody" tag and allows you to display their content as a part of your own site. A Wrapper will place an IFRAME into the content Section of your Web site and wrap your standard template navigation around it so it appears in the same way an Article would.

Each Component

Each component will have its own link. Some may require you to make additional choices of options.

External Link

Lets you link to an external site

Separator

This lets you make a text or image only (non linkable) menu item.

Alias

Lets you make a link matching an existing menu item. This avoids the problem of having multiple urls pointing to the same content.

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

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

Code:
DEFINE('_EMPTY_CATEGORY','This Category is currently empty');
to

Code:
DEFINE('_EMPTY_CATEGORY','');

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.

'''1.0.x'''

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.

compat_15_native.png

'''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' ) or defined('_JEXEC') or die('Restricted access')?===

'''1.0'''
Most php files within Joomla! 1.0.xbegin 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.

'''1.5'''

Most php files within Joomla! 1.5 begin with the following statement:

defined('_JEXEC') 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?===

'''1.0'''

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.

'''1.5'''

See [[http://docs.joomla.org/Jdoc_statements]]

The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used by default. The standard styles which are declared in %%/templates/system/html/modules.php%% include:

* table
* horz
* xhtml
* rounded
* outline

Template designers may add additional chrome names by adding a custom version of this file to %%/user-template/html/modules.php%%.

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

The easiest way to display an RSS feed is:

In administrator,

'''1.0'''
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.

'''1.5'''

Go to extensions>>Module Manager

Find the Feed Display module

Enter the url of the feed.

Save and display the module like any other module.

'''Both'''

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 postion?===

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

'''1.0'''

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 pubished 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.

'''1.5'''

Extensions>>Module manager.

On the left side of the page, on the third line, there is a menu that lets you select the position. You also can create a new position name on the fly but typing it in the same space as the menu.

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 new icon to create an additional copy and assign that copy to the second position.

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

Modules are assigned to "pages" using the module manager. In the administrator (back end) go to '''1.0''' Module>>Site Modules of '''1.5''' Extensions>>Module Manager.

Select the module you want to assign and edit it.

'''1.0'''

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.

'''1.5'''

On the left there is a list of menu items. You can chose between None, All and Select Menu Item(s) from the List.
To assign to some but not all pages choose the third option and select the menu links that you want the module associated with.

'''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 unpiblished 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. ou 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 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.

=== 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?===

'''1.0'''
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?===

waiting for licensing

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

'''1.0'''

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 will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly reccommend 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.

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.

=== How do I implement the core Search Engine Friendly URLs (SEF)?===

'''1.5'''

#Rename htaccess.txt to .htaccess
#In Global configuration, select yes to all three SEF options.
#Make sure that Mod_rewrite is working.

Archived:Administration FAQs Version 1.0

2008-01-19T22:05:07Z

Mroswell: /* Why don't all of my menu items show up in the module assignment lists? */

{{inuse}}

=== 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).

'''1.0.x'''

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

'''1.5'''

Select the redirection page from the list of menu links offered. Make sure that the link is to a published item.

Note: The same procedure is used for redirecting users on successful logout except you enter the page where you want to redirect successful logouts to where it says "Logout Redirection URL."

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

'''1.0'''

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.

'''1.5'''

Articles

This gives you access to content.

You can then choose from section, category, archive, articles, front page.

Within section, category and archive you can choose list or blog layouts.

Blog Layout

Blog layout will show a listing of all Articles of the selected blog type (Section or Category) in the mainbody position of your template.

List Layout

Table layout will simply give you a tabular list of all the titles in that particular Section or Category.

Wrapper

Wrappers allow you to place stand alone applications and Third Party Web sites inside your Joomla! site. The content within a Wrapper appears within the primary content area defined by the "mainbody" tag and allows you to display their content as a part of your own site. A Wrapper will place an IFRAME into the content Section of your Web site and wrap your standard template navigation around it so it appears in the same way an Article would.

Each Component

Each component will have its own link. Some may require you to make additional choices of options.

External Link

Lets you link to an external site

Separator

This lets you make a text or image only (non linkable) menu item.

Alias

Lets you make a link matching an existing menu item. This avoids the problem of having multiple urls pointing to the same content.

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

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

Code:
DEFINE('_EMPTY_CATEGORY','This Category is currently empty');
to

Code:
DEFINE('_EMPTY_CATEGORY','');

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.

'''1.0.x'''

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.

compat_15_native.png

'''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' ) or defined('_JEXEC') or die('Restricted access')?===

'''1.0'''
Most php files within Joomla! 1.0.xbegin 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.

'''1.5'''

Most php files within Joomla! 1.5 begin with the following statement:

defined('_JEXEC') 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?===

'''1.0'''

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.

'''1.5'''

See [[http://docs.joomla.org/Jdoc_statements]]

The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used by default. The standard styles which are declared in %%/templates/system/html/modules.php%% include:

* table
* horz
* xhtml
* rounded
* outline

Template designers may add additional chrome names by adding a custom version of this file to %%/user-template/html/modules.php%%.

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

The easiest way to display an RSS feed is:

In administrator,

'''1.0'''
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.

'''1.5'''

Go to extensions>>Module Manager

Find the Feed Display module

Enter the url of the feed.

Save and display the module like any other module.

'''Both'''

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 postion?===

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

'''1.0'''

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 pubished 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.

'''1.5'''

Extensions>>Module manager.

On the left side of the page, on the third line, there is a menu that lets you select the position. You also can create a new position name on the fly but typing it in the same space as the menu.

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 new icon to create an additional copy and assign that copy to the second position.

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

Modules are assigned to "pages" using the module manager. In the administrator (back end) go to '''1.0''' Module>>Site Modules of '''1.5''' Extensions>>Module Manager.

Select the module you want to assign and edit it.

'''1.0'''

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.

'''1.5'''

On the left there is a list of menu items. You can chose between None, All and Select Menu Item(s) from the List.
To assign to some but not all pages choose the third option and select the menu links that you want the module associated with.

'''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 unpiblished 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. ou 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 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.

=== 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?===

'''1.0'''
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?===

waiting for licensing

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

'''1.0'''

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 will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly reccommend 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.

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.

=== How do I implement the core Search Engine Friendly URLs (SEF)?===

'''1.5'''

#Rename htaccess.txt to .htaccess
#In Global configuration, select yes to all three SEF options.
#Make sure that Mod_rewrite is working.