Archived

Difference between revisions of "Starting with Joomla! FAQs"

From Joomla! Documentation

Line 274: Line 274:
  
 
==What does a simple Joomla! installation include?==
 
==What does a simple Joomla! installation include?==
 +
 +
 +
If you are coming from a traditional website made up of separate html pages, you may well wonder where the pages are.
 +
 +
In Joomla! almost everything that you would normally think of as a webpage is actually stored in a mysql database. When you create a new page, your content is stored in a database record, not in a separate file.
 +
 +
Then when your site is viewed, Joomla! calls up different items from your database and puts them together to make what is displayed to the user.
 +
 +
One exception is that your images are usually stored in the images directory and not the database.
 +
 +
Your mysql data base usually is created by you during the installation process (unless you use a Fantastico or a similar installer that will create the database automatically). If you have a control panel on a linux host, you can usually access mysql through a program called phpadmin. This will allow you to view your database.

Revision as of 06:17, 19 January 2008

This page has been archived. This page contains information for an unsupported Joomla! version or is no longer relevant. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.

What license is Joomla! released under?[edit]

Joomla! is released under the GPL (Gnu General Public License 2).

Details of the GPL can be found here: http://www.gnu.org/licenses/gpl.html.

What do the locks mean? How do I get rid of them?[edit]

At any given time you may see a padlock next to a specific item in Joomla!'s administrative backend. These padlocks may be displayed next to any of the following (Content Items, Menu Items, Modules, etc).

The Joomla! system places these padlocks next an item to indicate that a user is currently editing (checked out) the item. The lock is removed by the sytem when the user clicks on the "Save" button for that item. If the user never clicks save and instead hits the "Back" button or naviagtes to another page, then the item stays locked. If another user needs to work with the item he or she must have the item checked back in before the can work.

There are two ways of checking items back in. One way is to contact the person that has the item checked out to see if they are done with the item.

The other option utilizes the administrative back end; Click on "System => Global check in" This option should be used very carefully, especially in multi-user environments. This single action checks in all previously checked out items, whether they were checked out by you or not. Possible undesirable side effects may be that multiple editors end up working on the same document. In this case who ever clicks the save button last has their version saved as the final copy.

How do I eliminate the pathway or breadcrumbs?[edit]

The pathway or breadcrumb is a hierarchical trail that shows your current location on the site. The breadcrumb follows the Section, Catgory, Content Item hierarchy and a site's home page is always listed as the root of the hierarchy as "Home".

An example is as follows; You are currently reading a content item "New Page". This content item is a member of the "Pages " category. In the turn the pages category is a member of the "Books" section. In this case the breadcrumb for that page would look like: "Home >> Books >> Pages >> New Page".

1.0[edit]

If you wish to eliminate the pathway entirely, edit your template html (index) file. Usually it will look like this:

 <?php mosPathWay(); ?>

If you wish to eliminate it on a specific page, such as just the home page, you can modify the template in this way:

 New line:if($option != "" && $option != "com_frontpage")
 New line:{
 New line:?>

Existing:

 Existing:<?php mosPathWay(); ?>
Existing:
 New line:}
 New line:?>

Understanding: The first line says that if the option in the url does not equal com_frontpage (!="com_frontpage") display the pathway. In php ! means not.

1.5[edit]

Breadcrumbs are in the breadcrumbs module. To eliminate them, disable the module.


How do I exit the wrapper?[edit]

How do I get rid of the News Flash or other module?[edit]

To disable the news flash (or any other) module from being displayed on the front end of the website, you first need to log in to the administrative backend.

1.0[edit]

  • Once in the back end, on the top menu click Modules => Site Modules.
  • Locate the Newsflash module. You may need to navigate to another page as there are many modules and they are not all displayed on the first page.
  • Click the "Next" or "Previous" links at the button of the page until the module is located.
  • Once the module is located, click on the icon next for this module name in the "Published" column.

The icon should change to a red "X" which indicates that the module is now unpublished and invisible on the site’s front end.


1.5[edit]

  • Once in the back end, go to Extensions, Module Manager
  • Locate the newsflash or other module
  • Once the module is located, click on the icon next for this module name in the "Enabled" column.


How do I remove the page title from the front page of my site?[edit]

How do I find an extension to do [fill in the blank]?[edit]

The official Joomla! extensions site: http://extensions.joomla.org/ is the main source for extensions.

If you cannot find what you need there, you should also search the Joomla! Extensions Directory Forum.

If you still can't find the right component then you should post a request or question in the Extensions Directory forum.

1.5 forum: http://forum.joomla.org/index.php/board,470.0.html

1.0 forum: http://forum.joomla.org/index.php/board,465.0.html


Can content items be assigned to multiple categories or sections?[edit]

No, content items cannot be assigned to multiple categories or sections. In Joomla! 1.0.x content items are restricted to a single category in a single section.

To have the same content in several sections or categories you must make separate content items for each category.

Workarounds include using menus rather than dynamic lists of content items and using various third party extensions that simulate assignment to multiple categories.

How do I control what items appear in my newsflashes?[edit]

Newsflash is a module that displays content from specific sections and/or categories.

  • In the administrative back end from the top menu select “Modules => Site Modules”.
  • Click on “Newsflash” to edit the module.
  • Go to the parameters section of the page.
  • Next to the “Category” parameter click on the drop down menu to select which category of content items will be displayed by this module. (In older versions of Joomla! You need to manually enter the section and/or category id numbers).
  • Click the save button to make your changes permanent.


How do I change the image(s) in my template?[edit]

One common template change is to use your own graphic/image. Simple graphics (not banners) are usually linked in the html file of your template. Simply change the reference to the image of your choice in the html file of your template.


1.0 In the adminsitrative interface do this by going to Site =>Template manager and then selecting your template. Click the icon for html.

1.5

In the administrative interface do this by going to Extensions>Templates.

Select the template you want to modify and click edit. Then click the icon for html.


Keep in mind that it if it is a different size than the original image this may change the appearance of the site in unexpected ways.


Additional information:

The images for a given template are generally located in this folder: /templates/templatename/images (Substitute the name of the template you are using in place of "templatename").

A trick for finding the name of the image is to put your cursor over it and click right. Select view image. This will display the image and give its full url. Sometimes the images are background images. This is viewable in Firefox or you can look for the background tag in your page source.

How to upload an image:

There are many ways to upload images. Which one you use will depend on your host and server.

1. You can use the media manager. 2. You can use an ftp client. 3. You can use a cpanel file manager. 4. You can use various extensions that allow uploading.

How do I change the introductory text for weblinks?[edit]

By default Joomla! 1.0.x uses the 'We are out on the web ..." introductory text. If you wish to change you have two options. 1. In your menu link to the weblinks component, add introductory text to the parameters. This replaces the default text. Note, to see all of the parameters you need to create the component link, then edit it.

2. Change your language file (e.g. english.php). It is found in _WEBLINKS_DESC

Why can't I edit my content from the front end?[edit]

The most common cause of this is that the item is "checked out." That means that the item is either being edited by another user or (more common) that the last time someone opened (edited) the file it was not closed properly (saved).

If you were the person that last edited the article, log into the backend of the site, go to the content manager and find the article in question. It will have a lock next to its name. Open the file and then save it (or cancel). When the content list is reloaded the lock should be gone.

Alternatively, someone with superadministrator privleges can use Global Checkin to checkin all checked out items. If using this option, make sure that no one is actively editing a file or their work may be lost.

It is possible to check in your own items that you may have accidentally locked if a link to checkin is available. This may be called something else. You can add this link to a menu by creating a URL link like this: index.php?option=com_user&task=CheckIn

Note: It is important that whenever you open an article for editing you should close it using either "save" (floppy icon) or "cancel" (red x icon) when finished with your edits. Failure to do this so will lock as described above.

How do I link from inside content to another content item?[edit]

The simple answer is that you get the URL for the page you want to link to. Then you make a link using whatever editor you are using or with html if you have nowysiwyg.

The more complicated answer is that some editors have fancier links managers. A number of these editors are available in the Joomla! Extensions Directory.

How is access control set up in Joomla!?[edit]

Joomla! has a limited access control system. By default there are the following groups: Front End Only

   * Public
   * Registered
   * Author
   * Publisher

Back End

   * Manager
   * Administrator
   * Super Administrator


There are two basic ways that access controll is used:

   * To control the ability of users to see modules, content and menu items
   * To control the actions that users can take.


Access to content, modules and menu links

All groups except Public and Registered are considered "Special."

When creating content or setting parameters for modules, you can set access to: Public, Registered or Special.

These groups are hierarhical. Groups further down the list have all rights of those above them.

Control of privleges to create and edit content and modify administrative settings.


Group Front End Back End Public Can view pubic pages None Registered Same permissions as "Public" plus can view content and modules limited to registered. Can submit weblinks None Author Same permissions as "Registered" plus can submit but not publish content. None Editor Same permissions as "Author" plus edit any content. None Publisher Same permissions as "Publisher" plus can publish and edit any content. None Manager Same permissions as as "Publisher" Limited Administrator Same permissiona as "Publisher" Most privleges Super Administrator Same permissions as "Pubisher" All privleges Each group can view the content and modules at the same level or above on this table.

There is no way to create additional access groups without modifying Joomla! core files.

There are some extensions available which provide additional access control capabilities.

You can learn more about access control here:

http://help.joomla.org/images/User_manual/joomal_users_manual_combined.pdf

Where are the web pages?[edit]

If you are coming from a traditional website made up of separate html pages, you may well wonder where the pages are.

In Joomla! almost everything that you would normally think of as a webpage is actually stored in a mysql database. When you create a new page, your content is stored in a database record, not in a separate file.

Then when your site is viewed, Joomla! calls up different items from your database and puts them together to make what is displayed to the user.

One exception is that your images are usually stored in the images directory and not the database.

Your mysql data base usually is created by you during the installation process (unless you use a Fantastico or a similar installer that will create the database automatically). If you have a control panel on a linux host, you can usually access mysql through a program called phpadmin. This will allow you to view your database.

What determines what is shown on my frontpage?[edit]

What determines my homepage?[edit]

What are section, categories, content items and articles?[edit]

What are components, modules, mambots and plugins?[edit]

How do I change the favicon?[edit]

Favicon is the favorites icon that is associated with your site and appears in the browser address bar. Both Joomla! 1.0.x and 1.5.x come with a default favicon that displays the Joomla! Logo. You may change that as long as your new favicon is in the ICO format and sized 16×16 pixels. Here's how to do it:

1.0[edit]

  • Upload your new favicon into Joomla!'s /images/ folder.
  • Delete Joomla!'s default /images/favicon.ico file and rename your file into favicon.ico OR
  • Go to your site's back-end and change the name of the favicon file that's being loaded at Site > Global Configuration > Site > Favourites Site Icon (make sure configuration.php is writable before you commit your changes).

1.5[edit]

Unlike the 1.0.x series, the only name you are allowed to use for your favicon is favicon.ico but you are offered the flexibility to associate different favicons with different templates. You only need to upload your favicon.ico into the main folders of your front-end and back-end templates, which are found in the /templates/ and the /administrator/templates/ folders respectively, overwriting any favicon files that came with your templates.

However, if you'd rather use a single favicon.ico for all your templates, just upload it into Joomla!'s main folder (that's where your index.php resides) and into the /administrator/ folder. Make sure you delete all favicon.ico files found in the template folders mentioned above because Joomla! will check your template folder first for the favicon.ico file.

Why do the pop ups in my WYSIWYG editor not work or show gibberish?[edit]

What are positions?[edit]

Why are the backgrounds of my WYSIWYG editor fields colored?[edit]

How do you install an extension?[edit]

Why doesn't the pdf of my page show the images?[edit]

How do I make a menu link that is not clickable?[edit]

What does a simple Joomla! installation include?[edit]

If you are coming from a traditional website made up of separate html pages, you may well wonder where the pages are.

In Joomla! almost everything that you would normally think of as a webpage is actually stored in a mysql database. When you create a new page, your content is stored in a database record, not in a separate file.

Then when your site is viewed, Joomla! calls up different items from your database and puts them together to make what is displayed to the user.

One exception is that your images are usually stored in the images directory and not the database.

Your mysql data base usually is created by you during the installation process (unless you use a Fantastico or a similar installer that will create the database automatically). If you have a control panel on a linux host, you can usually access mysql through a program called phpadmin. This will allow you to view your database.