Abstract
This document describes ARTIO JoomSEF component for Joomla, it functionality, installation procedure and usage.
This documentation can also be downloaded in PDF format.
Table of Contents
- 1. JoomSEF Introduction
- 2. Installing JoomSEF
- 3. How It Works
- 4. Control Panel
- 5. Configuring JoomSEF
-
- 5.1. Basic Configuration Options
- 5.2. Advanced Configuration Options
- 5.3. Cache Configuration Options
- 5.4. Title and Meta Tags Configuration Options
- 5.5. SEO Configuration Options
- 5.6. SiteMap Configuration Options
- 5.7. JoomFish Related Configuration Options
- 5.8. 404 Page Options
- 5.9. Registration Options
- 6. Working with URLs
- 7. JoomSEF Extensions
- 8. 301 Redirects
- 9. SiteMap
- 10. Extra features
- 11. Upgrades
- 12. Usage Tips
- 13. Troubleshooting
Table of Contents
ARTIO JoomSEF is a Joomla! component that generates and allows creation of search engine friendly (SEF) URLs, manages and generates HTTP document meta-data, such as description, keywords, title; returns proper 404 status code for missing content, provides logging of 404 errors, helps to manage 301 redirects, etc.
To provide maximum functionality, JoomSEF uses plug-in system, that allows SEO support for many popular Joomla! components. The pieces of plug-in code that provides the support for specific 3rd party component is called JoomSEF extension. Some of these extensions are available for free download, some are available under commercial licence. If you are missing a support for your favourite component, ARTIO may develop it on request.
This documents describes how to install and setup ARTIO JoomSEF Joomla! component. You can view this documentation again by selecting the "ARTIO JoomSEF Documentation" button from the ARTIO JoomSEF Control Panel.
JoomSEF is a component for Joomla! CMS, therefore it requires Joomla! to run. It is available in two editions:
-
JoomSEF 3.x is compatible with Joomla 1.5.x
-
JoomSEF 2.x is compatible with Joomla 1.0.x
In both cases, JoomSEF is compatible with web servers, that support URL rewrite functionality.
-
Apache with mod_rewrite module installed and activated
-
IIS versions 6, 7 with ISAPI rewrite module installed (we recommend using Helicon's ISAPI Rewrite v3)
-
other webservers with URL rewriting capabilities
JoomSEF also needs PHP version 5.1.0 or higher, the 5.2.x is recommended.
The most actual version of the ARTIO JoomSEF licensing conditions can be found at ARTIO website.
By installing and using this software, you agree to bind to the mentioned license conditions.
JoomSEF's main functionality is to rewrite Joomla! standard URLs in a form of domain.tld/index.php?option=com_content&view=article&id=2&Itemid=5 to the more human readable and search engine understandable form of domain.tld/article-category/article-title. You can easily manage these URLs and make them look anything you like.
You can very easily set description, keywords and other meta tags for each URL separately, so you have maximum control of your meta tags. JoomSEF can also generate the meta tags for the most favourite components automatically for you.
JoomSEF supports JoomFish (provides multilingual content) from its very first versions and since then it has many options to create multilingual SEF URLs.
If you ever want to change your URLs that are already well indexed by search engines, or when you migrate website to Joomla, you will need to set the 301 redirects from the old URLs to the new ones, so the old URLs remain functional without a penalization from search engines. Using JoomSEF you have three options to do this:
-
The 301 Redirects feature - you can manually create individual redirects one by one; JoomSEF also creates these redirects automatically when you manually change some SEF URL, so the old one will still work
-
The URL Aliases feature - for each SEF URL you can set list of aliases which will be redirected to it
-
The .htaccess redirects feature - JoomSEF allows you to easily add 301 redirects directly to your .htaccess file without a need of fully understanding its syntax
The XML Sitemap file is used to tell the search engines which pages on your web site you want to be indexed, what priority each of your pages has, how often the content of the pages changes and when was the page changed the last time, so search engines can optimize their indexing strategy based on this information. Using JoomSEF you can easily control all of this information without a need to write a single XML line.
This feature allows you to create a set of words with assigned URLs. JoomSEF then automatically hyperlinks any appearance of these words in your pages content to their corresponding assigned URLs.
Keeping your JoomSEF and its extensions up-to-date has never been simpler. On one page you can see what versions you have currently installed and what are the newest versions and you can automatically upgrade your JoomSEF or any of its installed extension with a single click. Moreover you can see a list of your components without a JoomSEF extension installed and if the extension is available on our server, you can get it again with a single click - the free extensions are installed right away and paid versions will redirect you to our e-shop.
Table of Contents
You can obtain JoomSEF by downloading from ARTIO webpage. The method of obtaining it may differ on whether you want to use free or paid edition.
Free edition of JoomSEF can be downloaded directly in Downloads section of the ARTIO website.
To download a paid version, you need a Download ID that you will receive by email when your payment for the component has been confirmed. Then you can download the compoment by clicking the link in the same email or by entering the Download ID at the Download Area of the ARTIO webshop.
JoomSEF is distributed as installable Joomla! ZIP package.
Checklist before install:
-
make sure the rewrite module is installed and available at your webserver
-
check the write permissions on Joomla directories, see Help → System Info → Directory permissions
-
also check that directory /libraries/joomla/installer/adapters is writeable
To start installation:
-
log-in to your Joomla! backend with Super Administrator privileges
-
go to Extensions → Install/Uninstall
-
under tab Install, in Upload package file select the distribution ZIP package and click Upload File & Install
-
follow the installer instructions and check for any error
JooomSEF installation is fully automated in most cases. It will install:
-
the main JoomSEF component (in components/com_sef and administrator/components/com_sef)
-
JoomSEF system plugin (in plugins/system)
-
language files (in administrator/languages)
-
installer adapter that will enable installing JoomSEF extensions via standard Joomla installer (in libraries/joomla/installer/adapters)
-
database tables (#__sefaliases, #__sefexts, #__sefexttexts, #__sefmoved, #__sefurls, #__sefurlword_xref, #__sefwords)
Except copying component files, JoomSEF will aso check for .htaccess file in the root of your Joomla site or create it if needed. (this only applies to Apache webservers) It will also attempt to determine your site base URL and base on its value set the RewriteBase value in the .htaccess file.
If the installer fails to detect the Joomla! site base URL correctly or the .htaccess files is not writeable or cannot be created, you may need to create/adjust the file after the component is installed. If something went wrong during install, you will mostly notice that by seeing 500 Internal server error on your front page, or by getting 404 Page not found error after clicking any link on the homepage.
Usage of the .htaccess file (or similar on other webserver) is crucial for JoomSEF to run. (please note the directives includedUn a in .htaccess file can also be part of the web server global configuration) This file includes rules that are needed for Joomla to "understand" and handle the SEF URLs.
Except set of RewriteCond and RewriteRule directives, that make sure the processing of SEF URLs is handed to Joomla!, it includes following directives:
Table 2.1. .htaccess directives
| RewriteEngine on | Activates the URL rewrite feature of the webserver, it needs to be activated. |
| RewriteBase value |
Identifies the site base URL relatively to domain root. This means that if your site is placed directly into the domain root, the value shall be just /. If so, in some cases, the whole directive can be left out completely (however, this does not work with every server setup). If the site base is not same as domain root, but e.g. http://www.mysite.com/subfolder, then the value need to equal the path part of the URL, i.e. /subfolder, in the given example. Wrong setting of the value will lead to situation, when click to any link in SEF format will go to 404 - Page not Found error message. So if this is your case, make sure tha value is really correct. |
| Option FollowSymLinks |
This directive is important only in cases, when your site uses symbolic links to point to specific content (available ony on Linux/Unix systems), so in most cases, it is not needed. On the other hand, usage of the Option directive in .htaccess file is often prohibited by global server config. In such case, the presence of the directive will lead to 500 - Internal Server Error message. (in so, try to comment this line out) |
Editing .htaccess file is possible through JoomSEF editor (if writeable for Joomla), using FTP client or using Joomla component that allows editing files, such as eXplorer. When using FTP client, make sure that showing of hiddent files is on, as files starting with "." are considered hidden at Unix/Linux systems.
For JoomSEF, to be active, two settings in Joomla! Global Configuration need to be switched on:
Search Engine Friendly URLs and Use Apache mod_rewrite
These can be either switched from JoomSEF Control Panel (in right-bottom box) or in (menu) Site → Global Configuration → (tab) Site → (box) SEO Settings
To start uninstallation:
-
log-in to your Joomla! backend with Super Administrator privileges
-
go to Extensions → Install/Uninstall
-
under Components tab select the SEF component and click Uninstall button in the toolbar
-
uninstallation should complete automatically
Uninstallation will remove all the parts installed during Installation, however it will not remove the tables from the database, but will add the _bak suffix to their names instead.
Table of Contents
Even though it is not the only function of JoomSEF anymore for quite some time now, the URL rewriting still remains its main feature. The standard Joomla! URL has the form of domain.tld/index.php?option=com_content&view=article&id=2&Itemid=5, which we call non-SEF URL. This tells Joomla!, that it should call the Content component (option variable) and select the menu item with Itemid 5. The other variables are meant directly for the Content component - they tell it to display single article (view variable) with id 2. This form is very easy for web server to understand, but it's not very informative for people or search engines, so JoomSEF translates this non-SEF URL to a more readable form of domain.tld/article-category/article-title. From this SEF URL you can easily tell what the page will be about and search engines may guess the website structure to better understand it and provide more relevant search results.
The reason why JoomSEF generated URLs are nicer than those generated by standard Joomla! SEF function is that JoomSEF stores the original Joomla URL in the database with the corresponding SEF URL. Standard Joomla! SEF does not use database, so all the variables needed for Joomla! have to be somehow encoded in the URL so Joomla! can parse all of them correctly. On the other hand, JoomSEF generated SEF URL can be anything you like and the variables needed for Joomla! are correctly taken from the database.
Each SEF URL is created when its non-SEF equivalent is first encountered on the web site so when someone opens the frontpage for the first time, only the URLs present on that page are created. When some of these URLs are then clicked and the new page is opened, more URLs present on the new page are created, so it takes some time until all the URLs of your web site are created in the database.
The process of converting non-SEF URL to SEF one is unfortunately not easy because every component uses its own variables and needs different SEF URL structure. To handle every component's URLs correctly JoomSEF uses small add-ons called JoomSEF Extensions that take care of converting URLs to SEF for individual components. So when converting some Joomla! URL to SEF, JoomSEF looks at the option variable to know which component this URL links to. Then it searches the installed JoomSEF Extensions and tries to use the corresponding extension, so every component you have installed in your Joomla! needs to have the JoomSEF Extension also installed so the URLs are converted to SEF correctly. If the JoomSEF Extension is not installed for the component, you can still use JoomSEF's basic rewriting (which creates SEF URL by storing individual variables values in URL separated by slash - ie. domain.tld/content/article/2) or there is still chance that the component comes with the standard Joomla! router, which can also be used with JoomSEF. If you don't want or can't use any of these, you can set JoomSEF not to SEF URLs for this particular component.
JoomSEF comes with the JoomSEF Extensions for standard Joomla! components preinstalled. You can get JoomSEF Extensions for other components from ARTIO website - some of them are free and some are paid. You can find the complete list of JoomSEF Extensions available from ARTIO here. You can also sometimes find JoomSEF Extensions made by 3rd party or directly by component's developers.
The very important thing is that every component in Joomla! has to support SEF correctly, so all the links visible to users are sent to JoomSEF so it can rewrite them to SEF. As this is not always the case, Joomla! offers the way to handle this in a form of System - SEF plugin, so if you experience problems with some links not being SEF, check if the System - SEF plugin in Joomla! is enabled.
Another thing is, that when using SEF, URLs often look like domain.tld/menu/category/article so the web browsers think that the current directory on the web server is /menu/category, so it is important for the components to use absolute links when displaying images and using AJAX. Joomla! and JoomSEF offer the usage of base tag in your web site which can sometimes fix these problems, however if you use many components with such problems, it is often very difficult to find the configuration which would fix everything.
Table of Contents
Menu path: Components -> ARTIO JoomSEF ( -> Control Panel)
The control panel is the main page of JoomSEF's administration from which you can control all of JoomSEF's functionality. It is divided into three sections:
-
Top - navigation menu and informative or error messages
-
Left - action buttons (these will be described in another chapters)
-
Right - informative panels
Provides basic information about the currently installed version of JoomSEF with its description and links to ARTIO website, license and donation through PayPal. It also shows the newest version available, if version checker is not disabled.
Shows the status of SEF related configuration on your website with buttons to enable or disable them, so you can control all the most important configuration at one place.
Shows the JoomSEF related newsfeed directly from ARTIO server.
Table of Contents
- 5.1. Basic Configuration Options
- 5.2. Advanced Configuration Options
- 5.3. Cache Configuration Options
- 5.4. Title and Meta Tags Configuration Options
- 5.5. SEO Configuration Options
- 5.6. SiteMap Configuration Options
- 5.7. JoomFish Related Configuration Options
- 5.8. 404 Page Options
- 5.9. Registration Options
Most of the JoomSEF configuration is done by clicking the "Global Configuration" button on JoomSEF Control Panel or selecting the Components -> ARTIO JoomSEF -> Configuration menu. This will lead to a page with several configuration tabs, each of them described in a separate subchapter that follows. You can configure JoomSEF on global level here, but some of the settings can be overriden per component using the Manage Extensions page described in another chapter.
Options in this tab control JoomSEF's basic functions and basic SEF URL's appearance.
- JoomSEF Enabled
-
This option controls whether JoomSEF will be used to process non-SEF URLs on your site. If disabled, the standard Joomla! core SEF will be used.
Default value: Yes
- Disable creation of new SEF URLs
-
If this option is set to Yes, JoomSEF won't create any new SEF URLs and will use only the ones already created.
It is useful if you have a web site with static content and all of your URLs are created correctly, so you can be sure that no new URL will be created.
Default value: No
- Number duplicate URLs
-
If set to No, duplicate URLs will be stored in database and only one of them will be used. JoomSEF tries to choose the best one, but that is not always possible. If there are many duplicates for one SEF URL, the links probably won't work correctly.
If set to Yes, duplicates will be numbered, so the correct URL will be always used.
Default value: No
- Replacement character
-
This character will be used to replace unknown characters in the URL.
Default value: -
- Page spacer character
-
This character will be used to separate the page number from the rest of the URL when Number duplicate URLs option is enabled.
Default value: -
- Strip characters
-
These characters will be replaced by Replacement character in the URL. Separate the characters with | (pipe character).
Default value: ,|~|!|@|%|^|*|(|)|+|<|>|:|;|{|}|[|]|---|--|..|.
- Trim friendly characters
-
These characters will be removed only from the beginning and the end of the URL.
Default value: -|.
- Use Title or Alias
-
You can set Title and Alias for most items in Joomla! (articles, categories etc). Using this option you can select globally what will be used to create corresponding URLs. This option can be overriden and set separately for each component.
Default value: Full Title
- File suffix
-
Use this option to set suffix for URLs. It is recommended to leave it blank or use common .html suffix to simulate static pages.
Default value: blank
- Default index file
-
You can set a file which will be used for blank URL (homepage), so there will be for example http://domain.tld/index.php instead of just http://domain.tld/ created. This can be useful for some crawlers, but use it only if you experience problems with them.
Default value: blank
- Page text
-
This text will be appended to URL for individual pages in listings. %s in the Page text will be replaced with a page number.
Default value: JText::_('PAGE')-%s
- All lowercase
-
If set to Yes, whole URL will be converted to lowercase.
Default value: Yes
- Use index for sections and categories
-
If set to Yes, the Default index file will also be appended to links to sections and categories for Content component.
Default value: Yes
- www and non-www domain handling
-
Use this option to set how to handle domains with and without www.
- Don't handle
-
JoomSEF will leave domain as it is.
- Always use www domain
-
Any domain without www used to access the site will be redirected to the same domain with www.
- Always use non-www domain
-
If a domain with www is used to access the site it will be redirected to the same domain without www.
Default value: Always use www domain (if domain with www was used when installing JoomSEF) / Don't handle (otherwise)
The Advanced tab is used to configure some more advanced JoomSEF's functionality related to creating and processing of SEF URLs. It is separated into two boxes described in the following subchapters.
- Allow UTF-8 characters in URL
-
If set to Yes, all the characters except Strip Characters will be allowed in URLs. However, the Non-ascii char replacements are still applied.
Default value: No
- Non-ascii char replacements
-
Here you can set the character pairs for replacement - the first character in a pair is replaced by the second one in the URL.
Characters in the pair are separated by | (pipe character) and pairs are separated by comma.
Default value: Á|A, Â|A, Å|A, Ă|A, Ä|A, À|A, Ć|C, Ç|C, Č|C, Ď|D, É|E, È|E, Ë|E, Ě|E, Ì|I, Í|I, Î|I, Ï|I, Ĺ|L, ľ|l, Ľ|L, Ń|N, Ň|N, Ñ|N, Ò|O, Ó|O, Ô|O, Õ|O, Ö|O, Ŕ|R, Ř|R, Š|S, Ś|O, Ť|T, Ů|U, Ú|U, Ű|U, Ü|U, Ý|Y, Ž|Z, Ź|Z, á|a, â|a, å|a, ä|a, à|a, ć|c, ç|c, č|c, ď|d, đ|d, é|e, ę|e, ë|e, ě|e, è|e, ì|i, í|i, î|i, ï|i, ĺ|l, ń|n, ň|n, ñ|n, ò|o, ó|o, ô|o, ő|o, ö|o, š|s, ś|s, ř|r, ŕ|r, ť|t, ů|u, ú|u, ű|u, ü|u, ý|y, ž|z, ź|z, ˙|-, ß|ss, Ą|A, µ|u, Ą|A, µ|u, ą|a, Ą|A, ę|e, Ę|E, ś|s, Ś|S, ż|z, Ż|Z, ź|z, Ź|Z, ć|c, Ć|C, ł|l, Ł|L, ó|o, Ó|O, ń|n, Ń|N
- Exclude source info (Itemid)
-
If set to Yes, the Itemid variable will not be stored with URLs in the database. It is usually used together with Reappend source (Itemid) option when you are experiencing problems with modules not showing where they should.
Default value: No
- Reappend source (Itemid)
-
Can only be used with Exclude source info (Itemid) option enabled. If set to Yes, the removed Itemid variable is appended back to URL as non-SEF variable.
Default value: No
- Ignore multiple sources (Itemids)
-
If enabled, only one SEF URL will be created for links that differ only by the Itemid variable (same pages linked by different menu items). Helps preventing duplicates, but links sometime don't work as expected.
Default value: Yes
- Append non-SEF variables to URL
-
If enabled, frequently changing variables are not stored in database, but they are appended to URLs as non-SEF variables instead. This reduces database usage and also helps preventing duplicates in some extensions.
Default value: Yes
- Be tolerant to trailing slash
-
If enabled, both URL versions (with and without the trailing slash) will work. Otherwise only one version (the one stored in the database) will work.
Default value: Yes
- Redirect nonSEF URLs to SEF
-
If enabled, when accessing the site using the non-SEF URL you will be redirected to the correct SEF URL.
Note: As a security measure, only links that already have the corresponding SEF URL created in the database will be redirected - no new SEF URLs will be created using this feature.
Default value: Yes
- Use Moved Permanently redirection table
-
Enables the use of 301 Redirects. If enabled, when you manually change some SEF URL using the Manage SEF URLs page, the corresponding 301 redirect will be automatically created, so the old URL still works.
Default value: Yes
- Ask before saving URL to Moved Permanently table
-
If enabled, when you manually change some SEF URL using the Manage SEF URLs page, you will be asked whether to automatically create the corresponding 301 redirect.
Default value: Yes
- Do not remove SID from SEF URL
-
If set to Yes, the sid variable will not be removed from SEF URL and will be stored with it in the database. This make help some old components to work properly, but may create duplicities with others.
Default value: No
- Set server QUERY_STRING
-
If set to Yes, the server QUERY_STRING variable will be set according to parsed variables. Fixes some redirection problems with VirtueMart and other components.
Default value: Yes
- Parse Joomla SEO links
-
If set to Yes, JoomSEF will try to use core Joomla! SEF router to parse SEF URLs which JoomSEF couldn't find in database.
Default value: Yes
- Filter variable values
-
If set to Yes, all variables in URLs will be checked and won't be SEFed if containing some of the potentionally dangerous words.
Default value: Yes
- Filter these words
-
Set the words to be considered dangerous using the Filter variable values option. Separate each word by space.
Default value: http:// http// https:// https// www. @
- Variables to exclude from filtering
-
Set variables to be excluded from Filter variable values option. Separate each variable by ; (semicolon).
Default value: blank
- Filter system variables
-
If enabled, system variables (Itemid, tmpl, option, format, layout) will be filtered to contain only allowed values.
Default value: Yes
- Prevent non-SEF variables from overwriting the parsed ones
-
If enabled, the parsed variables from SEF URL won't be overwritten by the same non-SEF variable appended to the SEF URL.
Default value: Yes
- Custom non-SEF variables
-
List of variables to be globally considered non-SEF if Append non-SEF variables to URL option is enabled. Separate variables by semicolon.
Default value: blank
- Automatic canonical link generation
-
If enabled, when the page is accessed using the SEF URL with some non-SEF variables appended, the canonical link will be automatically generated using the SEF URL only.
Default value: Yes
- SEF URLs using component template
-
If enabled, the URLs with tmpl=component will be SEFed. This may interfere with some components using AJAX, so enable only if you need it.
Default value: No
- Set page base href value
-
Controls the way the base href value is generated. May be used to fix some problems like images not shown correctly when using SEF URLs.
- Yes - always use only base URL
-
The base href will be generated using the website's root URL.
- Yes - always use full SEO URL
-
The base href will be generated using the current SEF URL.
- No - disable base href generation
-
The base href won't be generated at all.
- No - leave original
-
JoomSEF leaves the original Joomla! base href.
Default value: Yes - always use only base URL
- Fix index.php links
-
If enabled, the index.php will be removed from non-SEF URLs, thus removing duplicates.
Default value: Yes
- Fix document format
-
If enabled, fixes the document format when using PDF or feed links. Enable only if you are experiencing problems with them, may interfere with other plugins.
Default value: No
This feature is used to store the information about SEF URL's origin in the database along with the URL. It may be helpful to find out where the strange URLs are coming from.
- Enable URL source tracing
-
Whether the SEF URL's source should be traced and stored in the database. The information stored are:
-
URL of page that the SEF URL was generated on
-
The page's referrer
-
The user agent (useful to find out whether the URL was generated by a user or a bot)
-
The list of functions in the PHP code that called the URL generation
Default value: No
-
- Tracing depth
-
How many function calls should be traced back.
Default value: 3
The Cache tab is used to control the URLs Cache behaviour. The cache is described in more detail in the URLs Cache section.
- Use cache
-
Whether the URLs Cache functionality should be enabled.
Default value: Yes
- Maximum cache size
-
How many SEF URLs may be stored in the cache. No more URLs are stored in cache when this limit is reached.
Default value: 1000
- Minimum cache hits count
-
How many times the SEF URL needs to be visited before it's stored in the cache.
Default value: 10
- Record hits for cached URLs
-
Whether to record hits count for URLs that are already stored in cache. This saves some database queries if set to No, but you can't keep track of how many times the cached URLs were really visited.
Default value: No
- Display error if cache gets corrupted
-
Whether to display the error message in the frontend when the cache file gets corrupted.
Default value: No
These options are used to control how the SEF URLs Meta Tags will be shown in the page.
- Enable MetaData generation
-
Whether the meta tags set for SEF URLs will be shown in the website's
headsection. If disabled, the standard Joomla! meta tags will be shown.Default value: Yes
- Prefer JoomSEF titles
-
Whether JoomSEF should control the page title's appearance or not. If set to No, the standard Joomla! page title will be used.
Default value: Yes
- Use sitename in page titles
-
Defines how the site name is used in page titles. The site name is set in Joomla!'s Global configuration.
- Yes - before page title
-
The site name will be prepended to the page title.
- Yes - after page title
-
The site name will be appended to the page title.
- No
-
The site name will not be used in the page title.
Default value: Yes - after page title
- Sitename separator
-
The character that will be used to separate the site name and the page title if site name is to be added to page title.
Default value: -
- Rewrite keywords
-
Whether the Joomla!'s generated keywords tag should be rewritten by the keywords from JoomSEF. If set to No, the keywords from JoomSEF will be appended to the Joomla!'s generated one.
Default value: Yes
- Rewrite description
-
Whether the Joomla!'s generated description tag should be rewritten by the description from JoomSEF. If set to No, the description from JoomSEF will be appended to the Joomla!'s generated one.
Default value: Yes
- Prevent sitename duplicity
-
Whether to prevent duplicity if the site name is the same as page title and site name is to be added to page title.
Default value: Yes
You can set meta tags that will be globally shown on every page of your web site here.
Some predefined meta tags can be set in the Standard Meta Tags box - these include the generator tag and the meta tags with authentication keys for Google Webmaster Tools, Live.com Webmaster Central and Yahoo Site Explorer.
You can also set your own meta tags using the Custom Meta Tags box - just click the Add Meta tag button and set the name and content of the meta tag. To remove the meta tag, click the Remove Meta tag button.
The options available on the SEO tab is used to control the Internal Links functionality.
- Nofollow external links
-
If enabled, JoomSEF will try to find all the external links (URLs to other domain) on your site and will add the
rel="nofollow"to them, so search engines shouldn't crawl those links from your site.Default value: No
- Enable Internal links
-
Whether the Internal links functionality should be enabled.
Default value: Yes
- Nofollow internal links
-
If enabled, the links created by the Internal links feature will have the
rel="nofollow"added, so search engines shouldn't crawl those links.Default value: No
- Open links in new window
-
Whether the links created by the Internal links feature should be opened in new browser window.
Default value: No
- Maximum links for each word
-
How many occurences of each word should be replaced by internal links assigned to it.
Default value: 1
You can control the behaviour of the SiteMap feature using the SiteMap tab.
- XML file name
-
The Sitemap XML file name. This file will be generated in the website's root.
Default value: sitemap
- Default Indexed
-
The default Indexed field value for the newly created SEF URLs.
Default value: No
- Default Change frequency
-
The default Change frequency field value for the newly created SEF URLs.
Default value: weekly
- Default Priority
-
The default Priority field value for the newly created SEF URLs.
Default value: 0.5
- Show Date in sitemap
-
Whether the Date field (the
lastmodtag) should be shown in the generated Sitemap XML file.Default value: Yes
- Show Change frequency in sitemap
-
Whether the Change frequency field (the
changefreqtag) should be shown in the generated Sitemap XML file.Default value: Yes
- Show Priority in sitemap
-
Whether the Priority field (the
prioritytag) should be shown in the generated Sitemap XML file.Default value: Yes
The Sitemap XML file can be automatically pinged to Google, Yahoo! and Bing every time you generate the new Sitemap XML file. You can also set the Ping services (see http://en.wikipedia.org/wiki/Ping_(blogging) for more information) which may be pinged manually from the Sitemap Manager page.
- Ping after XML generation
-
If enabled, Sitemap XML file will be automatically pinged to Google, Yahoo! and Bing each time you generate the new Sitemap XML file.
Default value: Yes
- Yahoo! Application ID
-
This needs to be set in order for Yahoo! ping to work correctly.
Default value: blank
- Ping services
-
The list of Ping services (each on a separate line) to be pinged by the Ping Services button in the Sitemap Manager. The list of available Ping services may be found on the internet.
Default value: http://blogsearch.google.com/ping/RPC2, http://rpc.pingomatic.com/
The JoomFish tab lets you configure JoomSEF's handling of URLs on multilingual web sites when JoomFish component is installed.
- Language integration
-
Determines how the language code will be integrated into the SEF URL.
- include in path
-
The language code will be the first part of the SEF URL, for example:
www.artio.net/en/news - add as suffix
-
The language code will be appended to the end of the SEF URL, for example:
www.example.com/news_en - use different domains
-
Each language will use its own domain. These domains can be set in the Domain configuration section of the page.
- do not add
-
The language code will not be added to SEF URL. This may be useful when each SEF URL is different for all languages (when you have all the articles correctly translated), so the URLs are not duplicated.
Default value: include in path
- Always use language
-
If set to Yes, the
langvariable will always be stored with the URL. If set to No, some URLs without thelangvariable specified will show the page in an unspecified language.Default value: Yes
- Translate URLs
-
Whether the titles in the SEF URLs should be translated to match the language. If set to No, you shouldn't use the do not add option in Language integration setting, because there would be no way to determine the language that should be shown.
Default value: Yes
- Get language from browser setting
-
Whether the language should be taken from user's browser setting if the language is not specified by the URL (for example for the frontpage).
Default value: Yes
- Save language to cookie
-
Whether the last used language should be stored in the cookie, so when user opens your page again, the same language as last time will be used. This is also useful when some component uses redirections without the
langvariable set - in such case, the page will not change the language randomly, but the current language is preserved.Default value: Yes
- Main language
-
You can select the language which will not have the language code integrated into the SEF URL. This language is also used when user opens the frontpage and language is not determined from browser or cookie.
Default value: (none)
- Domain configuration
-
In this section you can set the domain for each language if use different domains option is selected for Language integration setting. Only the domain should be set in the field (without http:// or any slashes), for example: www.example.com for English and www.example.cz for Czech.
Default value: each language has the current domain set
- Enable/Disable Jfrouter plugin
-
You can use this button to simply enable or disable the Jfrouter plugin. More information about the JoomSEF configuration with Jfrouter plugin may be found in Using JoomSEF with JoomFish usage tip.
You can set how JoomSEF should respond when someone tries to access some non-existent page on your web site using the options on the 404 Page tab.
In the 404 Page box you can set the basic options for displaying the 404 error page.
- 404 Page
-
What page should be displayed when 404 Not found error is detected.
- (Custom 404 Page)
-
The Custom 404 Page will be shown. This page can be edited in the Custom 404 Page box on the same page. It is the automatically created uncategorized article with the 404 title.
- (Front Page)
-
The web site's front page will be shown.
- (Joomla! Error Page)
-
The standard Joomla!'s error page will be shown.
- (other options)
-
You may select any other uncategorized article you have created to be shown as a 404 page.
Default value: (Custom 404 Page)
- Show 404 Message
-
If enabled, the standard Joomla! message will also be shown on the 404 page.
Default value: No
- Show Joomla! Template
-
Whether the 404 page should be shown with the selected Joomla! template. If disabled, the component template will be used.
Default value: Yes
- Record 404 page hits
-
Whether the non-existent URLs should be stored in the 404 Log. If disabled, the number of SQL queries may be decreased, but you won't be able to see hits to non-existent pages (you may use the Google Webmaster Tools for this).
Default value: No
Use this box to select the menu item to be used when the 404 page is displayed.
- Use Itemid for Default 404 Page
-
If disabled, you won't be able to select which modules should be shown on the 404 page. If you want to be able to choose which modules should be shown on the 404 page, enable this option.
Default value: No
- Select Itemid
-
Use this option to select the menu item which should be used for the 404 page. The modules assigned to this menu item will be displayed on the 404 page. You can also create a fake menu that is not displayed anywhere on your web site and select its menu item - that way you can have different modules displayed on the 404 page than anywhere else on your web site.
Default value: nothing selected
The Registration tab includes options for better integration with ARTIO services.
If you have purchased the paid version of ARTIO JoomSEF, enter your Download ID in the JoomSEF Download ID field. The ID is used to identify your copy during online updates.
Here you may enter your account information for ARTIO web site if you have one. This may be used for better integration with technical support or providing relevant information to you. No information except these form info are sent from your site.
- Display ARTIO Newsfeed
-
Whether the ARTIO Newsfeed panel will be shown on the JoomSEF's Control panel page.
Default value: Yes
- Check for newer versions
-
Whether the newest version available will be checked in the ARTIO JoomSEF panel on the JoomSEF's Control panel page.
Default value: Yes
Table of Contents
JoomSEF generates SEF URLs automatically but sometimes you may want to adjust them a little bit. This chapter describes the options available to manage SEF URLs in JoomSEF's database.
The JoomSEF URL Manager can be opened from the Components -> ARTIO JoomSEF -> Manage SEF URLs menu or by clicking on Manage SEF URLs, Manage Custom URLs or View 404 Logs button in the JoomSEF Control panel - each of these buttons opens the same page with different view mode selected. The URL Manager allows you to view, create, modify, delete, import or export the SEF URLs in JoomSEF's database. The following sections describe the main JoomSEF URL Manager page and various tasks you can do with it.
When you open JoomSEF URL Manager using the Manage SEF URLs menu item or JoomSEF control panel button, you will see the following list of the URLs stored in JoomSEF's database.
The columns are described in the following table.
- Hits
-
Number of times the URL has been clicked.
- SEF URL
-
The SEF URL visible on the page.
- Real URL
-
The standard Joomla! URL that will be used when SEF URL is clicked.
- Trace
-
The tracing information. This column is only visible if URL Source tracing is enabled. You can use this when debugging to find out how some bad SEF URL has been created - the page where the URL was created, Referer, User agent and backtrace of PHP functions to the specified level are stored here.
- Enabled
-
If a SEF URL is disabled, then it is displayed on the web site as usual, but it shows the 404 - Not found page when clicked.
- SEF
-
If you disable SEF for some URL, then its Real URL form will be shown on the web site.
- Locked
-
If some URL is locked, it cannot be deleted in any way, so if you have some custom URL created, you can lock it so it can't be deleted accidentally.
- Active
-
If there are some duplicate URLs (URLs with the same SEF URL but different Real URL) JoomSEF doesn't know which one of the Real URLs to use when the SEF URL is clicked. By making one of them Active, you tell JoomSEF which one it should always use.
- Cached
-
Shows whether the URL is currently stored in JoomSEF's cache or not. This column is only visible when JoomSEF Cache is enabled.
You can also use the set of filters to filter displayed URLs by various criteria.
The ViewMode filter offers the following options:
- Show All Redirects
-
Shows all the SEF URLs stored in database.
- Show Custom Redirects
-
Shows only SEF URLs marked as custom.
- Show SEF URLs
-
Shows only the automatically created SEF URLs (URLs not marked as custom).
- Show Links to Homepage
-
Shows only URLs linking to the homepage.
- Show 404 Log
-
Shows the 404 URLs log.
- Show Duplicities
-
Shows only duplicate SEF URLs.
The Hits and Itemid filters are straightforward.
Filtering URLs by their SEF URL or Real URL can be based on textual match or by a regular expression - if you put a text directly, any URL containing that text will be matched, but if you use the 'reg:' prefix, then the regular expression search will be used. For example if you want to display only the URLs starting with home you can use the filter reg:^home.
The Component and Language filters are again straghtforward, however the Language filter is only available if the JoomFish component is installed.
The Reset button resets the filters.
If the Show Links to Homepage view mode is selected, then there is also the Create links to homepage button visible in the Filters box. You can use it to create the URLs linking to homepage in every available language if they were not created automatically.
If the Record 404 page hits option is enabled in JoomSEF's configuration then all the URLs accessed on your site that returns the 404 error are logged in the database. You can browse this log by selecting the Show 404 Log view mode in JoomSEF URL Manager.
The layout is very similar to other view modes, however there is one special action available for logged 404 URLs - for each 404 URL you can directly create the 301 Redirect using the Create 301 button in the toolbar. This is very useful when for example some of the pages on your web site is not available any more, but it is still indexed by search engines or some users have it saved in their bookmarks. Using the 404 log you can find this out that some 404 URL is accessed many times and simply create the 301 Redirect to the new page, so users won't see the Not found error.
As in any other Joomla! component the toolbar contains buttons you can use to perform various tasks with the URLs. However, there were too many buttons for the actions affecting more than one URL at once, so we've decided to use a little different approach - as you can see on the following figure, there are two select boxes and a Proceed button in our toolbar.
The first select box is used to set if only the selected URLs (Only selected option) or all the URLs currently displayed (All filtered option) should be affected. When the All filtered option is selected and there is more than one page of displayed URLs, then ALL the displayed URLs will be affected, not only the ones displayed on the first page.
In the second box you can select the action to perform with the URLs.
By clicking the Proceed button the selected action will be performed.
You can create new URL by clicking the New button in the toolbar. To modify existing URL you can either click the corresponding SEF URL in the list, or select the corresponding check box and click the Edit button in the toolbar. When creating or modifying the URL you will see the following page.
On the URL tab you can set the basic parameters of the URL:
- New SEF URL
-
The SEF URL to be displayed on the web site. The URL must be relative to the web site's root and cannot contain the leading slash.
- Old non-SEF URL
-
The Real URL to be passed to Joomla! when this URL is accessed. This URL needs to start with the index.php and may not contain the Itemid variable which is set separately.
- Itemid
-
The Itemid variable of the Real URL.
- Save as Custom Redirect
-
Whether this URL should be marked as Custom.
- Enabled
-
Whether this URL is enabled.
- SEF
-
Whether this URL should be displayed as SEF.
- Locked
-
Whether this URL is locked.
- Trace Information
-
Shows the trace information stored with the current URL. This field is only visible when URL Source tracing is enabled.
On the Aliases tab you can set the list of aliases to be assigned to this URL. Each alias will be 301 redirected to this URL. This feature is described in more detail in the SEF URLs Aliases section.
The Meta Tags tab lets you set the meta tags that should be generated in the head section of your web site when this URL is accessed. This feature is described in more detail in the URLs Meta Tags section.
The SiteMap tab lets you set sitemap related parameters for this URL. This feature is described in more detail in the SiteMap chapter.
On the Internal LInks tab you can create a list of words that should link to this URL. This feature is described in more detail in the Internal Links section.
By using the import and export functions you can easily backup your SEF URLs, transfer them to another web (for example from the development to the production web site) or migrate your SEF URLs from another SEF component to JoomSEF or from Joomla 1.0 to Joomla 1.5.
The export functionality is implemented as one of the actions you can do with URLs from the toolbar, so you can just choose which URLs you want to export using the first select box in the toolbar, select the Export action in the second box and click the Proceed button. The SQL file with the exported URLs will be generated and offered for you to save.
When you click the Import button in the toolbar you will be taken to the Import URLs page.
To import the URLs from a file with previously exported URLs use the Import URLs From File box - just select the file in the Import File field and click the Import URLs button. Using this function you can import URLs exported from any previous version of JoomSEF or even from sh404SEF or AceSEF components - the file format will be recognized automatically and imported correctly. When importing URLs from JoomSEF version 2.x or earlier the Joomla 1.0 URLs will be automatically updated to the Joomla 1.5 format. When importing URLs from sh404SEF make sure to first import the URLs and then the meta tags.
If you've had sh404SEF or AceSEF previously installed you can use the Import URLs From Database box to import the URLs directly from their database - just click the Import URLs from AceSEF table or Import URLs from sh404SEF table button.
Each URL in the JoomSEF's database may have the following meta data assigned:
- Title
-
The individual page title (title tag) and title meta tag.
- Description
-
The description meta tag.
- Keywords
-
The keywords meta tag.
- Content-Language
-
The lang meta tag.
- Robots
-
The robots meta tag.
- Googlebot
-
The google meta tag.
- Canonical Link
-
The canonical link tag.
When someone opens the SEF URL, JoomSEF sets the meta data for the page according to the meta tags set and according to settings on Title & Meta Tags tab in JoomSEF's Configuration. If any of the meta tags is not set, JoomSEF does not use an empty value, but it keeps the default meta tags provided by Joomla! instead. Some JoomSEF Extensions can generate the meta tags for SEF URLs automatically from the pages content.
There are two ways to manage the meta tags described in following sections.
You can use the URL Manager to set all of the available meta tags for each URL individually. This can be achieved using the SEF URL page (as described in Creating and modifying URLs section) on Meta Tags tab.
The Meta Tags Manager can be used to set the Title, Description and Keywords meta tags for multiple URLs at once. You can open the Meta Tags Manager using the Manage Meta Tags menu item or Manage Meta Tags button in the JoomSEF's Control panel.
Here you can see the list of URLs with their Title, Description and Keywords meta tags. You can change these meta tags for all the URLs displayed on the page and then save them all at once by clicking the Save or Apply button in the toolbar.
You can also use the Filters box to display only the URLs you want to manage meta tags for.
Even when all the URLs on the page have their SEF form already created, each non-SEF URL that should be converted to SEF when browsing the page still requires one query to the database to look it up, which may sum up to many queries for each page display if there are many URLs on the page. The database load can be decreased by using the URLs caching.
Everytime someone opens some SEF URL in his browser, the hits count of the URL is increased by one. When the hits count exceeds the predefined threshold the URL is stored in the cache file on the disk. Everytime the URL needs to be converted from non-SEF form to SEF, the cache is checked first and if the URL is found there, there's no need to query the database. The whole cache file is loaded from disk to memory only once when the page is opened, so the cache lookup is very fast.
You can control the URLs cache parameters in the JoomSEF's configuration on the Cache tab. The settings are described in the Cache Configuration Options section.
When the SEF URL is once created for the non-SEF one it is then always used even when you change some configuration so the different SEF URL would be created. There are three options to create SEF URLs with the new configuration.
Purging the URLs basically deletes all the automatically created SEF URLs that are not marked as Locked from the database. No URLs saved as Custom or Locked are deleted. The deleted URLs are then created again when browsing the page with the new configuration.
You can purge the URLs using the Purge URLs button in JoomSEF's Control panel.
If you don't want to purge all the URLs, for example if you change the URLs generation settings only for one component, you can use the URLs Manager and using the Filters delete only the SEF URLs that need to be recreated.
More information about the URLs Manager can be found in the URLs Management section.
The Update URLs feature found in the JoomSEF's Control panel goes through all the automatically created SEF URLs that are not Locked and creates them again using the current configuration. However, it is needed to emulate the Joomla! frontend in the backend for this function to work, which is not always easy, so the resulting SEF URLs may sometimes use different language files than in the real frontend, so the results may be a little different. As with purging, only the URLs that are not saved as Custom or Locked are updated.
Table of Contents
As was explained in the How It Works chapter, each component you have installed in Joomla! needs its own JoomSEF Extension installed in JoomSEF for SEF URLs to be created correctly for the component.
JoomSEF comes with the preinstalled extensions for the following standard Joomla! components:
-
Banners
-
Contacts
-
Content
-
Mail To
-
News Feeds
-
Search
-
User
-
Web Links
-
Wrapper
You can get JoomSEF Extensions for other components from ARTIO website - some of them are free and some are paid. You can find the complete list of JoomSEF Extensions available from ARTIO here. You can also sometimes find JoomSEF Extensions made by 3rd party or directly by component's developers.
The Extensions Management page can be opened using the Extensions Management button in the JoomSEF's Control panel or the Manage Extensions menu item. There are two lists on the page - the top list shows the installed JoomSEF Extensions and the bottom list shows the installed Joomla! components without the JoomSEF Extension installed.
The Installed JoomSEF Extensions list contains the following fields:
- SEF Extensions
-
The name of the JoomSEF Extensions.
- Component
-
The name of the component the extension belongs to.
- Author
-
Author of the extension.
- Version
-
The currently installed extension version.
- Date
-
The date when the currently installed extension version has been released.
- Newest version
-
The newest version of the extension available on the ARTIO Upgrade server. The dash means that this extension is not available on ARTIO Upgrade server.
- Type
-
Whether the extension on ARTIO Upgrade server is Free or Paid.
If the extension is Paid, the key icon can be used to enter your extension download ID. If the key icon is in grayscale, the download ID is not set. If the key icon is gold, the download ID is set (however, the key icon color does not mean that the download ID is valid).
- Upgrade
-
If there is newer version available on the ARTIO Upgrade server, the Upgrade button can be used to directly upgrade your installed extension.
- Active Handler
-
The currently active handler of the component. These are described in the Component Handlers section.
The list of components without JoomSEF Extension installed contains the following fields:
- Component
-
The name of the component.
- Extension Availability
-
Whether the extension for this component is available on ARTIO Upgrade server and whether it's Free or Paid.
If the extension is Paid, the key icon can be used to enter your extension download ID. If the key icon is in grayscale, the download ID is not set. If the key icon is gold, the download ID is set (however, the key icon color does not mean that the download ID is valid).
- Installation
-
If the extension is available on the ARTIO Upgrade server, the Get Extension button can be used to directly install it. If the extension is paid and the download ID is not set, you will be taken to the ARTIO E-Shop page instead.
- Active Handler
-
The currently active handler of the component. These are described in the Component Handlers section.
- Parameters
-
The Parameters icon can be used to open the component's URL creation parameters. These are described in the Extension Parameters section.
The JoomSEF Extensions use the standard Joomla! ZIP installation package format. There are three ways to install the JoomSEF Extension:
-
The fastest and easiest way is to use the Get Extension button in the Extensions Management page described in the previous Components Without JoomSEF Extension Installed List section.
-
If you already have the installation ZIP package downloaded, you can use the standard Joomla! installer to install the JoomSEF Extension like any other Joomla! extension. The installer can be accessed from the Extensions -> Install / Uninstall menu.
-
If for some reason the standard Joomla! installer does not work for you (either you use an old version of JoomSEF which does not support it, or there was some error during the JoomSEF installation), you can use the Install SEF Extension page. This can be accessed by clicking the Install button in the Extensions Management page toolbar.
Even though the standard Joomla! installer can be used to install the JoomSEF Extension, it is not the standard Joomla! extension, so the Joomla! installer cannot be used to uninstall it. The only way to uninstall the JoomSEF Extension is by following these steps:
-
Open the Extensions Management page in JoomSEF.
-
Select the radio button next to the JoomSEF Extension in the list you want to uninstall.
-
Click the Uninstall button in the toolbar.
You can control the form of the URLs generated for each component using the Extension parameters. These can be easily accessed by clicking the extension or component name in the list on the Extensions Management page.
There are several groups of parameters each on the separate tab described in the following sections.
The Extension tab contains the parameters that are specific for the current extension. It is the main extension parameters tab where you can set the appearance of the URLs generated for the component. This tab is available only for components that have the corresponding JoomSEF Extension installed. You can see the example of this tab for Content extension in the figure above.
The Meta Tags tab is also available only for components with JoomSEF Extension installed and only if the extension supports JoomSEF's automatic meta tags generation feature. The options are also specific for the component. You can set how the meta tags should be generated for the selected component here.
The Common tab contains the options that are common for all the components. These options are:
- Number duplicate URLs
-
You can either use the configuration from JoomSEF's Global configuration or override it specifically for this component.
Default value: Use global config
- Automatic canonical link generation
-
You can either use the configuration from JoomSEF's Global configuration or override it specifically for this component.
Default value: Use global config
- Ignore multiple sources
-
You can either use the configuration from JoomSEF's Global configuration or override it specifically for this component.
Default value: Use global config
- Itemid handling
-
If set to Use global config, the Exclude source info (Itemid) and Reappend source info (Itemid) options from JoomSEF's Global configuration will take effect. If set to Override, the Itemid won't be excluded from URL.
Default value: Use global config
- Override Itemid
-
If the Itemid handling is set to Override, here you can set the custom Itemid which will always be used for this component URLs. If left blank, the original Itemid from the URL will be used.
Default value: blank
- Ignore Itemids
-
A comma separated list of Itemids that will be ignored, so if JoomSEF encounters one of these Itemids in the URL, it will handle it as if Ignore multiple sources is enabled. So if you have two menu items linking to the same content, you can set one of them to be ignored and the other one will be always used.
Default value: blank
- Use site name
-
Whether to show the site name in the page title for this component.
Default value: Yes
- Custom site name
-
Here you can set custom site name to be used in the page title for this component instead of the default one. Default site name will be used if left blank.
Default value: blank
- Items per page
-
If you have problems with pagination, you can manually set number of items per page for this component here. If left blank, this option won't have any effect.
Default value: blank
- Handling
-
Use this option to set the URLs handler for this component. The URL handlers are described in detail in Component Handlers section.
Default value: JoomSEF handler
- Show Menu Title
-
Whether the menu item title should be present in the URL.
Default value: Yes
- Custom Menu Title
-
Here you can set the custom menu item title to be used in all URLs for this component. If left blank, the default menu item title will be used.
Default value: blank
- Custom non-SEF variables
-
A semicolon separated list of variables that should be treated as non-SEF for this component. You can use this if you have problems with some URLs not generated correctly and creating duplicates in the database, for example if the new version of the component is installed that is not supported by installed JoomSEF Extension yet, and there are some duplicate SEF URLs created in the database that differ in Real URLs only by some variable, or there is some variable which value is unique for each user visiting the site (for example download_id in VirtueMart), you can set this variable as non-SEF so it won't be stored in the Real URLs in the database and will be added as non-SEF to the SEF URL (for example: /shop/download?download_id=123456789).
Default value: blank
- Do not SEF URLs matching regular expression
-
Every URL for this component will be checked against the regular expression pattern set here and if it matches it, the URL won't be converted to SEF. Can be useful if some URLs of the component are not working correctly with JoomSEF, so you can specifically exclude them from being SEFed.
Default value: blank
Each component can have its own handler set in JoomSEF which controls how the URLs for this component are treated. The available options are:
- JoomSEF handler
-
This is the default handler for every component. First it tries to use the installed JoomSEF Extension for the component. If there is no extension installed, then it tries to use the component's own Joomla! router. If the component doesn't come with the Joomla! router then it just creates the SEF URLs using the menu item title used for the component.
- JoomSEF basic rewriting
-
This handler is better then JoomSEF default handler if there is neither a JoomSEF extension nor a Joomla! router available for the component. It creates the SEF URL by taking values of all the variables in the original non-SEF URL and joining them using slashes. Only the
lang,optionandItemidvariables are handled differently -langis handled according to JoomFish related configuration and the menu item title is used instead ofoptionandItemid. So for example theindex.php?option=com_virtuemart&category_id=7&lang=en&page=shop.browse&Itemid=53non-SEF URL would be converted to something like/en/shop/shop-browse/7. - Default Joomla! router
-
If this handler is active, JoomSEF will redirect and URL for this component to be processed by the standard Joomla! SEF router.
- Don't SEF
-
When this option is selected, no URL for this component will be converted to SEF and the original non-SEF URLs will be used.
If the JoomSEF handler is selected, the Active Handler column in the lists on the Extensions Management page will show either JoomSEF extension, Component's router or JoomSEF default handler according to which one is currently available for the component. Based on the JoomSEF handler priorities, only JoomSEF extension can be shown in the Installed SEF Extensions list (since the JoomSEF Extension has highest priority and it is istalled) and only the Component's router or JoomSEF default handler can be shown in the Components without SEF Extension installed list depending on the availability of component's own router (because the JoomSEF Extension is not installed for the component).
The Registration tab is used only to set the extension's Download ID for the JoomSEF Extensions that are paid. You need to set the Download ID for the paid extensions here so you can use the Upgrade feature for them.
The Variables filtering feature is used as a security measure. You can use it to set which variables are only allowed in the URLs for the component and what are their allowed values using the regular expression rules. This is very useful as a protection from duplicate content penalization and from some attacks on your web site.
The usage is:
-
Set the variables you want to filter in the Filter variables field and click the Apply button in the toolbar. Only variables present in this field are shown in the Available variables list above.
-
In the Add rule section create the regular expression for the variable filter test. Check the Negate this rule box if the variable must NOT contain the value described by the regular expression. Click the Add rule button.
-
Select the rule in the Rules list and add variables that should be tested with this rule from the Available variables list to the Assigned variables list.
-
Repeat steps 2 and 3 until all your filters are created. Then click the Save or Apply button in the toolbar.
You can find the example of Variables filtering usage in the Content extension parameters.
The options available on this tab are:
- Filter variables
-
A semicolon separated list of variables that should be present in the Available variables list.
Default value: blank
- Accept only filtered variables
-
If set to Yes, any variable not present in the Filter variables list will cause the URL to fail the variable filter test. Otherwise, the variables not present in the Filter variables list just won't be tested.
Default value: No
- URLs that fail the variable filter test
-
Specify what to do when the URL fails the variable filter test:
- Don't SEF variable
-
Only the variable that failed the test will not be included in SEF URL and will be appended as non-SEF variable.
- Don't SEF URL
-
The whole URL won't be SEFed, but it will still work when clicked.
- Don't process at all
-
The whole URL won't be SEFed and will display the 404 error when clicked.
Default value: Don't SEF URL
Table of Contents
The 301 redirects are proper way to redirect one URL to another if the latter one should always be used instead of the first one, for example when automatically redirecting non-SEF URLs to SEF ones the 301 code tells search engines, that non-SEF URL should not be used and the SEF URL should be used instead, thus eliminating some problems with duplicate content penalization when using Joomla!.
Apart from the automatic redirections there are also three options in JoomSEF to manually set your own 301 redirects, described in the following sections.
The main purpose of these redirects is not to lose the position in search engines when you already have SEF URLs indexed and you want to manually change some of them, so the old indexed SEF URL should still work and be redirected to the new SEF URL. For these redirects to work, the Use Moved Permanently redirection table option has to be enabled in JoomSEF's Configuration on the Advanced tab. These redirects are then created automatically anytime you change some SEF URL stored in the database using the SEF URLs Manager.
Because of the original purpose of this feature the Internal 301 Redirects work only for SEF URLs without any non-SEF variables and only for one domain (they cannot be used to redirect to another web site - that's why they're called Internal).
You can browse the Internal 301 Redirects either by using the Manage 301 Redirects menu item or the Manage Internal 301 Redirects button from JoomSEF's Control panel.
The fields in the manager are very straightforward:
- Moved from URL
-
The original old SEF URL which should be redirected from.
- Moved to URL
-
The new SEF URL which should be redirected to.
- Last used
-
The date and time the old URL has been last accessed and redirected to the new URL.
When creating new Internal 301 Redirect or modifying the existing one the following page is shown:
As explained above, both the Moved from URL and Moved to URL need to be the correct SEF URLs without any domain or non-SEF variables.
301 Redirects using .htaccess file are described in the Edit .htaccess file section.
SEF URLs Aliases are basically different URLs for existing SEF URLs. By accessing any of the SEF URL alias you will be redirected with the 301 code to the corresponding SEF URL. Each SEF URL may have any number of aliases assigned. The big advantage of using aliases is that they can be any URL, not just the SEF one, for example the URLs from your old web site that was using some non-SEF variables that you need to migrate to Joomla! with completely SEF URLs.
The SEF URL Aliases can be set when creating new SEF URL or modifying the existing one using the SEF URL Manager - the aliases can be set on the Aliases tab:
You can enter one SEF URL Alias per line in the Alias list field. The aliases must be relative without the leading slash (so they cannot contain the domain part) and they may contain non-SEF variables. Some correct examples are: old-url.html or article.php?id=10. Incorrect aliases are: www.domain.tld/something.htm (is not relative) or /something.php (contains the leading slash).
Table of Contents
JoomSEF allows you to generate the Sitemap XML file that you can use to tell search engines which URLs you want to index on your web site. The default Sitemap file configuration options can be found in JoomSEF's Configuration and are described in the Sitemap Configuration Options section.
The Sitemap XML format is fairly simple, but JoomSEF provides graphical interface to further simplify the task of managing your Sitemap XML file. If you're interested, you can find more information about the Sitemap XML file format at http://en.wikipedia.org/wiki/Sitemaps.
The graphical SiteMap Manager can be opened using the SiteMap menu item or the Manage SiteMap button in JoomSEF's Control panel.
Here you can see the list of all your SEF URLs and their assigned Sitemap properties. The fields are:
- SEF URL
-
The SEF URL.
- Real URL
-
The Real URL for the SEF URL.
- Indexed
-
Whether the URL will be present in the Sitemap XML file.
- Date
-
The date that the file was last modified.
- Change Frequency
-
How frequently the page is usually changed.
- Priority
-
The priority of the URL relative to other URLs on the site.
The usage of the SiteMap Manager is easy, but it can be a little confusing for the beginners. Before the Sitemap XML file may be created, you first need to select which URLs should be present in it and what are their parameters. To do this, follow these steps:
-
On the first page of URLs, check the box in the Indexed field for those you want to be present in the Sitemap XML file.
-
Set the desired Date, Change Frequency and Priority values for the selected URLs.
-
Click the Apply button in the toolbar - this is very important, since the selected values are not stored when switching to another page!
-
Go to next page and repeat the steps, until all the URLs you want to be present in the Sitemap XML file are selected as Indexed.
To simplify the task of selecting the URLs as Indexed, you may use the Filters fields to display only the URLs you want to index. You can also use the Action fields in the toolbar to set the properties for multiple URLs at once.
When you have all the URLs selected as Indexed and their properties are set correctly, just click the Generate XML button in the toolbar and the Sitemap XML file will be created for you according to the options set in the JoomSEF's Configuration on the SiteMap tab. When the XML file is generated, it can be either pinged automatically to Google, Yahoo, Bing or some other services, or you can ping them manually using the buttons in the toolbar. You can also use the file for example in the Google Webmaster Tools.
Table of Contents
This chapter describes some features that are not the main part of JoomSEF's functionality, but may be very useful.
JoomSEF offers you the graphical interface to edit your .htaccess file directly in your Joomla! administration area. In order for this function to work correctly the .htaccess file needs to be writable by your web server, for example when using Apache the .htaccess file either needs to be owned by www-data user (or any other user used by your Apache server) or needs to have the 0666 access rights set.
To edit your .htaccess file you can use one of the two modes available - Simple and Advanced. These are described in the following sections.
The Simple view can be accessed by clicking the Edit .htaccess menu item or the Edit .htaccess button in JoomSEF's Control panel. It lets you very easily manage the 301 Redirects and the main options available in your .htaccess file.
You can use the 301 Redirects in the .htaccess file to redirect one SEF URL to another URL. Unlike the Internal 301 Redirects the .htaccess 301 Redirects can be used to redirect some URL to a different domain. In the Simple view you can see the list of your .htaccess 301 Redirects:
You can very easily manage these redirects using the New, Edit and Delete buttons in the toolbar. The fields of the redirects are as follows:
- Redirect from
-
The original SEF URL that should be redirected. This URL must be relative to your web site root (without the domain) and must start with the slash.
- Redirect to
-
The new URL that should be redirected to. This URL doesn't need to be SEF and it can either be the full absolute URL (with domain part) or the URL relative to your web site root but starting with the slash.
You can enable (which is recommended) or disable and set the value for the RewriteBase option here. This is important to be set correctly for correct functionality of JoomSEF.
Set RewriteBase to / if your site is located in domain root (i.e. http://www.sitename.com) or use relative path, i.e. /joomlashop if your site is located in domain's subfolder (i.e. http://www.sitename.com/joomlashop).
When in Simple view click the Advanced Edit button in the toolbar to access the Advanced view. In this mode you can basically just edit your .htaccess file manually like you were using any text editor, but you don't need to leave the Joomla! administration area. But be aware that any incorrect change in your .htaccess file can make your website inaccessible!
The Internal links feature allows you to assign words to SEF URLs - these words then will be found in the articles text on your site and made link to the selected URL. For example you can assign the word license to URL of your Licensing policy and every license word in your articles will automatically link to your Licensing policy site. If there is more than one SEF URL assigned to one word, the popup with all the links available will be shown when the word is clicked on the site:
The Internal links feature can be configured in JoomSEF's Configuration on the SEO tab - the options are described in the SEO Configuration Options section.
Since you can assign more than one words to point to one URL and one word can point to more than one URL, there are two places to manage Internal links - in the SEF URL Manager you can assign words to individual URLs and in the Words Manager you can assign URLs to individual words. Both methods are described in the following sections.
The words can be assigned to SEF URL using the SEF URL Manager when you edit the individual SEF URL on the Internal Links tab.
The fields available are:
- Linked words
-
The list of words that currently link to the selected SEF URL. You can remove a word from this list using the Remove selected button.
- Add word
-
Use this field to add a new word to the Linked words list. When you type in the field, the words already stored in the Words Manager are suggested as you type, so you can either select the already known word or type a new one. The word is added by clicking the Add word button.
You can assign the existing SEF URLs to words using the Words Manager, which can be opened using the Manage Words button on the JoomSEF's Control panel.
You can use the Words Manager to create, edit or delete the words which have SEF URLs assigned. The Word Edit page is very similar to the Internal Links tab in the SEF URL Edit page:
Figure 10.6. Word Edit page
The fields are:
- Word
-
The word. You can change it here.
- Linked URLs
-
The list of URLs currently linked by the selected word. You can use the Remove selected button to remove URLs from the list.
- Add URL
-
Use this field to add SEF URL to the Linked URLs list. When you type the list of available SEF URLs is displayed. You can only add the existing SEF URL, so you need to select the URL from the list and then click the Add URL button.
Table of Contents
JoomSEF offers very comfort way to upgrade both the component itself and its extensions using one simple Upgrade page. You can access the Upgrade page using the Upgrade menu item or Check Updates button in JoomSEF's Control panel. The options of upgrade process are described in the following sections.
There are two ways to upgrade JoomSEF - either by using the downloaded installation ZIP package or by automatically upgrading from ARTIO server.
You can use this option if you have JoomSEF's installation ZIP package downloaded. Select the package in the Package File field of the Upload Package File box and click the Upload File & Install button:
The package file needs to contain the same or newer version of JoomSEF than the one currently installed. If the package file with the same version is used, the reinstall is initiated (only the files are rewritten, so you won't lose any of your configuration or SEF URLs).
Be aware of using the correct package - if you have paid version of JoomSEF installed and you select the package with free version to upgrade to, your paid version will be changed to free one. This also works in the opposite way - if you have free version installed, and you purchase and download the paid package, you can use it to change your free version to paid one without losing any configuration and SEF URLs.
JoomSEF can also be upgraded automatically from the ARTIO Upgrade server. This function can be used to upgrade your JoomSEF or to reinstall it if you already have the newest version installed. Just be aware to set your Download ID corectly in JoomSEF's Configuration on the Registration tab if you are using the paid version of JoomSEF, otherwise your version will be changed to free one when using this feature. It can also be used in the opposite way - if you have free version of JoomSEF installed and you've purchased the paid version, just set your Download ID in JoomSEF's Configuration and use this feature to change your version to paid one. You won't lose any of your configuration or the SEF URLs when using this function.
According to the Download ID set, there are two options how the Upgrade page can look like:
-
Download ID not set or not valid (the warning is also shown in this case)
-
Download ID set and valid
Furthermore, if your JoomSEF is already up to date, there is the Reinstall button instead of the Upgrade button available:
On the bottom of the Upgrade page there is a list of installed JoomSEF Extensions shown:
For every extension, there are the currently installed version, the newest version available on the ARTIO Server and the type of the extension displayed. If there is a newer version available, the Upgrade button is shown in the Upgrade column for the extension.
Free extensions can be upgraded using the Upgrade button right away. For the paid extensions, the valid Download ID needs to be set in the extension's parameters on the Registration tab. This is signaled by the color of the key icon next to the Paid word - if the key is gray, the Download ID is not set, otherwise the key is gold. You can click the key icon to directly set the Download ID for the extension.
JoomSEF Extensions can also be upgraded in a similar way directly on the Extensions Management page.
Table of Contents
The best way to use JoomSEF with JoomFish is to disable the System - Jfrouter plugin in your Joomla's Plugin Manager. JoomSEF will then take care of all the language recognition.
If for any reason you want to have the JoomFish router enabled, JoomSEF is capable of working together with it if you have JoomFish version at least 2.0.3 or newer installed, but you must follow a few rules to configure JoomSEF properly for this. When JoomFish router is enabled, there are some restrictions for using the options in the JoomSEF's Configuration on the JoomFish tab:
- Language integration
-
This option must match the setting set in the JoomFish router parameters - only the include in path and use different domains options are available.
- Always use language
-
This option should be enabled.
- Translate URLs
-
There is no restriction for this option.
- Get language from browser setting
-
This option is not available, since JoomFish router controls this.
- Save language to cookie
-
This option is not available, since JoomFish router controls this.
- Main language
-
This option does not work when JoomFish router is enabled, so it must be set to (none).
- Domain configuration
-
This is not available, since JoomFish router controls the domains used.
If you set the options properly according to these rules and to match the settings made in the JoomFish router parameters, JoomSEF should work with JoomFish router enabled.
You can find the information about common problems encountered when using JoomSEF in our FAQ at http://www.artio.net/faqs.
verze 3.0.0
kompatibilní s verzí Joomla 1.0.x & Joomla 1.5.x
od společnosti ARTIO s.r.o.
poslední aktualizace 24. listopadu 2008
Obsah
- Úvod
- Licence
- Instalace a konfigurace
- Užitečné tipy pro použití
- Podporované Joomla! komponenty
- Technická podpora a Pomoc
- Sponzorství komponenty JoomSEF
- Reklamní upozornění
- Autoři
-
Úvod
ARTIO JoomSEF je komponentou Joomla!, která generuje a umožňuje vytváření URL adres přátelských pro vyhledavače pro Apache a IIS, vrací náležitý kód status 404 pro chybějící obsah, poskytuje zápis chyb stránky 404 a vytváří speciální "zkratky" URL adres, které umožňují uživatelům přesměrování na novou URL adresu.
Začínání s verzí 1.3.0 JoomSEF také umožňuje kontrolu určitých mata tagů, jako je popis nebo klíčová slova pro každé generované URL. JoomSEF přichází se SEF podporou pro nejpopulárnější komponenty Joomla!. Některá je poskytována zdarma jako část instalačního balíčku JoomSEF a některé jsou také dostupné pod komerční licencí. Pokud postrádáte podporu pro vaší oblíbenou komponentu, ARTIO jí může vyvinout na požádání.
Tento dokument popisuje jak instalovat a nastavit komponentu ARTIO JoomSEF Joomla!. Tuto dokumentaci můžete znovu zobrazit za pomoci výběru tlačítka "ARTIO JoomSEF dokumentace" z Kontrolního panelu ARTIO JoomSEF.
-
Licence
Tento software je distribuován pod GNU General Public Licencí. Instalací a užíváním tohoto softwaru souhlasíte s podmínkami licence.
Prosím uvědomte si, že některé doplňkové části pro tento software (komponenty a rozšířující moduly) mohou být dostupné pod jinými (komerčními) podmínkami licence.
-
Instalace a konfigurace
Instrukce pro instalaci si můžete prohlédnout níže kliknutím na příslušný ukazatel.
Pokud byl váš soubor .htaccess nastaven jako zapisovatelný, pak jej mohla instalace již aktualizovat a vy už nemusíte mít obavy.
Pokud je vaše stránka v podadresáři, ujistěte se o změně RewriteBase line accordingly. ex/ RewriteBase /joomla
-
Instalace
- Nahrajte zip soubor do systému Joomla! s použitím instalační komponenty jako obvykle.
- Pro apache, nastavte váš soubor ".htaccess" následovně:
##
# @version $Id: htaccess.txt 2368 2006-02-14 17:40:02Z stingrey $
# @package Joomla
# @copyright Copyright (C) 2005 Open Source Matters. All rights reserved.
# @license http://www.gnu.org/copyleft/gpl.html GNU/GPL
# Joomla! is Free Software
##
#####################################################
# READ THIS COMPLETELY IF YOU CHOOSE TO USE THIS FILE
#
# The line just below this section: 'Options FollowSymLinks' may cause problems
# with some server configurations. It is required for use of mod_rewrite, but may already
# be set by your server administrator in a way that dissallows changing it in
# your .htaccess file. If using it causes your server to error out, comment it out (add #
# to beginning of line), reload your site in your browser and test your sef url's. If they
# work, it has been set by your server administrator and you do not need it set here.
#
# Only use one of the two SEF sections that follow. Lines that can be uncommented
# (and thus used) have only one #. Lines with two #'s should not be uncommented
# In the section that you don't use, all lines should start with #
#
# For Standard SEF, use the standard SEF section. You can comment out
# all of the RewriteCond lines and reduce your server's load if you
# don't have directories in your root named 'component' or 'content'
#
# If you are using a 3rd Party SEF or the Core SEF solution
# uncomment all of the lines in the '3rd Party or Core SEF' section
#
#####################################################
##### SOLVING PROBLEMS WITH COMPONENT URL's that don't work #####
# SPECIAL NOTE FOR SMF USERS WHEN SMF IS INTEGRATED AND BRIDGED
# OR ANY SITUATION WHERE A COMPONENT's URL's AREN't WORKING
#
# In both the 'Standard SEF', and '3rd Party or Core SEF' sections the line:
# RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR] ##optional - see notes##
# May need to be uncommented. If you are running your Joomla! from
# a subdirectory the name of the subdirectory will need to be inserted into this
# line. For example, if your Joomla! is in a subdirectory called '/test/',
# change this:
# RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR] ##optional - see notes##
# to this:
# RewriteCond %{REQUEST_URI} ^(/test/component/option,com) [NC,OR] ##optional - see notes##
#
#####################################################
## Can be commented out if causes errors, see notes above.
Options FollowSymLinks
#
# mod_rewrite in use
RewriteEngine On
# Uncomment following line if your webserver's URL
# is not directly related to physical file paths.
# Update Your Joomla! Directory (just / for root)
# RewriteBase /
########## Begin Standard SEF Section
## ALL (RewriteCond) lines in this section are only required if you actually
## have directories named 'content' or 'component' on your server
## If you do not have directories with these names, comment them out.
#
#RewriteCond %{REQUEST_FILENAME} !-f
#RewriteCond %{REQUEST_FILENAME} !-d
#RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR] ##optional - see notes##
#RewriteCond %{REQUEST_URI} (/|\.htm|\.php|\.html|/[^.]*)$ [NC]
#RewriteRule ^(content/|component/) index.php
#
########## End Standard SEF Section
########## Begin 3rd Party or Core SEF Section
#
#RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR] ##optional - see notes##
RewriteCond %{REQUEST_URI} (/|\.htm|\.php|\.html|/[^.]*)$ [NC]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule (.*) index.php
#
########## End 3rd Party or Core SEF Section - Pro IIS, viz Konfigurování IIS.
- Ujistěte se, že SEF je povoleno v rámci Global Configuration v Joomla! backendu.
- Upravte JoomSEF konfiguraci, změňte Povolit na yes a uložte.
Je nezbytné se ujistit, že dokument 404 byl uložen do databáze Joomly!
-
Konfigurování IIS
Od doby JoomSEFu 1.3.2, byla podpora pro IIS servery přetestována a aktualizována.
Komponenta JoomSEF byla úspěšně testována na IIS5 a IIS6. Jelikož instalační proces je dost komplexní záležitostí, poskytujeme právě základní korky a rady. Pokud máte problém s nastavením, prosím, kontaktujte náš tým technické podpory (prosím nezapomeňte, že technická podpora je placená služba).
-
Konfigurace PHP jako ISAPI filtr
Ve vaší IIS web konfiguraci, nakonfigurujte PHP pro spuštění jako ISAPI filtr. (doporučeno) -
Instalace ISAPI Rewrite Filter
Aby fungoval JoomSEF na vašem IIS, budete dále potřebovat přepsat komponentu podobnou jako mod_rewrite do Apache. Je jich několik a některé jsou zdrama a jiné zas komerční. Verze zdarma fungují, např. ISAPI_Rewrite Lite. IISRewrite nebo SAPI_Rewrite Full by měly být ok. Také jsme testovali IIRF (Ionic's ISAPI Rewrite Filter), ale tato verze je trochu chybová, ačkoli má nejblíže k originální Apache's mod_rewrite (doufejme, že to autor brzy opraví).
Stáhněte si vybranou komponentu a pro instalaci následujte její dokumentaci. -
Tvorba souboru pro přepsání pravidel definice
Vytvořte .ini s přepsáním pravidel pro přepsání komponent. Název a umístění může odlišné na základě vybraného přepisovacího modulu. Pro ISAPI_Rewriteje název souboru httpd.ini a měl by být umístěn adresáři instalovaných modulů. Pro detaily o vašem modulu si přečtěte dokumentaci.
The file analogy of the Apache's .htaccess. Pravidla se mohou lišit ve výběru komponenty, ve vaší konfiguraci serveru a ve vašich potřebách použití. Pokud si nejste jistí touto konfigurací (nebo také předchozími kroky) můžete kontaktovat naši technickou podporu.
Obecně můžete kopírovat pravidla ze souboru htaccess.txt, která je dodáván s Joomlou! a nastavte jej ke srovnání možností přepisovací komponenty. Prosím, uvědomte si, že každý modul má trochu odlišné nastavení pravidel, které podporují. (např. ISAPI_Rewrite nepodporuje %{REQUEST_FILENAME} !-f) a existující soubory musí být zkontrolovány jinými pravidly. Napři. pro každé RewritingRule, přidejte [L,U] modifikátor.
Jestli vaše instalace Joomla! není umístěna v kořenovém adresáři stránek, budete potřebovat přidat příbuznou cestu pro všechny RewriteRules. (pro simulaci Apache RewriteBase nastavení). Jestliže je vaše Joomla! umístěna přímo v kořenovém adresáři stránek, pak přidejte "/" před index.php v druhé části RewriteRules.
Například konfigurace pro IIRF pro stránky umístěné v podadresáři /joomla/demo by mělo být následující:
########## Begin 3rd Party or Core SEF Section
#
RewriteCond %{URL} ^(/component/option,com) [NC,OR]
##optional - see notes##
RewriteCond %{URL} (/|\.htm|\.php|\.html|/[^.]*)$ [NC]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule /joomla/demo/(.*) /joomla/demo/index.php [L,U] -
Konfigurace uživatelsky definovaných chyb (volitelné)
POZNÁMKA: v příkladu níže je Joomla! instalována do adresáře virtuálního serveru Jommla! Pokud používáte Internet Services Manager, klikněte pravým tlačítkem myši na adresář, ve kterém je nainstalována Joomla!
Select properties >> Custom Error
set the 404 to URL:/joomla/index.php
set the 405 to URL:/joomla/index.php
-
-
Odinstalování
- Komponentu odinstalujete použitím odinstalovače komponenty.
- Pro apache, nastavte ".htaccess" takto:
##
# @version $Id: htaccess.txt 2368 2006-02-14 17:40:02Z stingrey $
# @package Joomla
# @copyright Copyright (C) 2005 Open Source Matters. All rights reserved.
# @license http://www.gnu.org/copyleft/gpl.html GNU/GPL
# Joomla! is Free Software
##
#####################################################
# READ THIS COMPLETELY IF YOU CHOOSE TO USE THIS FILE
#
# The line just below this section: 'Options FollowSymLinks' may cause problems
# with some server configurations. It is required for use of mod_rewrite, but may already
# be set by your server administrator in a way that dissallows changing it in
# your .htaccess file. If using it causes your server to error out, comment it out (add #
# to beginning of line), reload your site in your browser and test your sef url's. If they
# work, it has been set by your server administrator and you do not need it set here.
#
# Only use one of the two SEF sections that follow. Lines that can be uncommented
# (and thus used) have only one #. Lines with two #'s should not be uncommented
# In the section that you don't use, all lines should start with #
#
# For Standard SEF, use the standard SEF section. You can comment out
# all of the RewriteCond lines and reduce your server's load if you
# don't have directories in your root named 'component' or 'content'
#
# If you are using a 3rd Party SEF or the Core SEF solution
# uncomment all of the lines in the '3rd Party or Core SEF' section
#
#####################################################
##### SOLVING PROBLEMS WITH COMPONENT URL's that don't work #####
# SPECIAL NOTE FOR SMF USERS WHEN SMF IS INTEGRATED AND BRIDGED
# OR ANY SITUATION WHERE A COMPONENT's URL's AREN't WORKING
#
# In both the 'Standard SEF', and '3rd Party or Core SEF' sections the line:
# RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR] ##optional - see notes##
# May need to be uncommented. If you are running your Joomla! from
# a subdirectory the name of the subdirectory will need to be inserted into this
# line. For example, if your Joomla! is in a subdirectory called '/test/',
# change this:
# RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR] ##optional - see notes##
# to this:
# RewriteCond %{REQUEST_URI} ^(/test/component/option,com) [NC,OR] ##optional - see notes##
#
#####################################################
## Can be commented out if causes errors, see notes above.
Options FollowSymLinks
#
# mod_rewrite in use
RewriteEngine On
# Uncomment following line if your webserver's URL
# is not directly related to physical file paths.
# Update Your Joomla! Directory (just / for root)
# RewriteBase /
########## Begin Standard SEF Section
## ALL (RewriteCond) lines in this section are only required if you actually
## have directories named 'content' or 'component' on your server
## If you do not have directories with these names, comment them out.
#
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
#RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR] ##optional - see notes##
RewriteCond %{REQUEST_URI} (/|\.htm|\.php|\.html|/[^.]*)$ [NC]
RewriteRule ^(content/|component/) index.php
#
########## End Standard SEF Section
########## Begin 3rd Party or Core SEF Section
#
#RewriteCond %{REQUEST_URI} ^(/component/option,com) [NC,OR] ##optional - see notes##
#RewriteCond %{REQUEST_URI} (/|\.htm|\.php|\.html|/[^.]*)$ [NC]
#RewriteCond %{REQUEST_FILENAME} !-f
#RewriteCond %{REQUEST_FILENAME} !-d
#RewriteRule (.*) index.php
#
########## End 3rd Party or Core SEF Section
-
Aktualizace z free verze na placenou verzi
-
Pokud jste si zakoupili verzi JoomSEF a chcete jí nahradit free verzi bez toho, aby jste ztratili současné nastavení a již uložené SEF URL adresy, postupujte následovně:
- z kontrolního panelu JoomSEF zvolte "Upgrade"
- ze stránky aktualizace vyberte "Install from page"
- vyberte instalační soubor, který jste stáhli z webových stránek ARTIO
- klikněte na tlačítko aktualizace
-
Seznam konfigurace
Ujistěte se, že:
- .htaccess existuje v jádru vaší Joomla! stránky
- the 3rd party section rules in .htaccess are uncommented
- "RewriteBase" rule matches YOUR Joomla! installation
- Joomla! SEF is "ON" in site "Global configuration"
- JoomSEF je nastaven na "ON" v "JoomSEF konfiguraci"
-
Ne-latinské jazyky
Pokud na vašich stránkách nepoužíváte latinku (tzn. používáte např. řečtinu, hebrejštinu, ...), ujistěte se, že jste správně nastavili konverzi znaků v JoomSEF konfiguraci / nahradili všechny Non-ascii znaky, za znaky, které ve svém jazyce používáte.
Formát, který potřebujete je: oldChar1|newChar1,oldChar2|newChar2,... .
Example: α|a,β|b,γ|c,... -
Automatické aktualizace
Počínaje verzí 1.3.0, JoomSEF nabízí schopnost automatické aktualizace. Od verze 2.0.x jsou automatické aktualizace i u JoomSEF rozšíření.
Díky této vlastnosti už není třeba komponentu odinstalovat a znovu nainstalovat pokaždé, když potřebujete upgradovat na novější verzi. Po aktivaci nástroje automatické aktualizace v kontrolním panelu JoomSEF komponenta zkontroluje, zda je k dispozici novější verze online a pokud ano, automaticky ji stáhne a přepíše vaši současnou verzi.
-
-
Užitečné tipy
-
Konfigurace
Konfigurace pro ARTIO JoomSEF je poměrně přímočará. Pro více informací o každé položce najeďte kurzorem myši na modré (i) obrázky.
Když uložíte konfiguraci, odstraní se všechny vaše URL adresy z databáze. Pokud máte stránky s vysokou návštěvností, bude dobré, když je nastavíte offline před uložením konfigurace nebo před vymazáním databáze. Potom projděte vaše stránky a začněte hlavní stránkou. Tím se vytvoří URL adresy správně a zabráníte tak přidání čísel k URL adresám.
Také by bylo dobré vymazat 404 log před vytvořením nových URL adres.
-
Optimalizace
Pro dosažení maximálního výkonu byste měli zvážit několik věcí.
Vždy mějte nainstalovanou nejnovější verzi JoomSEF, jelikož my pokračujeme s optimalizacemi s každým novým vydáním.
Povolte Joomla! caching.
V konfiguraci vypněte SEF u těch komponentů, u kterých to nepotřebujete nebo které generují příliš mnoho neoptimalizovaných odkazů. Když uvidíte odkazy jako 45.html, 46.html, ..., něco je pravděpodobně špatně.
Pokud určitá komponta používá stránkování, třídění nebo podobné parametry může konfigurační možnost "Append non-SEF variables to URL" snížit počet generovaných SEF odkazů a také vaše DB načítání. Uvědomte si však, že vyloučené proměnné budou připojeny k vaší URL adrese standardní formou jako &varname=value.
JoomSEF vždy bude SEO komponentou řízenou DB. Tak bude vytvářet pěkné a editovatelné URL adresy, ale zvýší se načítání vašeho DB. Pokud bude konfigurace správná, zvýšení načítání nebude tak významné. U rozsáhlých a často navštěvovaných stránek dbejte na správnou konfiguraci a instalaci modulů a plánujte vaše SEO pečlivě.
-
Předcházení duplikování
Pokud se vytváří duplicitní odkazy, např. http://yoursite.you/article.html, http://yoursite.you/article-2.html, atd., které vedou na stránku se stejným obsahem, je to pravděpodobně způsobeno proměnnou zvanou "Itemid" (ačkoli zde mohou být i jiné důvody).
Itemid je interní proměnná Joomly!, která identifikuje zdroj vašeho URL odkazu. Např. hlavní menu nebo podmenu, které váš návštěvník používal, aby se dostal k určitému obsahu. Podle této proměnné se uplatňují různé konfigurace - např. jaká šablona bude použita nebo který modul bude viditelný, atd.
Od JoomSEF verze 1.4.0 je k dispozici několik nových konfiguračních možností v sekci "Advanced configuration". Možnost "Exclude source info" může být použita pro vyloučení Itemidu z URL adresy a tím se zabrání duplicitám tím způsobeným. Avšak úplné ignorování může vést k nechtěné funkčnosti Joomly, jako je spínání požadovaných šablon atd. Pokud to pro vás bude problém záleží na uspořádání vašich stránek a na tom, jak jsou složité. Pokud to potřebujete opravit, Itemid by měl být znovu připojen k SEF URL adrese jako zvláštní část použitím možnosti "Reappend source". Potom bude výsledné URL vypadat takto http://yoursite.you/article.html&Itemid=xy.
Od JoomSEF verze 2.2.2 je zde možnost nastavení vašeho vlastního Itemidu pro každé rozšíření - pokud "Reappend source" je nastaven na ano, rozšíření nebude mít připojen ?Itemid=xy. Tuto možnost najdete v parametrech rozšíření. Pokud necháte políčko "Override Itemid" prázdné, bude použit standardní Itemid, ale nebude připojen jako ?Itemid=xy in URL. Tedy můžete dosáhnou toho, že ?Itemid=xy bude přidán pouze pro ta rozšíření, která to potřebují (většinou obsahová). Ale buďte opatrní, nastavení Itemidu na nějaké náhodné číslo může pokazit funkčnost menu!
Další novou možností je "Ignore multiple sources". Pokud ji zadáte, vytvoří se pouze jedna URL adresa pro každou stránku s použitím prvního Itemidu. Každý další odkaz lišící se pouze v Itemidu bude ignorován a bude použita URL již vytvořená. Ale znovu - to může poškodit funkčnost vašeho menu! Tato možnost nemá žádný vliv na rozšíření s nastaveným Itemidem.
-
Vyrovnávací paměť
JoomSEF 2.0.0 představuje vlastní funkci vyrovnávací paměti pro snížení počtu požadavků ve vaší databázi. Tuto možnost najdete v pokročilém nastavení (Advanced Configuration).
Pokud je vyrovnávací paměť aktivována, nejčastěji používané odkazy budou uchovány. Můžete nastavit velikost vyrovnávací paměti (kolik odkazů může být uloženo) a minimální počet shlédnutí - pouze odkazy s počtem shlédnutí větším než je nastavené číslo budou uloženy v paměti. Buďte opatrní s velikostí paměti - více odkazů ve vyrovnávacíc paměti znamená méně požadavků v databázi, ale na druhé straně větší spotřebu paměti.
-
Patch Systém
JoomSEF 2.0.0 také přichází s novým Patch systémem. Tím se sníží počet požadavků v databázi, protože každý může použít pouze tolik patch systémů, kolik potřebuje. Takže už žádné požadavky "SELECT DATABASE()", pokud používáte pouze jednu databázi.
Patch je v podstatě mambot speciálně navržený pouze pro JoomSEF. To znamená, že pro správu těchto patch systémů můžete použít standardní instalační Mambot Joomly! Každý patch, který nainstalujete musí být publikován v sekci Mamboty, aby fungoval.
-
Technická podpora pro JoomFish
Je zde několik způsobu jak můžete vytvořit URL adresy na vašich vícejazykových stránkách. Jsou zobrazeny v Konfiguračním nastavení komponentu JoomFish.
Language integration
- Include in path - v URL adrese - zvolením této možnosti budou vaše URL adresy vypadat takto: www.mysite.com/en/somepage.html
- Add as suffix - jako přípona - vaše URL adresy budou vypadat takto: www.mysite.com/somepage_en.html
- Use different domains - užitečná možnost, pokud máte pro vaše stránky zaregistrovaných několik domén. Výsledné URL adresy budou vypadat takto: http://en.mysite.com/somepage.html
- Do not add - nepřidá žádný jazykový kód do URL adresy. Zvolte pouze tehdy, pokud je možnost "Translate URLs" aktivní.
Always use language
Zvolením této možnosti bude jazykový kód vždy přidán do výsledné URL adresy. To může snížit počet duplicitních odkazů.Translate URLs
Aktivujte, aby se vaše URL adresy přeložili s použitím JoomFish - tím se zlepší čitelnost URL adres pro lidi, kteří preferují jiné jazyky.Domain Configuration
Zde nastavíte doménu pro každý jazyk, pokud máte zvoleno Use different domains. -
Konfigurace komponenty
V konfiguraci JoomSEF můžete nastavit v konfiguraci komponentů možnosti pro každý komponent zvlášť.
Handling
Kontroluje jakým způsobem jsou odkazy zpracovávány.- Use default handler - JoomSEF se bude snažit vytvořit pěkné URL adresy s použitím všech možných zdrojů.
- Nocache - JoomSEF bude tvořit URL adresy stejným způsobem jako standardní Joomla! SEF - nebudou uloženy v databázi a budou vypadat takto: www.mysite.com/component/option,com_virtuemart/Itemid,50/
- Skip - JoomSEF nebude zpracovávat URL adresy vůbec a ty budou vypadat tak, jako kdyby byl SEF neaktivován.
Custom title
Umožní vám nastavit váš vlastní název pro rozšíření namísto výchozího názvu. Pokud chcete použít výchozí název, ponechte pole prázdné. Pokud používáte JoomFish, můžete tyto vámi zvolené názvy přeložit. -
Modifikace URL adres
Můžete jakkoliv upravovat URL adresy. Běžte do kontrolního panelu JoomSEF a klikněte na ' View/Edit SEF Urls'. Vyberte URL adresu, kterou si přejete pravit. Pokud zatrhněte políčko označené 'Save as Custom Redirect', umístíte URL do 'Custom Redirect', kterou můžete řídit z kontrolního panelu JoomSEF. Pokud kliknete na 'View/Edit Custom Redirects' zobrazí se vaše URL adresa zde. Tyto URL adresy nebudou odstraněny, pokud uložíte konfiguraci.
Toto je zvláště užitečné, pokud aktualizujete staré stránky, protože URL adresy, které již nejsou k dispozici budou stále zapsány. Tyto adresy zobrazíte kliknutím na 'View/Edit 404 Logs' v kontrolním panelu JoomSEF. Můžete přesměrovat návštěvníky na novou stránku tak, že vyberete URL, kterou si přejete upravit a vložíte URL novou. Poznámka: Možnost vkládání URL, které nebyly vytvořeny v Joomle, se připravuje! To vám umožní přemístit vaše stránky, které nebyly vytvořeny v Joomle! do systému Joomla! s použitím komponenty JoomSEF a vaše staré URL adresy budou přesměrovány na nové stránky.
-
Metadata a uspořádání názvů stránek - JoomSEF Metabot
Pro uspořádání a upravení metadat vašich stránek (jako je název, meta desc, meta keywords, atd.) z jednoho místa, můžete použít vlastnosti nabízené komponentou JoomSEF Metabot. Metabot je instalován jako standardní mambot Joomly! (plugin v Joomla 1.5.x) a stará se o uspořádání názvů stran a metadat v záhlaví stránky.
Metabot načte metadata, které jste definovali pro určité SEF URL s použitím JoomSEF URL editoru a umístí je do záhlaví vaší Joomla! stránky.
Nápověda: Pro určení názvu a/nebo meta tagů vaší domovské stránky, vytvořte nový záznam do seznamu URL, kde SEF URL zůstane prázdné a originální URL bude index.php.
Aby metabot fungoval správně, musí být vždy požit s kompoentou JoomSEF a musí být publikovaný. Metabot má také několik uživatelských konfiguračních možností, jako způsob uspořádání názvů stran a další podobná nastavení. Pro přístup do této konfigurace, najděte metabot v seznamu nainstalovaných Joomla mambotů (pluginů) a klikněte na něj. Konfigurační parametry najdete na pravé straně mambotu (pluginu).
-
Zálohování URL adres
Je doporučeno zálohování vaší databáze.
Také můžete importovat a exportovat URL adresy do sekce Custom REdirect. Klikněte na 'Backup Custom URLS' a stáhněte si soubor 'ARTIO JoomSEF_custom_urls.sql'.
Pokud chcete importovat URL adresy, klikněte na 'Import Custom URLS'.
-
-
Podporované Joomla! komponenty
-
Joomla! zabudované komponenty
Podpora pro komponenty Joomly, jako jsou bannery, obsah, kontakty, novinky, atd je zahrnuta v komponentě JoomSEF. Optimalizace URL adres těchto komponentů nevyžaduje žádnou další námahu.
-
Komponenty třetích stran
Pro komponenty třetích stran je situace trochu jiná. Existuje mnoho komponent třetích stran a modulů pro Joomlu!, které se obvykle liší ve složitosti a struktuře. To znamená, že některé (obvykle ty nejjednodušší) mají nedostačující SEO nebo generují duplicitní URL adresy. To můžete změnit v kontrolním panelu a nastavit, aby se SEF URL adresy negenerovaly. Nebo budete potřebovat speciální rozšíření. Více složité komponenty mohou způsobovat problémy, pokud jsou použity s default handler.
Rozšíření jsou speciálním kódem pro JoomSEF a při jejich tvorbě je myšleno na komponenty třetích stran (např. VirtueMart, JoomlaBoard, ...) Takové rozšíření může být částí komponenty/modulu, může být součástí instalačního balíčku JoomSEF nebo může být poskytnuto třetí stranou. ARTIO nabízí většinu rozšíření zdarma jako součást distibučního balíčku JoomSEF. Avšak, některá rozšíření jsou placená. Seznam dostupných rozšíření najdete níže.
-
Seznam oficiálně dostupných rozšíření
- AlphaContent (free)
- Community Builder (payed)
- DocMan (free)
- Glossary (free)
- JoomlaBoard (free)
- Jomres (payed)
- Mosets Hot-Property (payed)
- Mosets Tree (free)
- SMF Bridge (Simple Machines Forum) (payed)
- ReMOSitory (free)
- SOBI2 (payed)
- VirtueMart (payed)
- Zoom Galery (free)
Prosím uvědomte si, že tento seznam nemusí být kompletní. Prosím, zkontrolujte webové stránky pro nejnovější informace o dostupných rozšířeních.
Naší prioritou je jako první vytvořit podporu pro nejpopulárnější rozšíření. Pokud jste zde nenašli vaši oblíbenou komponentu/modul, která nefunguje přesně tak, jak má, kontaktujte nás a my se budeme snažit vytvořit rozšíření k této komponentě/modulu. -
Instalace rozšíření
Pro instalaci SEF rozšíření, použijte instalační program, který je dostupný z kontrolního panelu JoomSEF.
- V panelu nástrojů klikněte na tlačítko "Install"
- Zvolte "Upload file" a vyberte instalační soubor rozšíření a klikněte na tlačítko "Upload and Install"
- Pokud vše proběhlo správně, bude váš požadavek potvrzen a kliknutím na "Continue..." je vaše nové SEF rozšíření připraveno k použití.
-
Parametry rozšíření
Od JoomSEF verze 2.0.0 má každé rozšíření vlastní parametry ovlivňující výsledné URL adresy - najdete je na hlavní stránce JoomSEF administrace. V panelu nástrojů klikněte na tlačítko Edit nebo klikněte na název rozšíření.
-
-
Sponzorství komponenty JoomSEF
ARTIO JoomSEF je software zdarma. Ačkoli vývoj stojí tolik co vývoj jakéhokoliv jiného softwaru. Pokud jste s tímto softwarem spokojeni a chcete, aby jsme implementovali nové vlastnosti, rychle opravovali chyby a pravidelně vydávali nová rozšíření, můžete nám poslat příspěvek, tedy podporu pro další vývoj komponenty JoomSEF.
Můžete tak udělat přes službu PayPal - kreditní kartou nebo převodem.
Informace o bankovním účtu:
Banka: Ceskoslovenska obchodni banka (CSOB)
Adresa: Hollarova 5, Ostrava, Czech Republic
Číslo účtu: 199371035, Bank code: 0300
SWIFT: CEKOCZPP
IBAN: CZ1303000000000199371035 -
Podpora a Pomoc
Pokud potřebujete pomoc s komponentou JoomSEF, navštivte naše webové stránky http://www.artio.cz a podívejte se na často kladené otázky (FAQs) nebo na diskuzní fórum.
-
Reklamní upozornění
JoomSEF může přidat uživatelsky neviditelný odkaz vedoucí na webové stránky ARTIIO nebo na sponzory. Takvé odkazy se zobrazují v zápatí stránky nebo v políčkách meta tagů. To nemá žádný vliv na funkčnost vašich stránek.
Podobně jako u softwaru Joomla, tyto okazy mohou být odstraněny. Ačkoli, pokud si je necháte, pomůže nám to s vývojem dalšího softwaru a zvýší se počet uživatelů.
Také si můžeze zakoupit placenou verzi JoomSEF, která tyto reklamní odkazy neobsahuje. Komponent je k dispozici v našem online obchodě http://www.artio.cz/en/e-shop.
-
Autoři
ARTIO s.r.o.
Mrštíkova 840/6
Ostrava - Mariánské Hory
709 00 Česká republika
http://www.artio.net
info@artio.netMichal Unzeitig, team leader
David Jozefov, developer
Petr Vlasak, developer
