Joomla! Documentation - User contributions [en]

Talk:Htaccess examples (security)

2022-06-08T11:28:59Z

Nikosdion: /* Edit Requests 8 Jun 2022 11:26 */ new section

It could be useful to add some explanations of what these settings do. [[User:Jossi|Jossi]] 16:53, 6 March 2009 (UTC)

== move olddomain redirect? ==

Why not move the olddomain redirect section to its own code block, or in the other useful settings code block.

== Edit Requests 9 Dec 2014 15:03 ==

Hi,

This .htaccess file only allows tmpl=system and tmpl=component. It is possible for developers and templates to provide more options as we do in Nooku Framework.

This rule also does not stop people from fingerprinting Joomla sites either as any URL can still be accessed with tmpl=component.

So I would like to request the removal of the |mpl part in the following line:

RewriteCond %{QUERY_STRING} (^|&)t(p|emplate|mpl)= [NC]

More info and explanation can be found in the below links:

https://github.com/nikosdion/master-htaccess/issues/1
https://github.com/nikosdion/master-htaccess/pulls/2

:Hi, if you would like to put this forth you will have to create an issue on http://issues.joomla.org, and submit a PR for consideration. Please know, the examples you cited are considered not acceptable now by Nic. Thanks [[User:Tom Hutchison|Tom Hutchison]] ([[User talk:Tom Hutchison|talk]]) 08:05, 19 December 2014 (CST)

== Edit Requests 8 Jun 2022 11:26 ==

The .htaccess example contains a very, VERY old reference to Admin Tools' Joomla Update which has been superseded twice by the core Joomla! Update.

As per https://github.com/joomla/joomla-cms/pull/35388 we need to change

## Allow Admin Tools Joomla! updater to run
RewriteRule ^administrator/components/com_admintools/restore\.php$ - [L]

with

## Joomla! Update (core feature) — Joomla versions 2.5.1 through 4.0.2
RewriteRule ^administrator\/components\/com_joomlaupdate\/restore\.php$ - [L]
## Joomla! Update (core feature) — Joomla versions 4.0.3 and later
RewriteRule ^administrator\/components\/com_joomlaupdate\/extract\.php$ - [L]

I would do it myself but I do not have the edit rights.

J4.x:Updating from an existing version

2022-06-08T11:25:57Z

Nikosdion: Added troubleshooting information from https://github.com/joomla/joomla-cms/pull/35388

<noinclude><languages /></noinclude><br />
{{note|<center><big><translate>
'''Always back up your site before updating.'''</translate></big></center>|type=serious}}
==Introduction==
<translate>
The recommended way to update installations of Joomla! is to use the Joomla Update Component.</translate>
<translate>

A standard installation of Joomla 4 includes a helpful notifications panel on the Home Dashboard after logging in. You can see at a glance if an update is available and the version number.</translate>

<translate>
Although Joomla will notify you when an update is available, it requires you to carry out the update. It is a straight forward process and should be carried out at the earliest opportunity to keep the site up to date.</translate>

<translate>
If you are updating from a Joomla version prior to 4.x please see one or more of the following:
</translate>

<translate>
* [[S:MyLanguage/Potential_backward_compatibility_issues_in_Joomla_4|Potential backward compatibility issues in Joomla 4]]
</translate>
<translate>
* [[S:MyLanguage/Joomla_3.x_to_4.x_Step_by_Step_Migration|Joomla 3.x to 4.x Step by Step Migration]]</translate>
<translate>
* Updating 1.x or 2.x to 3.x: use [[S:MyLanguage/J3.x:Updating Joomla (Install Method)|Updating Joomla (Install Method)]].</translate>

<translate>==Accessing the Update Component==</translate>

<translate>
If the notifications panel is displayed in the Home Dashboard, clicking the notification takes you straight to the Update Component. </translate>

[[File:j4x_joomla_update_notification-<translate>
en</translate>.png|border|800px]]
{{-}}

<translate>
Alternatively, to access the Update Component from the Administrator sidebar menu, click '''System'''. This will take you to the '''System Dashboard'''.</translate>

[[File:j4x_joomla_system_dashboard_update-<translate>
en</translate>.png|border|800px]]
{{-}}
<translate>
The System Dashboard has an ''Update Panel'' which includes a Joomla link that will show the available update version number. Click the '''Joomla''' link and you will be taken to the Update Component.</translate>

<translate>==Carrying out the Update==</translate>
[[File:j4x_joomla_pre_update_check-<translate>
en</translate>.png|border|800px]]
{{-}}
<translate>
When you arrive at the Joomla Update Component you will be presented with a Pre-Update Check which provides you with information about the readiness of your server, settings and installed extensions for the update.</translate>

<translate>
Pay careful attention to these and take action to rectify any issues highlighted before updating. You may need to double check extensions and update them first if necessary.</translate>

<translate>It is not uncommon to see warnings for ''Recommended Settings'' as these are often server specific and hosting related - it is likely they existed when you installed Joomla and most likely won't prevent the update from happening.

''Note the reminder that you are strongly advised to take a backup if you haven't already!''</translate>

<translate>
There is a link below the update button. In most cases you can ignore this link. It provides an option to manually upload the update files if your server is behind a firewall or otherwise unable to contact the Joomla update servers.</translate>

<translate>
When you have reviewed the Pre-Update Check and are happy, click '''Update'''.</translate>

<translate>===Confirming the Update===</translate>
[[File:j4x_joomla_start_update-<translate>
en</translate>.png|border|800px]]

<translate>Click the checkbox to confirm you have made a backup and checked extensions are compatible then click the '''Start Update'''.</translate>

<translate>===Update Progress===</translate>
[[File:j4x_joomla_update_progress-<translate>
en</translate>.png|border|800px]]

<translate>Once the update starts a progress bar will appear as the Joomla files are updated.</translate>

<translate>===Completion===</translate>

[[File:j4x_joomla_updated-<translate>
en</translate>.png|border|800px]]

<translate>When the progress bar reaches 100% a system message will confirm your site has been updated and the version number. The version number will also update in the top toolbar, next to the site name.</translate>

<translate>
Click the '''Back''' button and you will be returned to the Joomla Update Component where it is possible to check for updates again.</translate>

<translate>==Post Update Checks==</translate>

<translate>
Once the update is complete you should carry out some checks to make sure everything went as expected, that no errors are present and that there have been no changes that require further action.</translate>

<translate>===Frontend Check===</translate>
<translate>
Go to the front end of the website and check it is working and displaying as it did prior to the update.

As a matter of course, clear your browser cache as this will load any changes to stylesheets and scripts.</translate>

<translate>===System Checks===</translate>

<translate>Joomla makes it easy to do a "health" check. From the sidebar menu click '''System''' to be taken to the System Dashboard. This gives you an overview of the current status of your Joomla site.</translate>

[[File:j4x_system_dashboard-<translate>
en</translate>.png|border|800px]]

<translate>
In this example we can see that since the update we have two items that require attention. They are marked with a label that includes a number. The number relates to how many items require attention. Clicking on each one will allow you to fix them.</translate>

<translate>
'''Note''' The System Dashboard makes a check each time the page is loaded. Bear in mind that browser caching settings could affect this. It's good practice to clear the browsers cache when checking.</translate>

<translate>
'''Recommended Steps and actions:'''</translate>
<translate>
It is recommended that you follow these steps when updating a production site:</translate>
<translate>
# Back up your site before updating to a new version. That way, if something goes wrong during the update process, you can easily restore your site to the earlier version.</translate>
<translate>
# Review the release notes for the new version to be familiar with what was changed.</translate>
<translate>
# Update using one of the recommended methods outlined in this document. These methods install the new program files, delete unneeded old program files, and update the database as needed for the new Joomla version.</translate>
<translate>
# Clear your browser cache and check that the update was successful, using the steps outlined in the '''Checking Site''' tab.</translate>

<translate>
==Checking Your Site==</translate>
<translate>
After an update, it is a good idea to clear your browser cache and check your site to make sure the update was successful. There are two quick checks you can do from the Extension Manager.</translate>

<translate>
Navigate to Extension Manager{{rarr}}Database. If your database is up to date, you should see a screen similar to the one below:</translate>

[[File:j4x-update-screenshot-db-ok-<translate>
en</translate>.png|border|800px|<translate>
Database Screen With No Problems</translate>]]

<translate>
If your database is not up to date, you will see a screen listing the problems found, similar to the one below:</translate>

[[File:j4x-update-screenshot-db-not-ok-<translate>
en</translate>.png|border|800px|<translate>
Database Screen With 3 Database Problems</translate>]]

<translate>
In this case, press the Fix button in the upper right corner. Joomla will update your database to correct the issues listed and then it will re-display the screen. If the fix was successful, the display will indicate that the database is up to date.</translate>

<translate>
'''N.B.''' If any errors still exist make sure all the database tables are checked in.</translate>

<translate>==Extension Manager: Discover==</translate>
<translate>
In some cases, when you update to a new Joomla version, new core extensions are added. If there were problems with the database update, these extensions may not have been correctly installed. To check this, navigate to {{rarr|System,Discover}}. Then click on the Discover icon in the toolbar. The screen should show as follows:</translate>

[[File:j4x-update-screenshot-extensions-<translate>
en</translate>.png|border|800px|<translate>
Discover Screen With No Extensions To Install</translate>]]

<translate>
If so, you know that any new extensions added during the update were correctly installed in the database.</translate>

<translate>
If there are uninstalled extensions, they will show similar to the following screen:</translate>

[[File:j4x-update-screenshot-uninstalled-ext-<translate>
en</translate>.png|border|800px|<translate>
Discover Screen With One Extension To Install</translate>]]

<translate>
In this case, check the boxes and click on the Install icon in the toolbar. Joomla will install the extension(s) and then display the screen showing no extensions discovered. At this point, the new extensions have been installed in the database.</translate>

<translate>==Troubleshooting==
If you have any questions, problems or errors before, during or after the update, please ask them on the '''[[jforum:812|Migrating and Upgrading to Joomla! 4.x Forum]]'''.</translate>

<translate>
If you have problems or errors during the update process, here are some tips.</translate>
<translate>
* Clearing your browser cache. There may have been changes to the CSS or Javascript that will need to be reloaded by your Web browser after an update.</translate>
<translate>
* If any database error messages show after the update, be sure to check the {{rarr|System,Maintenance panel,Database}} link. In some cases, if a database error occurs it will prevent all of the database updates from running. In this case, you can run them from the Database link and then use the {{rarr|System,Install,Discover}} method to check and install any new extensions.</translate>

<translate>
== Troubleshooting Joomla Update ==
</translate>

<translate>
Joomla Update is a core component which is responsible for determining if there is a newer version of Joomla available for installation of your site, download it (or let you upload it) and install it. It has been available in Joomla since Joomla 2.5.1 and as a third party extension two years prior to that. You can access it at System, Update, Joomla.
</translate>

<translate>
The update process consists of several different steps. While every care has been taken to make this process as trouble–free as possible there's always a small chance that something may go wrong, typically due to a very restrictive server configuration or network conditions on a very small minority of sites.
</translate>

<translate>
The following troubleshooting instructions are organised by update step to make it easier to find the information you are looking for. Furthermore, it is an exhaustive resource, based on more than a decade of experience troubleshooting all possible (and some borderline impossible) problems with Joomla and extension updates. It lists problems which are extremely unlikely to occur. Don't let its length scare you; you are very unlikely to ever see any of these problems occur.
</translate>

<translate>
===Determining if updates exist===
</translate>

<translate>
Joomla will make a request to its update server over HTTPS and download an XML file provided by the Joomla project listing the latest available versions. The update server in use can be determined by going to System, Update, Joomla, clicking on Options and examining which update server is in use. You are recommended to use the ''Default'' update server to receive updates to your current major version of Joomla. Use ''Joomla Next'' when you want to upgrade your site to the next major version of Joomla — this is best done on a copy of your site to avoid any nasty surprises; not all third party extensions and templates will be compatible across major Joomla versions. The major version of Joomla is the first digit in the Joomla version, before the first dot. For example, the major version of Joomla 4.0.1 is 4.
</translate>

<translate>
If Joomla cannot determine that an update is available please check the following:
</translate>

<translate>
* The Joomla Update information is out of date in the database. Go to System, Update, Joomla and click on Check for Updates.
* The update sites information in Joomla is corrupt. Go to System, Update, Update Sites and click on Rebuild. Then go to System, Update, Joomla and click on Options. Select the Testing update channel. Click on Save & Close. Click on Options again. Select the Default or Joomla Next update channel — depending on your preference — and click on Save & Close.
* Your host prevents making outbound HTTPS requests at all or restricts them to predefined allowed IP addresses. Please ask them to allow outbound HTTP requests to https://update.joomla.org This is a CDN, meaning that the exact IP address will be different depending on where the world you are trying to access this URL from. Do tell your host; they will know what to do with this information.
* Your host may have an outdated SSL library which does not understand the modern TLS certificates used by the Joomla update CDN. Please ask your host about it.
</translate>

<translate>
===Determining if third party software is compatible with the new version you are about to install===
</translate>

<translate>
Joomla does not have a magical way of evaluating third party code for compatibility. Its report is based solely on the extension information kept in Joomla's #__extensions table, the update sites provided by the installed extensions and the update information provided by the developers of third party extensions including but not limited to which version of their software is compatible with which version of Joomla.
</translate>

<translate>
If the information displayed is incorrect please check the following:
</translate>

<translate>
* What is the minimum stability for extension updates? Go to System, Update, Extensions and click on Options. The ‘Minimum Extension Stability’ determines which is the minimum stability level of a third party software that Joomla will take into account when evaluating compatibility. For example, if this option is set to Stable but only a beta version of a third party extension is compatible with the Joomla version you want to upgrade to Joomla will tell you that there is no compatible version of the third party extension available.
* The update information may be out of date. Go to System, Update, Extensions and click on Check For Updates. Then go back to System, Update, Joomla and see if the extension now appears as compatible or if you are told than a compatible update to it is available.
* The update sites information in Joomla is corrupt. Go to System, Update, Update Sites and click on Rebuild. Then go to System, Update, Joomla and click on Options. Select the Testing update channel. Click on Save & Close. Click on Options again. Select the Default or Joomla Next update channel — depending on your preference — and click on Save & Close.
* Your host prevents making outbound HTTP/HTTPS requests at all or restricts them to predefined allowed IP addresses. This will prevent Joomla from retrieving update information from third party update sites. First go to System, Update, Update Sites. Below each update site you will see its URL. Make a list of those URLs. Then ask your host to allow your site to make requests to these URLs. Please note that some of these URLs may point to a CDN, meaning that the exact IP address will be different depending on where the world you are trying to access this URL from. Do tell your host; they will know what to do with this information.
* Your host may have an outdated SSL library which does not understand the modern TLS certificates used by most third party extension developers' update sites. Please ask your host about it.
* You may have “orphaned” extensions. Most modern Joomla extensions are delivered as ‘package’ type extensions which include two or more related extensions. When installing a package extension Joomla records a package extension in its database. It then records the package ID to each of the installed extensions from that package in the database. The update information is provided for the package, not each individual extension. This association may break if you used Discover to install the extensions, extracted the package and installed the separate extensions directly, Joomla failed to record the package ID for each extension when installing the package (most likely because an error occurred) or your site has been upgraded from an old version of Joomla which predates the use of packages in extensions. In this case even updating the extension will NOT update the package association. There is currently no solution to this except determining manually the compatibility of extensions with each Joomla version.
* In some cases the number of requests Joomla sends to your server as it determines compatibility for each extension may overwhelm the server and trigger a Denial of Service protection. In this case some or all of the extensions will appear as of indeterminate compatibility status. Unfortuantely, you will have to check the compatibility of each extension manually against the information published by extension's developer.
</translate>

<translate>
===Downloading the update===
</translate>

<translate>
Joomla will need to download its update package, a ZIP file which is very similar to the Joomla installation ZIP file but without the web installer (the `installation` directory). This could fail for a few reasons:
</translate>

<translate>
* The ZIP file is rather big. Joomla 4 update packages are around 25MiB. If your server is slow, overwhelmed or has poor connectivity with GitHub — where Joomla update packages are downloaded from — it may take a long time to download the package. If that time is longer than your server's PHP maximum execution time, its maximum CPU usage limit (as determined by ulimit -t in the server command line), the PHP-FPM timeout or the web server's timeout the download will fail and you will see an error page. You will have to ask your host for help with that.
* You may not have enough free space on your site. You need enough space to store the compressed update ZIP file and its extracted files. As a rule of thumb, you need about 50–60 MiB of free space for Joomla Update to work correctly. Do note that the free space reported by your hosting control panel is not always realtime, i.e. it may ‘lag’ several minutes or hours behind the actual disk space usage on your site. Moreover, further limits may be imposed by your host. If unsure, please ask your host.
* Your host prevents making outbound HTTPS requests at all or restricts them to predefined allowed IP addresses. Please ask them to allow outbound HTTP requests to `https://github.com`. This is a CDN, meaning that the exact IP address will be different depending on where the world you are trying to access this URL from. Do tell your host; they will know what to do with this information.
* Your host may have an outdated SSL library which does not understand the modern TLS certificates used by GitHub. Please ask your host about it.
</translate>

<translate>
===Extracting the update===
</translate>

<translate>
After the update ZIP file has downloaded Joomla needs to extract it on your site. Since Joomla is effectively replacing itself and because this process does take some time to complete it cannot happen within Joomla itself. Instead, a separate file (administrator/components/com_joomlaupdate/extract.php) is used to perform the update. This file is inert except when an update is in progress.
</translate>

<translate>
You may get an error during the extraction for one of the following reasons:
</translate>

<translate>
* You cannot access the extract.php file because of a server protection e.g. a customised .htaccess file on Apache and Litespeed servers. Try accessing https://www.example.com/administrator/components/com_joomlaupdate/extract.php from a web browser, where https://www.example.com/ is to be replaced with the URL to your site. You should see the message {"status":false,"message":"Invalid login"} If you see anything else you are being forbidden from accessing this file.
* If you can access the file but extracting the update fails immediately there is a different server protection on your site which prevents the request to `extract.php` from being handled by that file. Please contact your host about this.
* If you are using CloudFlare go to Rules and create a new Page Rule. Set the If URL Matches to */administrator/components/com_joomlaupdate/extract.php and Then The Settings Are to “Disable Security” and on a new line ”Cache Level”, ‘Bypass’. Set the Order to First. Click on Save and Deploy. This ensures that CloudFlare will not try to block the update extraction.
* The update ZIP file is corrupt or truncated. This could happen if downloading the update file failed with an error. Go back and retry. See also the previous section.
* If you are using upload and update i.e. you uploaded the update ZIP file yourself please make sure that you are using only the official Joomla Update ZIP files. The extraction script only supports a subset of the ZIP archive format used by the official update ZIP files.
* Did you run out of disk space? Please check the section above.
* Is the ownership and permissions of all files correct? Joomla needs write access to all of its files and folders. If unsure, ask your host. There is no specific set of “good” permissions! The permissions needed depend on the ownership of your files and which system user the web server runs under.
* Did you lose network connectivity or your network has very high latency? It's possible that the request fails because of that.
* The extraction takes place by making consecutive requests to the aforementioned extract.php file. Each request is set up to take between 3 and 4 seconds. The process repeats until the entirety of the update file has been extracted. On some servers this cadence of requests to the same file from the same IP address may trigger the server's security. On other servers it may trigger a different server protection, e.g. a maximum PHP time limit, a maximum CPU usage limit or another server timeout. On even fewer servers running on CloudLinux it could trigger a server memory outage situation if your server was already running low on memory. You need to contact your server about that; there is nothing you can do yourself to work around these server limitations.
</translate>

<translate>
===Finalising the update===
</translate>

<translate>
This is a two step process.
</translate>

<translate>
Right after the update ZIP file has been extracted a final step will run which removes old files. When upgrading to a new major version of Joomla the list of files to remove is pretty big and the process may timeout. Moreover, the point made in the previous section about ownership and permissions of files is important here too; Joomla needs write permissions to the old files and folders it has to remove. If this step fails you can resume it from the command line. Go into the cli folder and run ''php joomla.php update:joomla:remove-old-files'' If you cannot do it yourself ask your host to do it for you. You will also need to follow the workaround for the next step.
</translate>

<translate>
Finally, Joomla reloads and you are logged back into the administrator interface. At this point Joomla updates its database tables and performs any database administration tasks. If this fails you can resume the process by going to System, Maintenance, Database. Select Joomla CMS from the list and click on Update Structure.
</translate>

<noinclude>
[[Category:Upgrading{{#translation:}}]]
[[Category:Joomla! 4.x{{#translation:}}]]
[[Category:Update Working Group{{#translation:}}]]
</noinclude>
<noinclude>[[Category:Needs to be marked for translation]]</noinclude>

Help4.x:Components Joomla Update

2022-06-08T11:23:43Z

Nikosdion: Added troubleshooting information

{{incomplete}}

<noinclude><languages /></noinclude>

{{Chunk30:Help_screen_Description_Header/<translate>en</translate>}}
<translate>
This screen allows Joomla to be updated quickly by downloading the current update package from the Joomla code repository if there is an update. This setting is the default setting.</translate>

<translate>
'''Update Images'''
</translate>

<translate>
*''Update Screen when on the latest version:''</translate>

<translate>
You're on the latest version of Joomla, so no action required. If you have problems with Joomla it is possible to overwrite the latest Joomla core files. To do so click the button '''Reinstall Joomla core files''' and Joomla will install the latest core files.</translate>

<translate>
Installation method can have the following values:
# Write files directly
# Hybrid (use FTP only if needed)
# Write files using FTP
The first method is advised.
</translate>

<translate>
*''The update screen when an update is available:''</translate>

<translate>
You're NOT on the latest version of Joomla, you can install the latest update from this screen. To do so click the button '''Install the Update''' and Joomla will install the latest update.</translate>

<translate>
Installation method can have the following values:
# Write files directly
# Hybrid (use FTP only if needed)
# Write files using FTP
The first method is advised.
</translate>

<translate>
*''The screen while updating:''</translate>

<translate>
== Troubleshooting ==
</translate>

<translate>
Joomla Update is a core component which is responsible for determining if there is a newer version of Joomla available for installation of your site, download it (or let you upload it) and install it. It has been available in Joomla since Joomla 2.5.1 and as a third party extension two years prior to that. You can access it at System, Update, Joomla.
</translate>

<translate>
The update process consists of several different steps. While every care has been taken to make this process as trouble–free as possible there's always a small chance that something may go wrong, typically due to a very restrictive server configuration or network conditions on a very small minority of sites.
</translate>

<translate>
The following troubleshooting instructions are organised by update step to make it easier to find the information you are looking for. Furthermore, it is an exhaustive resource, based on more than a decade of experience troubleshooting all possible (and some borderline impossible) problems with Joomla and extension updates. It lists problems which are extremely unlikely to occur. Don't let its length scare you; you are very unlikely to ever see any of these problems occur.
</translate>

<translate>
===Determining if updates exist===
</translate>

<translate>
Joomla will make a request to its update server over HTTPS and download an XML file provided by the Joomla project listing the latest available versions. The update server in use can be determined by going to System, Update, Joomla, clicking on Options and examining which update server is in use. You are recommended to use the ''Default'' update server to receive updates to your current major version of Joomla. Use ''Joomla Next'' when you want to upgrade your site to the next major version of Joomla — this is best done on a copy of your site to avoid any nasty surprises; not all third party extensions and templates will be compatible across major Joomla versions. The major version of Joomla is the first digit in the Joomla version, before the first dot. For example, the major version of Joomla 4.0.1 is 4.
</translate>

<translate>
If Joomla cannot determine that an update is available please check the following:
</translate>

<translate>
* The Joomla Update information is out of date in the database. Go to System, Update, Joomla and click on Check for Updates.
* The update sites information in Joomla is corrupt. Go to System, Update, Update Sites and click on Rebuild. Then go to System, Update, Joomla and click on Options. Select the Testing update channel. Click on Save & Close. Click on Options again. Select the Default or Joomla Next update channel — depending on your preference — and click on Save & Close.
* Your host prevents making outbound HTTPS requests at all or restricts them to predefined allowed IP addresses. Please ask them to allow outbound HTTP requests to https://update.joomla.org This is a CDN, meaning that the exact IP address will be different depending on where the world you are trying to access this URL from. Do tell your host; they will know what to do with this information.
* Your host may have an outdated SSL library which does not understand the modern TLS certificates used by the Joomla update CDN. Please ask your host about it.
</translate>

<translate>
===Determining if third party software is compatible with the new version you are about to install===
</translate>

<translate>
Joomla does not have a magical way of evaluating third party code for compatibility. Its report is based solely on the extension information kept in Joomla's #__extensions table, the update sites provided by the installed extensions and the update information provided by the developers of third party extensions including but not limited to which version of their software is compatible with which version of Joomla.
</translate>

<translate>
If the information displayed is incorrect please check the following:
</translate>

<translate>
* What is the minimum stability for extension updates? Go to System, Update, Extensions and click on Options. The ‘Minimum Extension Stability’ determines which is the minimum stability level of a third party software that Joomla will take into account when evaluating compatibility. For example, if this option is set to Stable but only a beta version of a third party extension is compatible with the Joomla version you want to upgrade to Joomla will tell you that there is no compatible version of the third party extension available.
* The update information may be out of date. Go to System, Update, Extensions and click on Check For Updates. Then go back to System, Update, Joomla and see if the extension now appears as compatible or if you are told than a compatible update to it is available.
* The update sites information in Joomla is corrupt. Go to System, Update, Update Sites and click on Rebuild. Then go to System, Update, Joomla and click on Options. Select the Testing update channel. Click on Save & Close. Click on Options again. Select the Default or Joomla Next update channel — depending on your preference — and click on Save & Close.
* Your host prevents making outbound HTTP/HTTPS requests at all or restricts them to predefined allowed IP addresses. This will prevent Joomla from retrieving update information from third party update sites. First go to System, Update, Update Sites. Below each update site you will see its URL. Make a list of those URLs. Then ask your host to allow your site to make requests to these URLs. Please note that some of these URLs may point to a CDN, meaning that the exact IP address will be different depending on where the world you are trying to access this URL from. Do tell your host; they will know what to do with this information.
* Your host may have an outdated SSL library which does not understand the modern TLS certificates used by most third party extension developers' update sites. Please ask your host about it.
* You may have “orphaned” extensions. Most modern Joomla extensions are delivered as ‘package’ type extensions which include two or more related extensions. When installing a package extension Joomla records a package extension in its database. It then records the package ID to each of the installed extensions from that package in the database. The update information is provided for the package, not each individual extension. This association may break if you used Discover to install the extensions, extracted the package and installed the separate extensions directly, Joomla failed to record the package ID for each extension when installing the package (most likely because an error occurred) or your site has been upgraded from an old version of Joomla which predates the use of packages in extensions. In this case even updating the extension will NOT update the package association. There is currently no solution to this except determining manually the compatibility of extensions with each Joomla version.
* In some cases the number of requests Joomla sends to your server as it determines compatibility for each extension may overwhelm the server and trigger a Denial of Service protection. In this case some or all of the extensions will appear as of indeterminate compatibility status. Unfortuantely, you will have to check the compatibility of each extension manually against the information published by extension's developer.
</translate>

<translate>
===Downloading the update===
</translate>

<translate>
Joomla will need to download its update package, a ZIP file which is very similar to the Joomla installation ZIP file but without the web installer (the `installation` directory). This could fail for a few reasons:
</translate>

<translate>
* The ZIP file is rather big. Joomla 4 update packages are around 25MiB. If your server is slow, overwhelmed or has poor connectivity with GitHub — where Joomla update packages are downloaded from — it may take a long time to download the package. If that time is longer than your server's PHP maximum execution time, its maximum CPU usage limit (as determined by ulimit -t in the server command line), the PHP-FPM timeout or the web server's timeout the download will fail and you will see an error page. You will have to ask your host for help with that.
* You may not have enough free space on your site. You need enough space to store the compressed update ZIP file and its extracted files. As a rule of thumb, you need about 50–60 MiB of free space for Joomla Update to work correctly. Do note that the free space reported by your hosting control panel is not always realtime, i.e. it may ‘lag’ several minutes or hours behind the actual disk space usage on your site. Moreover, further limits may be imposed by your host. If unsure, please ask your host.
* Your host prevents making outbound HTTPS requests at all or restricts them to predefined allowed IP addresses. Please ask them to allow outbound HTTP requests to `https://github.com`. This is a CDN, meaning that the exact IP address will be different depending on where the world you are trying to access this URL from. Do tell your host; they will know what to do with this information.
* Your host may have an outdated SSL library which does not understand the modern TLS certificates used by GitHub. Please ask your host about it.
</translate>

<translate>
===Extracting the update===
</translate>

<translate>
After the update ZIP file has downloaded Joomla needs to extract it on your site. Since Joomla is effectively replacing itself and because this process does take some time to complete it cannot happen within Joomla itself. Instead, a separate file (administrator/components/com_joomlaupdate/extract.php) is used to perform the update. This file is inert except when an update is in progress.
</translate>

<translate>
You may get an error during the extraction for one of the following reasons:
</translate>

<translate>
* You cannot access the extract.php file because of a server protection e.g. a customised .htaccess file on Apache and Litespeed servers. Try accessing https://www.example.com/administrator/components/com_joomlaupdate/extract.php from a web browser, where https://www.example.com/ is to be replaced with the URL to your site. You should see the message {"status":false,"message":"Invalid login"} If you see anything else you are being forbidden from accessing this file.
* If you can access the file but extracting the update fails immediately there is a different server protection on your site which prevents the request to `extract.php` from being handled by that file. Please contact your host about this.
* If you are using CloudFlare go to Rules and create a new Page Rule. Set the If URL Matches to */administrator/components/com_joomlaupdate/extract.php and Then The Settings Are to “Disable Security” and on a new line ”Cache Level”, ‘Bypass’. Set the Order to First. Click on Save and Deploy. This ensures that CloudFlare will not try to block the update extraction.
* The update ZIP file is corrupt or truncated. This could happen if downloading the update file failed with an error. Go back and retry. See also the previous section.
* If you are using upload and update i.e. you uploaded the update ZIP file yourself please make sure that you are using only the official Joomla Update ZIP files. The extraction script only supports a subset of the ZIP archive format used by the official update ZIP files.
* Did you run out of disk space? Please check the section above.
* Is the ownership and permissions of all files correct? Joomla needs write access to all of its files and folders. If unsure, ask your host. There is no specific set of “good” permissions! The permissions needed depend on the ownership of your files and which system user the web server runs under.
* Did you lose network connectivity or your network has very high latency? It's possible that the request fails because of that.
* The extraction takes place by making consecutive requests to the aforementioned extract.php file. Each request is set up to take between 3 and 4 seconds. The process repeats until the entirety of the update file has been extracted. On some servers this cadence of requests to the same file from the same IP address may trigger the server's security. On other servers it may trigger a different server protection, e.g. a maximum PHP time limit, a maximum CPU usage limit or another server timeout. On even fewer servers running on CloudLinux it could trigger a server memory outage situation if your server was already running low on memory. You need to contact your server about that; there is nothing you can do yourself to work around these server limitations.
</translate>

<translate>
===Finalising the update===
</translate>

<translate>
This is a two step process.
</translate>

<translate>
Right after the update ZIP file has been extracted a final step will run which removes old files. When upgrading to a new major version of Joomla the list of files to remove is pretty big and the process may timeout. Moreover, the point made in the previous section about ownership and permissions of files is important here too; Joomla needs write permissions to the old files and folders it has to remove. If this step fails you can resume it from the command line. Go into the cli folder and run ''php joomla.php update:joomla:remove-old-files'' If you cannot do it yourself ask your host to do it for you. You will also need to follow the workaround for the next step.
</translate>

<translate>
Finally, Joomla reloads and you are logged back into the administrator interface. At this point Joomla updates its database tables and performs any database administration tasks. If this fails you can resume the process by going to System, Maintenance, Database. Select Joomla CMS from the list and click on Update Structure.
</translate>

{{cathelp|4.0,4.1,4.2,4.3|Components Help Screens|Update|Security}}

[[Category:Security]]

WebAuthn Passwordless Login

2022-04-29T21:16:28Z

Nikosdion: Expand the documentation to better describe what WebAuthn is, why it's important and add the FAQ section from the PR

<noinclude><languages /></noinclude>
<noinclude>{{Joomla version|version=4.x}}</noinclude>
{{-}}
<translate>
== System - WebAuthn Passwordless Login == 
</translate>

<translate>Web Authentication, or WebAuthn for short, allows a user to securely log into a site without using a password — though you still need to provide your username. It does using strong cryptography and in a manner which is extremely resistant to the most common problems of passwords: someone guessed it (brute force attack), someone intercepted it (man in the middle attack), someone tricked you into divulging it (phishing attack), someone cracked it after getting ahold of a copy of your database data (SQL injection attacks) or someone stole it.</translate>

<translate>WebAuthn is not just very secure; it is also very user friendly! You no longer have to remember long passwords or use a password manager. All you need is an ''authenticator'', sometimes also called a ''passkey''. An authenticator can have many forms, physical or virtual. It can be a separate hardware key connecting to your device via USB, Bluetooth or NFC. It can be your device itself, unlocking its built-in authenticator with a PIN, fingerprint reader, facial scan or similar biometric check. This feature already works on Android and iOS/iPadOS devices and we're working on enabling it on Windows as well. It can even be your phone — currently this is possible with Android phones but this feature is also coming to iOS / iPadOS devices.</translate>

<translate>WebAuthn only works over HTTPS and only when your site is using a valid, trusted certificate for it. Don't worry, you don't have to spend any extra money; free of charge services like Let's Encrypt are typically integrated into web hosting control panels and work perfectly fine with WebAuthn.</translate>

<translate>WebAuthn uses public key cryptography, the same proven technology that keeps your sites safe with HTTPS, your banking information secure and so on. The private key never leaves the authenticator. Your site only stores a public key. Even if you suffer a data breach the attacker will be left with a practically useless public key; it would take them thousands to millions of CPU years to crack it as opposed to a few minutes or hours required to crack the hash of a fixed password that you can remember.</translate>

<translate>WebAuthn is the future of authentication. Easy, secure and hassle-free. Everything that fixed passwords are not.</translate>

<translate>The following picture shows a hardware device inserted into a laptop computer's USB port. It cost £15 in February, 2022.</translate>

[[File:j4x-passwordless-login-hardware-device.jpg|center|Hardware device]]

<translate>WebAuthn uses a system plugin that is enabled by default. A '''Web Authentication''' button will be present in default Joomla 4 login screens, as illustrated in the Administrator login screen:</translate>

[[File:j4x-passwordless-login-admin-login.png|center|border|Administrator Login]]

<translate>
== User Configuration ==</translate>

The user must first register with a normal Username and Password. After logging in go to the User Profile form. For an Administrator:
* Select {{rarr|User Menu, Edit Account, W3C Web Authentication (WebAuthn) Login}} to bring up the form, initially with no authenticators registered.
* Select '''Add New Authenticator'''

The exact presentation of the next step depends on your browser. Typically, you will see an alert, message or window asking you to select an authenticator type or, if you're using a hardware authenticator attached to your device, reminding you to press the button on the hardware authenticator. For security and practical reasonts there is a relatively short time interval allowed for activating the authenticator: 60 seconds.

[[File:j4x-passwordless-login-hardware-propmpt.png|center|Hardware Prompt]]

Once you unlock your authenticator — tapping on a button, scanning your fingerprint / face, entering a PIN or a combination of the above depending on your authenticator — the message disappears, the authenticator is registered and the screen appears as follows:

[[File:j4x-passwordless-login-registered-authenticator.png|center|Registered Authenticator]]

It is very important to note that you can only register or remove authenticators on your own user account. For security reasons, even a Super User is disallowed from registering, editing or adding authenticators on other user accounts.

=== Authenticators ===

You can use any FIDO U2F or FIDO2 authenticator. FIDO U2F is an older standard which supports a more limited, less secure selection of cryptographic methods. FIDO2 is the newer standard which supports much more secure cryptographic methods including Elliptic Curve Cryptography, a cryptographic method which is believed to be resistant even to quantum computing (if and when it becomes a practical reality). Moreover, FIDO2 authenticators can be set up to have additional protections such as a PIN or a biometric control (e.g. fingerprint scan) which means that even if you lose physical possession of the authenticator itself whoever finds it cannot log into your sites.

If you are looking to buy a hardware authenticator you can look for "FIDO2" in your favorite marketplace, such as Amazon. There is a wide selection to choose from.

You may also use a software FIDO key such as Krypton as your authenticator.

Many devices have built-in FIDO2-compliant authentication:

* Windows 10 and 11 have Windows Hello with a PIN, fingerprint scanner, facial recognition camera or a combination of hardware key and PIN. Support for Windows Hello is being added to the plugin with a release target of Joomla 4.2.0.
* macOS has TouchID on all laptops with the T2 chipset or those based on Apple Silicon using the built-in TouchID sensor, as well as all Apple Silicon–based desktops using the new Apple Aluminium keyboard with a fingerprint scanner.
* iOS / iPadOS has TouchID on all devices with a fingerprint scanner and FaceID on all newer devices with a FaceID infrared dot projection camera.
* Some Android devices have a fingerprint scanner or a face recognition camera. These can also work as FIDO2 authenticators, on Android 9 or later using Google Chrome at least.
* Other devices may be available too. For example, Android phones using [https://groups.google.com/a/fidoalliance.org/g/fido-dev/c/go6GoFW27Dw/m/9flCLR5pBQAJ?pli=1 caBLE]

=== WebAuthn compatible browsers ===

Chromium and Firefox based browsers have supported WebAuthn since early 2019.

Safari and all iOS/iPadOS browsers (which are, in fact, Safari with a different skin) fully support WebAuthn since iOS/iPadOS 13 released late 2019.

Practically speaking, if your operating system and browser were released after mid-2020 you should have no problem. Only some very uncommon browsers still lack support for WebAuthn.

== Authentication ==

To login you must enter your username in the login form Username field. You do not need to enter your password but if your browser enters it for you just leave it. The password is NOT sent to the server when the form is submitted via the Web Authentication button.

It follows that you can login with either your Username and Password or Username and Web Authentication.

== How To Disable the Plugin ==

If you do not wish to allow WebAuthn just go to the list of plugins and find System - WebAuthn Passwordless Login in the System group and disable it. There are no parameters to set.

== Server Requirements ==

For WebAuthn to work the following preconditions must be met:

* HTTPS with a valid, signed certificate. Most hosts let you use free of charge certificates issues by Let's Encrypt. These work perfectly fine with WebAuthn.
* The OpenSSL extension for PHP must be installed and enabled.
* The PHP extension GMP or the PHP extension BCmath must be installed and enabled (either will do).
* The Sodium library should ideally be enabled; it enables the use of Elliptic Curve Cryptography on compatible FIDO2 authenticators which, as we said, is the most secure cryptographic method.

== Frequently Asked Questions and Troubleshooting ==

=== I can't see the “Web Authentication” login button ===

You are not accessing your site under HTTPS. WebAuthn is only available for HTTPS sites with a valid certificate. This is a security precaution baked into the WebAuthn standard. The plugin actually checks if the site is accessed through HTTPS using Joomla's Uri class. In rare cases where the server lies about the protocol you might not see the button even though your site (claims to be) HTTPS. Same goes if you have edited your configuration.php file and set up the optional $live_site configuration parameter with an http:// protocol prefix instead of https://.

Also note that third party login modules and components implementing their own login form may not display these buttons just yet. We added new infrastructure to support them, much like what we had to do in Joomla! 3.2 to support Two Factor Authentication.

=== I still need to provide a username. Isn't WebAuthn supposed to get rid of usernames? ===

Not really, no. The current specification of WebAuthn does not provide identity management. Web browsers require us to send them a list of acceptable WebAuthn public keys during the login phase. This means that we need your username to fetch them.

That said, using WebAuthn finally makes it clear that usernames ''are not to be considered secrets''. They are considered public information which can be freely transmitted to an adversary, just like the public keys stored in the site's database. The only secret is stored in the authenticator itself and never leaves the authenticator!

=== I have registered an authenticator but trying to log in tells me that I haven't. Is this a bug? ===

It is a bug but not with the WebAuthn plugin itself.

One or more plugins on your site throw PHP Notices, Warnings or Errors, thus corrupting the reply sent back by your server. As a result the JavaScript on the page cannot parse the server response and is unsure whether any authenticators are registered by the user.

Go to your site's backend, System, Global Configuration and set Error Reporting to None. In most cases of misbehaving core and 3PD plugins this is enough. Otherwise please examine the output of the request using your browser's developer tools to see what is corrupting the request.

=== There is no prompt on Safari to use my authenticator ===

This should no longer be happening with iOS 13, iPadOS 13 and macOS Catalina or any later version.

This is a Safari bug in older versions of Safari. Older versions of Safari only included support for WebAuthn as an experimental feature and not quite finished.

=== I cannot use a biometric sensor (TouchID, fingerprint, Windows Hello) ===

Some older Chromium-based browsers (except Google Chrome proper) didn't have full support for built-in authenticators. They would crash or hang when you tried using one. These issues were fixed in these browsers around mid-2020.

If you are using Windows please remember that your device MUST have a Trusted Platform Module (TPM) chip and it must be enabled in the BIOS. Just having a Windows Hello-compatible biometric sensor won't do the trick. This is a security precaution in the WebAuthn standard itself: the authenticator information must be processed using secure, tamper-resistant hardware to prevent key subversion (e.g. malware running on the computer cannot steal the key used for authentication).

Finally, do keep in mind that Windows Hello support is still being worked on and will be released with Joomla 4.2.

=== If I can use a software authenticator why should I bother with a hardware token? ===

The linchpin of WebAuthn is the absolute secrecy of the private key. It is only known to the authenticator and it should be impossible to communicate to the outside world.

In the case of a hardware authenticator, be it a discrete hardware device or a TPM / Secure Enclave built into your device, this is a given by the very nature of that hardware.

A software authenticator generates a secret key and stores it in the filesystem. However, it is still a regular software application which runs inside your regular operating system, be it your phone's or your computer's. As a result it is susceptible to several classes of attacks which can be used to surreptitiously steal information (security issues in the software itself, malware using Spectre-class vulnerabilities in modern CPUs etc).

So, a software authenticator is far more convenient and secure than a regular password but a hardware authenticator offers the best security. Choose your authenticator based on your budget and security needs.

Considering that the price of a FIDO key –which is compatible with WebAuthn– is under €10 on Amazon you can use a hardware authenticator in most practical use cases.

=== Why are the credentials encrypted in the database? Isn't this an overkill? ===

The only thing stored in the database is the public key returned by the authenticator when we are performing the attestation ceremony (that's the formal name of registering an authenticator per the WebAuthn specification). Being a public key it does not need protecting from reading. Even if an unauthorised user was able to read this information they would not be able to impersonate the authenticator e.g. by cloning it.

However, if a malicious user had write access just to the #__webauthn_credentials database table, without read access to the filesystem and without write access to any other table, they could conceivably '''add''' their own authenticator, therefore being able to impersonate the targeted user on the system. This is a very theoretical attack since they would also need to know the user handle for the user they are attacking which is harder to derive without some inside knowledge of the site itself. Besides, having write access to just this table and not the entire database (in which case they could create a new Super User) is extremely unlikely. Still, we are encrypting the credentials to make it impossible for even this entirely theoretical attack to succeed.

We are fully aware that if a user has read access to the server filesystem they have access to the encryption key and the database connection information, all of which is stored in configuration.php. However, in this case you are already hacked: the attacker can read configuration.php therefore they know how to connect to your database. In this case they can do whatever they please to your site, including deleting all existing Super Users and creating their own Super User account. Therefore there's no reason to try to address this situation; you'd be fully compromised (hacked). The only that could be a saving grace is regular, tested, off-site backups.

=== I have set up Two Factor Authentication but I am logged in without providing my Secret Key. Isn't this insecure? ===

No, it's intentional and by design.

When we added Two Factor Authentication (TFA) in Joomla! 3.2 you were only able to log into your site using a username and password. Passwords can be stolen or guessed. Therefore TFA was the only way to provide a modicum of security on high risk and high value targets. That was back in 2013.

WebAuthn is an entirely different authentication solution which has none of the problem of fixed passwords. It uses strong cryptography and secure hardware to make it practically impossible to subvert the authentication cryptographic keys. It's also unphishable, i.e. you cannot be fooled into using it on an impersonating site since the WebAuthn credential is tied to the exact domain name it was issued for (yes, if you use multiple domains for your site or transfer your site to another domain you'll need to re-register all your WebAuthn authenticators – you got that right!). As a result, authentication with WebAuthn is incredibly secure and supersedes the reasons that necessitated TFA. This means that if you successfully authenticate using WebAuthn the TFA secret key needs not be –and is therefore not– checked at all.

In an ideal world, you would only be able to log into your site using WebAuthn. This is a feature we are working on and you may not want to enable; after all, if your domain name changes or you lose access to or reset all of your WebAuthn authenticators you'd be locked out of your site. Therefore you should still enable TFA on your user account on the basis that password login can still be used as a fallback to logging into your site and must be protected from known attacks against fixed passwords.

=== Isn't TFA good enough? Why do we need WebAuthn? ===

TFA alone is good enough in most cases but suffers from two issues.

First, it has a rather awkward user experience. You need to provide your ever-changing secret key with your username and password. Most people use TOTP (the six digit PIN that changes every 30 seconds) which slows down logging in and tends to frustrate users. Using a YubiKey is much faster but also more expensive and more complicated to provision when you have more than a couple of users on the site. A YubiKey also has an expected life of about 2 years of everyday use when generating One Time Passwords (it runs out of the write-once memory it uses to keep track of the signatures it has issued).

Second, if you are using TOTP you still are susceptible to security issues such as keyloggers, phishing and the possibility that the secret key used for generating the TOTP is stolen. Moreover, with one million possibilities and thirty seconds to try them it is conceivable that an attacker can get lucky since Joomla doesn't lock your account or otherwise employ rate limiting for failed login attempts. While these protections could be implemented, the implementation itself could be abused to create a denial of service situation which locks a legitimate user out of their site while the attacker is busy infiltrating it. It's a case of the remedy being worse than the disease.

WebAuthn greatly improves the user experience. Major browsers embraced WebAuthn and offer a compelling user experience, guiding the users into using authenticators successfully. Logging in with WebAuthn is more convenient even when compared to using a password manager's auto-fill feature. With recent versions of mobile operating systems even that experience, once slightly confusing, is rapidly becoming easier than passwords and TFA ever were.

Where WebAuthn is truly killing it is at the security front. By virtue of using secure hardware and strong validation of the site's domain name it is practically immune to keyloggers, phishing and key subversion. It even has built-in protection against key cloning. Yes, you can still lose your hardware — but FIDO2 authenticators, be they external devices or built-in, can be locked out with a PIN or biometrics. Overall, using WebAuthn with FIDO2 authenticators is more theft- and loss-resistant than your house or car keys.

== Developer Notes ==

=== Extra login buttons ===

The plugin module and com_users now use the onUserLoginButtons event, defined and called in Joomla\CMS\Helper\AuthenticationHelper::getLoginButtons, to retrieve the definitions of any additional buttons which need to be placed after the regular login button.

All developers implementing a login module or, more generally, a login form should also use the Joomla\CMS\Helper\AuthenticationHelper::getLoginButtons public static method to retrieve said definitions and render these buttons to make their software fully compatible with Joomla 4.

Developers wishing to implement custom buttons should look at how the WebAuthn system plugin implements this functionality. Such buttons can be used for implementing third party single-sign-on services or even logging in using third party identity services such as those offered by popular social media (Facebook, Google, Twitter, GitHub etc).

This change does not adversely impact backwards compatibility. Third party login modules and login forms will continue functioning normally even if they do not implement the extra login buttons feature with the notable omission of integrations afforded by said feature such as Web Authentication itself. That is to say they won't stop functioning (which would be a b/c break) but they won't be feature-complete.

=== Allowing com_ajax in the backend login page ===

The Administrator login page whitelists com_ajax in AdministratorApplication so it can be used to handle requests by guest users.

This change does not cause any backwards compatibility issues as long as developers use sane practices and do not assume that being called by com_ajax in the backend is proof that the user is logged into the backend. That would be a bad security practice. The sane practice is to use Joomla's User object to detect if it's a guest user and if not whether the user is allowed a permission required to effect the action requested through com_ajax. That is to say, if this change has broken your code then your code was already broken and needed to be reworked anyway.

== Further Information ==

''The initial documentation of this feature is in the pull request at [https://github.com/joomla/joomla-cms/pull/28094 PR #28094].

<noinclude>
[[Category:Joomla! 4.x{{#translation:}}]]
[[Category:Security{{#translation:}}]]
[[Category:Joomla! Wiki need pages]]
</noinclude>

J3.x:Make your own Action Log Plugin

2019-04-16T07:19:52Z

Nikosdion: Documented how to create user action plugins

Joomla! 3.9 and later allows extensions to log their actions in the User Action Log. This is done by creating a plugin in the actionlog folder.

Please note that if your plugin is not in the actionlog folder you will get untranslated strings in the User Action Log component and / or module when actions of your extension are being displayed.

As a developer, you should be aware that all published actionlog plugins are loaded by Joomla's Action Log system plugin on every page load. The implication to that is that the constructor of your actionlog plugin should be kept to a bare minimum and not do any initialization which could have a performance impact. If you need to perform any kind of heavy initialization try to defer it for the last possibly moment, i.e. when you are about to log an action.

The actionlog plugin is meant to "catch" your extension's actions and log them. The "catching" part depends entirely on your extension. The concept is that each interesting action that needs to be logged must trigger a plugin event which is handled by your actionlog plugin and has the effect of logging said action to the database.

Joomla's MVC only triggers events on content preparation. If you want to see how you can handle those events for your component check the Joomla plugin in the actionlog folder.

For everything else it's advisable to use your own, custom plugin event names. Take extra care to not cause any naming conflicts. For example, a plugin event called onAfterInitialize is '''BAD''' because it clashes with Joomla's built-in event by the same name. DO NOT use generic plugin names such as onAfterSave because you are guaranteed to cause a conflict with another extension or Joomla itself. Remember that plugin event names are shared across all plugins in all plugin folders!

The best way to prevent naming clashes is using naming conventions like the following:

* For components, onComComponentControllerViewnameAfterorbeforeTask e.g. onComExampleControllerItemsAfterBrowse for option=com_example&view=items&task=browse
* For plugins, onPlgFolderPluginnameAction e.g. onPlgSystemFoobarBaz to log the "baz" action taken by a plugin named foobar in the system folder.

Modules, templates and libraries are unlikely candidates for actions you might want to log but you can use a similar naming convention:

* For modules, onModSiteoradminModulenameAction e.g. onModSiteExampleFoo for a front-end (site) module mod_example taking action foo
* For libraries, onLibLibrarynameAction e.g. onLibExampleFoo for the lib_example library taking action foo
* For templates, onTplSiteoradminTemplatenameAction e.g. on TplSiteExampleFoo for a front-end template named example taking action foo

If you have a Model used in many of your component's controllers and you would rather log an action taken there you can use the naming convention onComComponentModelModelnameAfterorbeforeMethodname e.g. onComExampleModelItemsBeforeSave to log something that happens after calling the ExampleModelItems::save() method. Again, this convention is arbitrary and the only reason we recommend it is that you can have a reasonable expectation that it won't cause naming clashes. The more specific the event name is the less likely it is to have a conflict with core or third party code.

Logging the actions requires going through a bit of code to perform sanity checks (e.g. correct Joomla version) and do the actual logging. Here is a prototype function you can use in your plugin:

<source lang="php">
public function logUserAction($title, $logText, $extension)
{
static $joomlaModelAdded = false;

// User Actions Log is available only under Joomla 3.9+
if (version_compare(JVERSION, '3.9', 'lt'))
{
return;
}

// Include required Joomla Model
if (!$joomlaModelAdded)
{
\JModelLegacy::addIncludePath(JPATH_ROOT . '/administrator/components/com_actionlogs/models', 'ActionlogsModel');
$joomlaModelAdded = true;
}

$user = $this->getUser();

// No log for guest users
if ($user->guest)
{
return;
}

$message = array(
'title' => $title,
'username' => $user->username,
'accountlink' => 'index.php?option=com_users&task=user.edit&id=' . $user->id
);

/** @var \ActionlogsModelActionlog $model **/
try
{
$model = \JModelLegacy::getInstance('Actionlog', 'ActionlogsModel');
$model->addLog(array($message), $logText, $extension, $user->id);
}
catch (\Exception $e)
{
// Ignore any error
}
}
</source>

Here is an example plugin method performing user action logging:

<source lang="php">
/**
* Logs the creation of a new backup profile
*
* @param \Akeeba\Backup\Admin\Controller\Profiles $controller
* @param array $data
* @param int $id
*/
public function onComAkeebaControllerProfilesAfterApplySave($controller, $data, $id)
{
// If I have an ID in the request and it's the same of the model, I'm just editing a record
if (isset($data['id']) && $data['id'] == $id)
{
return;
}

$profile_title = $data['description'];

$this->logUserAction($profile_title, 'COM_AKEEBA_LOGS_PROFILE_ADD', 'com_akeeba');
}
</source>

Note that the log title (the second argument to the method) is a translation key. It is defined similar to that:

COM_AKEEBA_LOGS_PROFILE_ADD="User <a href=\"{accountlink}\">{username}</a> created the backup profile {title}"

The {title} variable is the $title parameter in our method. The other two variables are defined and processed by the User Action Logs module and component when rendering the user actions log.

Caveat: Since Joomla 4 has not yet integrated the Action Logs component and plugins the code above will not work on Joomla! 4. If / when Action Logs are ported to Joomla 4 we'll have to revisit this documentation page since neither JModelLegacy is available, nor will the Model name be ActionlogsModelActionlog.

User:Sandra97/SandBox

2015-08-20T17:01:20Z

Nikosdion: Small language improvements

Two Factor Authentication

Joomla! was the first major CMS to implement two-factor authentication. Add a single-use code received on your cell phone or a Yubikey to your existing passwords to make your site extra hacker-proof.

<div class="video-container" style="text-align:center">
{{#widget:YouTube|id=NbG6eehASW8}}
</div>

Traditionally, when you want to log in to a website, you have to provide your username and your password in order to identify you to the system.
The biggest problem with this approach is that the username and password can be stolen or can be guessed.
For example, if your computer is infested with malware or if you try to access your site from an untrusted network, such as a public WiFi hotspot, it is possible that someone intercepts your username and password. This means that they can log in to your site as yourself. Your site can be hacked at that point.

In order to prevent that, Joomla! 3.2.0 and later versions comes with a built-in two factor authentication system that secures your site login with a secondary, single use secret code.

==Enable Two Factor Authentication==
The very first time you’re installing Joomla! 3.2 or higher, and access your backend, you’ll see a notice about post-installation messages.

[[Image:Joomla-two-factor-authentication-post-installation-en.png]]

Click on the ''Review Messages'' button, you’ll see a screen which indicates that Two Factor Authentication is Available.
Click on the ''Enable two factor authentication'' button.

[[Image:Joomla-two-factor-authentication-enable-en.png]]

To set up the Two Factor Authentication, go to the User Manager, edit a User and go to the Two Factor Authentication Tab:

[[Image:Joomla-two-factor-authentication-tab-en.png]]

Two authentication methods are available:
===Google Authenticator===
[[wikipedia:Google_Authenticator|Google Authenticator]] is an application for smartphones and desktops created by Google which allows you to generate a six digit security password which changes every 30 seconds. In order to log in to your site, you’ll need to use your username, your password and the six digit security code which changes every thirty seconds.

You can enable Two Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two Factor Authentication – Google Authenticator''.

This provides extra protection against hackers trying to log in to your account. Even if they were able to get hold of your credentials they have a maximum 30s to hack you site. This is usually not practical for hackers. In this way, the two factor authentication prevents your site against unauthorized access.

Setting up the two factor authentication with Google Authenticator is actually really easy.
====Step 1 – Get Google Authenticator====
Download and Install Google Authenticator on your smartphone or desktop.

[[Image:Joomla-Google-Authenticator-download-en.png]]

====Step 2 - Set up====
You can see a QR Code to scan with a mobile phone with the application of google authenticator installed.

[[Image:Joomla-Google-Authenticator-setup-en.png]]

====Step 3 - Activate Two Factor Authentication====
Go to the Activate Two Factor Authenticator field and enter the six digit security code you can see on the screen of your mobile device. Then click on ''Save & Close''.

[[Image:Joomla-Google-Authenticator-activate-en.png]]

Now, your site access is protected by Two Factor Authentication.
Log out from your backend, you’ll see that instead of asking for the username and password only, Joomla! is asking for a secret key. The Secret Key is the six digit password you can see on your Google Authenticator screen.

[[Image:Joomla-Google-Authenticator-login-en.png]]

If you don’t enter the secret code or a random one, you won’t be able to login. This is what will happen to a hacker who tries to access your backend, since they don’t have the correct secret key.

===Yubikey===
This feature allows you to use a Yubikey secure hardware token for two factor authentication. In addition to your username and password you will also need to insert your Yubikey into your computer's USB port, click inside the Secret Key area of the site's login area and touch Yubikey's gold disk. If you have an NFC-equipped Android smartphone you can just approach a compatible Yubikey token (Yubikey Neo) to the NFC reader to copy the secret code to the device's clipboard. The secret code generated by your Yubikey is unique to your device and changes constantly. This provides extra protection against hackers logging in to your account even if they were able to get hold of your password.
IMAGE
You can enable Two Factor Authentication for the Frontend, the Backend or for Both. This can be set up in the plug-in ''Two Factor Authentication – Yubikey''.

[[Image:Joomla-two-factor-authentication-Yubikey-en.png]]

===Contributor===
*Nicholas Dionysopoulos

__NOTOC__

Development Best Practices

2014-06-24T13:50:06Z

Nikosdion: Adding section on Javascript best practices

{{page|needs improvement|It is severely outdated and needs a major revision.}}

== General Development Guidelines ==

* Don't use the DS or DIRECTORY_SEPARATOR constant when including files. It is no longer needed, as pointed out by [http://us2.php.net/manual/en/ref.filesystem.php#73954 Christian on php.net]
* Don't depend on register_globals. This is a HIGH security risk, and the feature has been deprecated in PHP 5.3 and removed in 5.4.
* Don't access the $_GET, $_POST, $_REQUEST, $_FILES and $_SERVER superglobals directly. Use JInput (typically: JFactory::getApplication()->input) instead. JInput filters the input, helping you to easily write more secure software.
* Don't hardcode your SQL queries and do not include unescaped raw data into them. Always use JDatabase / JDatabaseQuery. It's as simple as JFactory::getDbo()->getQuery(true).
* Don't use arbitrary entry points, i.e. .php files which must be accessible outside Joomla!, directly from the web. Typically used to accommodate for payment processors and image resizers, this practice is extremely insecure and strongly discouraged. Use a Joomla! component or a system plugin instead.
* Don't reinvent the wheel. If there's a Joomla! class to do that try using it before you roll your own. Chances are the core class is already good enough and much better tested.

* Do use sensible prefixes for your table names. If your component is called com_foobar it stands to reason that its tables follow the naming pattern #__foobar_something (good) instead of #__fbr_something (bad) or even #__something (really bad).
* Do test your extensions with pre-release versions of Joomla! and/or the "staging" branch of the Git repository. Making sure that users of your extension can update Joomla! safely is your responsibility.
* Do provide documentation for your extensions. Even a short video with less than stellar English is better than nothing.
* Do use JText to translate the output of your extension instead of hardcoding text. The vast majority of Joomla! users are not native English speakers and they will thank you for your consideration.
* Do comment your code. Not just for the people who have to work with it, but also yourself six months from now.
* Do test your code under real usage conditions, with real world data sets. You might be surprised at what you find.

== Where should I place JavaScript, CSS files that belong to my Component? ==
You can see in your root a general media folder to hold all assets.

What this means in real terms is that when in your xml install manifest, if you put files insite a <media> tag instead of a <files> tag then they will be sent to the JPATH_ROOT/media folder. If you give it <media destination="com_foo"> then it will put the files in JPATH_ROOT/media/com_foo

In some cases you have a component, we'll say com_foo, and then you have a few modules that go along with com_foo... for sake of the example we'll call them mod_foo_1, mod_foo_2 and mod_foo_3. There is no reason to package media elements for the three modules if they are all the same and they depend upon the component anyway. The best and most logical way to do things is to put them all in a central place that is namespaced appropriately.

== Where should I place files generated by my Component? ==
It depends on the nature of these files. There are two decisive factors:

* The permanence of the file: temporary, cache or permanent. Temporary files are files which are supposed to be removed immediately after use, before the page load completes. Cache files will be stored on the server for a while, at most until their expiration date. Both temporary and cache files can be deleted without prior warning and your code must anticipate that. Permanent files, on the other hand, are not meant to be removed automatically.
* The disposition of the file: web accessible or web inaccessible. The web accessible files are those which MUST be able to be accessed over the web, e.g. when you type their URL in a web browser. The web inaccessible files are those which NEEDN'T be able to be accessed over the web.

This gives us the following possibilities:
* Temporary, web inaccessible. Use Joomla!'s temp-directory. You can get it by doing JFactory::getConfig()->get('tmp_path'). Hardcoding the path as JPATH_ROOT . '/tmp' is a bad practice and you must not do it.
* Temporary, web accessible. That's not acceptable! Temporary files are by definition inaccessible from the web. Maybe you really meant "cache" instead of "temporary"?
* Cache, web inaccessible. Use the defined Joomla! cache directory. Use the JPATH_CACHE constant to find its location. Please note that the cache directory may be different in the front-end and back-end of your site.
* Cache, web accessible. Use a subdirectory of the media folder. See the section about Javascript and CSS files, it's the same thing.
* Permanent, web inaccessible. Use a folder under your extension's main directory. If you really want the files to be completely inaccessible from the web remember to place a .htaccess file or, better yet, give your users the option to use a directory outside the site's root.
* Permanent, web accessible. Use a subdirectory of the media folder. See the section about Javascript and CSS files, it's the same thing.

This applies to all files handled by your Component, including files your code generates and files the users of your component upload / generate.

Finally, if you want to manage log files you are advised to use the JLog class instead of rolling your own solution.

== Considerations for Javascript ==
When you are using addScriptDeclaration to add inline Javascript in a Joomla! page you have to be very considerate about your code's interaction with other Javascript from other extensions running on the same page. Good practices include:
* Do terminate your Javascript with a semicolon and a newline. If both are missing, your code is the source of Javascript errors as soon as another developer's code uses addScriptDeclaration after your code.
* Do make sure your Javascript code is valid and doesn't throw errors. Errors in your code will render any code after it inoperable.
* Do use try/catch blocks for risky code. If you are unsure if some code is risky just surround it with a try/catch block anyway.
* Do load your inline Javascript in the view template, not the view class (view.html.php file). Most likely it depends on the DOM which will be different when a site integrator uses a template override.

Other good practices concerning Javascript code in your extensions includes:
* Don't modify core Javascript objects including jQuery, mooTools and everything in the Joomla Javascript object. If you want to modify a core object, subclass. If you are not sure, subclass.
* Do not meddle with other developers' code. This includes moving script tags to the bottom of the page or forcibly removing script tags (e.g. removing any script tag whose source URL includes the strong "jq" – you know for whom the bell tolls).

[[Category:Development]]
[[Category:JavaScript]]

Development Best Practices

2014-06-24T13:39:07Z

Nikosdion: Adding to General Development Guidelines

Development Best Practices

2014-06-24T13:22:33Z

Nikosdion: Added section on generated files

Rapid Application Development for CMS Working Group

2013-11-26T07:17:36Z

Nikosdion: /* External resources */

The Rapid Application Development for CMS Working Group is a Production Working Group. It is responsible for maintaining and improving Joomla's Rapid Application Development layer.

==Coordinators & PLT Contact==
The coordinator for this working group is Nicholas Dionysopoulos.

The PLT Contact for this working group is [mailto:roberto.segura@community.joomla.org Roberto Segura].

==Announcements==

==External resources==

* [https://github.com/akeeba/fof Github Repository]
* [https://groups.google.com/forum/#!forum/frameworkonframework Mailing list]

==Deliverables==

==Technical Work produced by this group==

==Communications==

==Roadmap==

[[Category:Documentation Working Group]]
[[Category:Working Groups]]

Creating a profile plugin

2012-07-26T20:48:22Z

Nikosdion: Fixes for Joomla! 2.5+ compatibility; thanks to Christian Hent for the heads up

Profile plugin is a new extension in Joomla! 1.6. It allows the addition of supplemental fields in the registration and profile forms of the com_user front end and in the user create/edit form in the back end.

A simple example plugin with the name '''User - Profile''' is included in the basic Joomla! installation as a proof of concept. Much more complex plugins are possible.

The example plugin takes advantage of on the onContentPrepareForm and onUserAfterSave events.

Multiple profile plugins may be included and will be rendered in sequence.

There are four separate places where profiles forms are used in core extensions, and each of these four can be manipulated separately if that is desired. The two locations in the front end are the user registration form and the user profile edit form. In the back end the locations are the edit screen for users in the user manager and the My Profile view found in the Admin menu.

This page shows an example of a second plugin, named profile5. It adds a single field called something.

This is the file structure

profile5.php
profile5.xml
en-GB.plg_user_profile5.ini
en-GB.plg_user_profile5.sys.ini
/profiles/profile.xml

The supplemental fields are created within the profile.xml file in the profiles folder. Note that this file name is "profile.xml" NOT "profile5.xml", but inside the file the fields and fieldset names ARE "profile5".

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>

<form>
<fields name="profile5">
<fieldset name="profile5"
label="PLG_USER_PROFILE5_SLIDER_LABEL"
>
<field
name="something"
type="text"
id="something"
description="PLG_USER_PROFILE5_FIELD_SOMETHING_DESC"
filter="string"
label="PLG_USER_PROFILE5_FIELD_SOMETHING_LABEL"
message="PLG_USER_PROFILE5_FIELD_SOMETHING_MESSAGE"
size="30"
/>

</fieldset>
</fields>
</form>
</source>

profile5.php

<source lang="PHP">
<?php
/**
* @version
* @copyright Copyright (C) 2005 - 2010 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

defined('JPATH_BASE') or die;

/**
* An example custom profile plugin.
*
* @package Joomla.Plugins
* @subpackage user.profile
* @version 1.6
*/
class plgUserProfile5 extends JPlugin
{
/**
* @param string The context for the data
* @param int The user id
* @param object
* @return boolean
* @since 1.6
*/
function onContentPrepareData($context, $data)
{
// Check we are manipulating a valid form.
if (!in_array($context, array('com_users.profile','com_users.registration','com_users.user','com_admin.profile'))){
return true;
}

$userId = isset($data->id) ? $data->id : 0;

// Load the profile data from the database.
$db = &JFactory::getDbo();
$db->setQuery(
'SELECT profile_key, profile_value FROM #__user_profiles' .
' WHERE user_id = '.(int) $userId .
' AND profile_key LIKE \'profile5.%\'' .
' ORDER BY ordering'
);
$results = $db->loadRowList();

// Check for a database error.
if ($db->getErrorNum()) {
$this->_subject->setError($db->getErrorMsg());
return false;
}

// Merge the profile data.
$data->profile5 = array();
foreach ($results as $v) {
$k = str_replace('profile5.', '', $v[0]);
$data->profile5[$k] = json_decode($v[1], true);
}

return true;
}

/**
* @param JForm The form to be altered.
* @param array The associated data for the form.
* @return boolean
* @since 1.6
*/
function onContentPrepareForm($form, $data)
{
// Load user_profile plugin language
$lang = JFactory::getLanguage();
$lang->load('plg_user_profile5', JPATH_ADMINISTRATOR);

if (!($form instanceof JForm)) {
$this->_subject->setError('JERROR_NOT_A_FORM');
return false;
}
// Check we are manipulating a valid form.
if (!in_array($form->getName(), array('com_users.profile', 'com_users.registration','com_users.user','com_admin.profile'))) {
return true;
}
if ($form->getName()=='com_users.profile')
{
// Add the profile fields to the form.
JForm::addFormPath(dirname(__FILE__).'/profiles');
$form->loadFile('profile', false);

// Toggle whether the something field is required.
if ($this->params->get('profile-require_something', 1) > 0) {
$form->setFieldAttribute('something', 'required', $this->params->get('profile-require_something') == 2, 'profile5');
} else {
$form->removeField('something', 'profile5');
}
}

//In this example, we treat the frontend registration and the back end user create or edit as the same.
elseif ($form->getName()=='com_users.registration' || $form->getName()=='com_users.user' )
{
// Add the registration fields to the form.
JForm::addFormPath(dirname(__FILE__).'/profiles');
$form->loadFile('profile', false);

// Toggle whether the something field is required.
if ($this->params->get('register-require_something', 1) > 0) {
$form->setFieldAttribute('something', 'required', $this->params->get('register-require_something') == 2, 'profile5');
} else {
$form->removeField('something', 'profile5');
}
}
}

function onUserAfterSave($data, $isNew, $result, $error)
{
$userId = JArrayHelper::getValue($data, 'id', 0, 'int');

if ($userId && $result && isset($data['profile5']) && (count($data['profile5'])))
{
try
{
$db = &JFactory::getDbo();
$db->setQuery('DELETE FROM #__user_profiles WHERE user_id = '.$userId.' AND profile_key LIKE \'profile5.%\'');
if (!$db->query()) {
throw new Exception($db->getErrorMsg());
}

$tuples = array();
$order = 1;
foreach ($data['profile5'] as $k => $v) {
$tuples[] = '('.$userId.', '.$db->quote('profile5.'.$k).', '.$db->quote(json_encode($v)).', '.$order++.')';
}

$db->setQuery('INSERT INTO #__user_profiles VALUES '.implode(', ', $tuples));
if (!$db->query()) {
throw new Exception($db->getErrorMsg());
}
}
catch (JException $e) {
$this->_subject->setError($e->getMessage());
return false;
}
}

return true;
}

/**
* Remove all user profile information for the given user ID
*
* Method is called after user data is deleted from the database
*
* @param array $user Holds the user data
* @param boolean $success True if user was succesfully stored in the database
* @param string $msg Message
*/
function onUserAfterDelete($user, $success, $msg)
{
if (!$success) {
return false;
}

$userId = JArrayHelper::getValue($user, 'id', 0, 'int');

if ($userId)
{
try
{
$db = JFactory::getDbo();
$db->setQuery(
'DELETE FROM #__user_profiles WHERE user_id = '.$userId .
" AND profile_key LIKE 'profile5.%'"
);

if (!$db->query()) {
throw new Exception($db->getErrorMsg());
}
}
catch (JException $e)
{
$this->_subject->setError($e->getMessage());
return false;
}
}

return true;
}

}
?>
</source>

Profile5.xml controls whether the field is required, disabled or optional in the forms. Since profile5.php says to treat backend create/edit the same as registration only two sets of options are required, register and profile.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>

<extension version="1.6" type="plugin" group="user">
<name>plg_user_profile5</name>
<author>Joomla! Project</author>
<creationDate>January 2008</creationDate>
<copyright>(C) 2005 - 2010 Open Source Matters. All rights reserved.</copyright>
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
<authorEmail>admin@joomla.org</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>1.6.0</version>
<description>PLG_USER_PROFILE5_XML_DESCRIPTION</description>

<files>
<filename plugin="profile5">profile5.php</filename>
<filename>index.html</filename>
<folder>profiles</folder>
</files>

<languages>
<language tag="en-GB">en-GB.plg_user_profile5.ini</language>
<language tag="en-GB">en-GB.plg_user_profile5.sys.ini</language>
</languages>

<config>
<fields name="params">

<fieldset name="basic">
<field name="register-require-user" type="spacer"
label="PLG_USER_PROFILE5_FIELD_NAME_REGISTER_REQUIRE_USER"
/>

<field name="register-something" type="list"
description="PLG_USER_PROFILE5_FIELD_SOMETHING_DESC"
label="PLG_USER_PROFILE5_FIELD_SOMETHING_LABEL"
>
<option value="2">JOPTION_REQUIRED</option>
<option value="1">JOPTION_OPTIONAL</option>
<option value="0">JDISABLED</option>
</field>

<field name="profile-require-user" type="spacer"
label="PLG_USER_PROFILE5_FIELD_NAME_PROFILE_REQUIRE_USER"
/>

<field name="profile-require_something" type="list"
description="PLG_USER_PROFILE5_FIELD_SOMETHING_DESC"
label="PLG_USER_PROFILE5_FIELD_SOMETHING_LABEL"
>
<option value="2">JOPTION_REQUIRED</option>
<option value="1">JOPTION_OPTIONAL</option>
<option value="0">JDISABLED</option>
</field>

</fieldset>

</fields>
</config>
</extension>
</source>

en-GB.plg_user_profile5.ini

;
; Joomla! Project
; Copyright (C) 2005 - 2010 Open Source Matters. All rights reserved.
; License http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL, see LICENSE.php
; Note : All ini files need to be saved as UTF-8

PLG_USER_PROFILE5_XML_DESCRIPTION="User Profile 5 Plug-in"
PLG_USER_PROFILE5="User - Profile 5"
PLG_USER_PROFILE5_SLIDER_LABEL="User Profile 5"
PLG_USER_PROFILE5_FIELD_NAME_REGISTER_REQUIRE_USER="User profile fields for registration and administrator user profile 5 forms"
PLG_USER_PROFILE5_FIELD_NAME_PROFILE_REQUIRE_USER="User profile fields for profile 5 edit form"
PLG_USER_PROFILE5_FIELD_SOMETHING_DESC="Choose an option for the something filed"
PLG_USER_PROFILE5_FIELD_SOMETHING_LABEL="Something!"
PLG_USER_PROFILE5_FIELD_SOMETHING_MESSAGE="A Message for something!"
PLG_USER_PROFILE5_XML_DESCRIPTION="User Profile 5 Plug-in"

en-GB.plg_user_profile5.sys.ini

; $Id: en-GB.plg_user_profile.sys.ini 17052 2010-05-14 14:05:58Z infograf768 $
; Joomla! Project
; Copyright (C) 2005 - 2010 Open Source Matters. All rights reserved.
; License http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL, see LICENSE.php
; Note : All ini files need to be saved as UTF-8

PLG_USER_PROFILE5="User - Profile 5 "
PLG_USER_PROFILE5_XML_DESCRIPTION="User Profile 5 Plug-in"

By installing profile5 you can add new fields in addition to the ones in profile. You can also control which view levels see those fields.
Alternatively, you can write a more complex common plugin with varying controls for different groups.

[[Category:Tutorials]][[Category:Plugin Development]]

Manifest files

2011-12-07T17:01:17Z

Nikosdion: Added information about language files + the largely undocumented way to present localised installation messages when installing plugins, modules, etc.

{{incomplete}}
{{RightTOC}}
==Introduction==
Within Joomla there are manifest files for all of the extensions. These files include the general installation information as well as parameters for the configuration of the [[extension]] itself. Since Joomla! 1.6 {{JVer|1.6}}, there are very few differences between the manifest file formats for the different [[Extension types (technical definitions)|types of extensions]], allowing each type to access the full power of the Joomla! installer.

==Naming conventions==
The file must be named <tt>manifest.xml</tt> or <tt><extension_name>.xml</tt> and located in the root directory of the installation package.

==Syntax==

=== Root element ===
The primary tag of the installation file is:
<source lang=xml><extension></extension></source>

This starting and closing tags are now valid for all extensions. The new tag <extension> replaces the old <install></install> from Joomla {{JVer|1.5}}. The following attributes are allowed within the tag:

{|class="wikitable"
|-
! style="width: 150px" | Attribute || style="width: 150px" | Values || Applicable to || Description
|-
| type || <code>component</code><br /><code>module</code><br /><code>plugin</code><br /><code>template</code> || All extensions
| This attribute describes the type of the extension for the installer. Based on this type further requirements to sub-tags apply.
|-
| version
| <code>1.6</code> || All extensions
| String that identifies the version of Joomla for which this extension is developed. For Joomla 1.6 a version higher than 1.5 is required.
|-
| method
| <code>new</code><br /><code>upgrade</code> || All extensions
| The default value install will be also used if the method attribute is not used. In these cases the installer will gracefully stop if he finds any existing file/folder of the new extension
|-
| client
| <code>site</code><br /><code>administrator</code> || Modules
| The client allows to specify for which application client the new module is available.
|-
| group
| ''string'' || Plugins
| The group name specifies for which group of plugins the new plugin is available. The existing groups are the folder names within the directory <tt>/plugins</tt>. The installer will create new folder names for group names that do not exist yet.
|}

=== Metadata ===

The following elements can be used to insert metadata. None of these elements are required; if they are present, they must be a child of the root element.

* <code><name></code> – raw component name (e.g. <code>com_banners</code>)
* <code><author></code> – author's name (e.g. <code>Joomla! Project</code>)
* <code><creationDate></code> – date of creation or release (e.g. <code>April 2006</code>)
* <code><copyright></code> – a copyright statement (e.g. <code>(C) 2005 - 2011 Open Source Matters. All rights reserved.</code>)
* <code><license></code> – a license statement (e.g. <code>NU General Public License version 2 or later; see LICENSE.txt</code>)
* <code><authorEmail></code> – author's email address (e.g. <code><nowiki>admin@joomla.org</nowiki></code>)
* <code><authorUrl></code> – URL to the author's website (e.g. <code><nowiki>www.joomla.org</nowiki></code>)
* <code><version><code> – the version number of the extension (e.g. <code>1.6.0</code>)
* <code><description></code> – the description of the component. This is a translatable field. (e.g. <code>COM_BANNERS_XML_DESCRIPTION</code>)

=== Front-end files ===

<source lang="xml">
<files folder="from-folder">
<filename>example.php</filename>
<folder>examples</folder>
</files>
</source>

Files to copy to the front-end directory should be placed in the <code><files></code> element. You can use the optional <code>folder</code> attribute to specify a directory '''in the ZIP package''' to copy '''from'''. Each file to copy must be represented by a <code><filename></code> element. If you want to copy an entire folder at once, you can define it as a <code><folder></code>.

=== Administration section ===

<source lang="xml">
<administration>
</source>

The administration section is defined in the <code><administration></code> element. Since only [[Component|components]] apply to both the [[Site (Application)|site]] and the [[Administrator (Application)|administrator]], '''only component manifests can include this element'''.

==== Back-end files ====

Files to copy to the back-end directory should be placed in the <code><files></code> element under the <code><administration></code>. You can use the optional <code>folder</code> attribute to specify a directory '''in the ZIP package''' to copy '''from'''. See ''Front-end files'' for further rules.

==== Menu links and submenus ====

<source lang="xml">
<menu>COM_EXAMPLE</menu>
<submenu>
<menu link="anoption=avalue">COM_EXAMPLE_SUBMENU_ANOPTION</menu>
<menu view="viewname">COM_EXAMPLE_SUBMENU_VIEWNAME</menu>
</submenu>
</source>

The text for the main menu item for the component is defined in the <code><menu><code> item, a child of <code><administration></code>. A <code><submenu></code> element may also be present (also a child of <code><administration></code>), which may contain more menu items defined by <code><menu></code>.

Additionally, each <code><menu></code> item can define the following attributes:

{| class="wikitable"
! style="width: 150px" | Attribute || Description
|-
| link || A link to send the user to when the menu item is clicked
|-
| img || The (relative) path to an image (16x16 pixels) to appear beside the menu item
|-
| alt ||
|-
| ''string'' || An URL parameter to add to the link. For example, <code><menu view="cpanel">COM_EXAMPLE</menu></code> in com_example's XML manifest would cause the URL of the menu item to be <tt>index.php?option=com_example&view=cpanel</tt>.
|-
|}

The value inside the tag is the menu's label. Unlike Joomla! 1.5, you can not use a natural language string. For example, if you would enter "Example Component" instead of COM_EXAMPLE, it would result in your component name appearing as example-component in the menu and you would be unable to provide a translation. In order to provide a translation you need to create a file named en-GB.com_example.sys.ini in administrator/languages/en-GB (you can use the manifest's <code><languages></code> tag to copy it during installation) or in administrator/components/com_example/language/en-GB. In the latter case, you must not include the translation file in the <code><languages></code> tag. As long as you have placed the language directory in your <code><files></code> tag, it will be copied along when the component is being installed.

The contents of that file should be:
<source>
COM_EXAMPLE="Example Component"
COM_EXAMPLE_SUBMENU_ANOPTION="Another Option"
COM_EXAMPLE_SUBMENU_VIEWNAME="Another View"

</source>

Please note that the language string must be enclosed in double quotes, as per Joomla!'s translation standards. Important note: Joomla! 1.6 and later sorts the Component menu items based on the actual translation of the key you supply in your XML manifest. This means that the sorting order is correct no matter what you call your translation key and no matter which language the site is being displayed in. Essentially, Joomla! 1.6 fixed the wrong sorting of the Components menu for the majority (non-English speaking!) of Joomla! users experienced under Joomla! 1.5.

{{Needsinfo|In Platform 11.1 no alt attribute processed and if link provide in menu tag other provided attributes were ignore. The other tags are task, view, controller, act, layout, sub. Please confirm this, please.}}

=== Configuration ===
{{warning|Components '''do not support''' configuration definitions '''in the manifest'''. This is a way implemented in Joomla! 1.5. They can define configuration options for multiple levels using [[Component configuration metadata]].}}
The <code><config></code> element, a child of the root, describes the configuration options for the extension. If applicable, the options will be shown by the appropriate Manager (Plugin Manager, Module Manager or Template Manager). '''Configuration options can also be defined in a separate file named <code>config.xml</code>. Its root element should be <code><config></code>.'''

{{:XML JForm form definitions}}

=== SQL ===

<source lang="xml">
<install>
<sql>
<file driver="mysql" charset="utf8">example.install.sql</file>
</sql>
</install>
<uninstall>
<sql>
<file driver="mysql" charset="utf8">example.uninstall.sql</file>
</sql>
</uninstall>
</source>

You can execute SQL during installation and/or uninstallation using the <code><install></code> and <code><uninstall></code> elements, respectively. An <code><sql></code> element should appear as a child of these elements. <code><sql></code> can contain any number of <code><file></code> elements, each defining a single SQL file to execute. Their database driver types are described by the <code>driver</code> attribute, their character sets by the <code>charset</code> attribute.

=== Language files ===
Including the language INI files in your extension installation package is not sufficient. You have to tell Joomla! where to find them so that it can install them. This is done by means of up to two <languages> tags. In the case of a component, you need a <languages> tag both under the root tag (<manifest> or <install>) of the XML file (for the front-end translation files) and one inside the
<administration> tag (for the back-end translation files). In both cases, the syntax looks like that:

<source lang="xml">
<languages folder="langfiles">
<language tag="en-GB">en-GB.com_example.ini</language>
</languages>
</source>

The content of the folder attribute of this tag is the relative path of the directory holding the translation files. The path is relative to the your installation package, not the site's root. Each <language> tag '''must''' specify the ISO-code of the language in the tag attribute.

You should not that, by default, the language files are not loaded during installation time unless you use a special convention.

For components, you must place a directory named language inside your component's backend directory and make sure it's being installed, i.e. you have referenced it in your <administration> tag's <files> tag. For other extension types, create a directory named language inside your installation archive's root. In all cases, create one subdirectory per language and put your .sys.ini translation file in there. For example, if you have plg_content_example, create the file language/en-GB/en-GB.plg_content_example.sys.ini and put all installation-time messages' translations in there. This file will be loaded automatically by Joomla! right after all files have been copied and before running your script file and/or displaying the post-installation message (e.g. the extension's description).

=== Script file ===

<source lang="xml">
<scriptfile>example.script.php</scriptfile>
</source>

A '''script file''' (PHP code that is run before, during and/or after installation, uninstallation and upgrading) can be defined using a <code><scriptfile></code> element.

=== Update servers ===

<source lang="xml">
<updateservers>
<server type="extension" priority="1" name="Extension Update Site">http://example.com/extension.xml</server>
<server type="collection" priority="2" name="Collection Update Site">http://example.com/collection.xml</server>
</updateservers>
</source>

Update servers can be defined in the <code><updateservers></code> element, a child of the root. This element may contain one or more <code><server></code> element, each describing a location to fetch updates from. Each <code><server></code> item can define the following attributes:

{| class="wikitable"
! style="width: 150px" | Attribute || style="width: 150px" | Values || Description
|-
| type || <code>extension</code><br /><code>collection</code> || The update server type
|-
| priority || ''integer'' || The priority of the update server
|-
| name || ''string'' || The name of the update server
|}

== Examples ==
For a real-life example, see [http://joomlacode.org/gf/project/joomla/scmsvn/?action=browse&path=%2Fdevelopment%2Ftags%2F1.6.x%2F1.6.5%2Fadministrator%2Fcomponents%2Fcom_banners%2Fbanners.xml&view=markup the manifest of the Banner component in version 1.6.5].

The Joomla testing process uses several extensions to test whether the installer works correctly. The latest versions of the manifests of these extensions are:

* [http://svn.joomla.org/project/cms/development/trunk/tests/_data/installer_packages/com_alpha/alpha.xml com_alpha manifest]
* [http://svn.joomla.org/project/cms/development/trunk/tests/_data/installer_packages/mod_alpha/mod_alpha.xml mod_alpha manifest]
* [http://svn.joomla.org/project/cms/development/trunk/tests/_data/installer_packages/plg_system_alpha/alpha.xml plg_system_alpha manifest]
* [http://svn.joomla.org/project/cms/development/trunk/tests/_data/installer_packages/tpl_simple/templateDetails.xml tpl_simple manifest]
* [http://svn.joomla.org/project/cms/development/trunk/tests/_data/installer_packages/lng_xx-XX/xx-XX.xml lng_xx-XX manifest]

== Contributors ==
*[[User:akede|Alex Kempkens]]
*[[User:dperaza|Daniel Peraza]]
*[[User:nikosdion|Nicholas K. Dionysopoulos]]
*[[User:mrs.siam|Prasit Gebsaap]]

[[Category:Extension development]]
[[Category:Specifications]]

Making single installation packages for Joomla! 1.5 and 2.5 series

2011-09-10T20:30:12Z

Nikosdion: Adding more info on menu item creation

{{review}}

It is possible to create a single installation package which can install a component in Joomla! 1.5, 1.6 and 1.7 with minor changes. Below you will find some of the most common tricks required to create an extension which is compatible with all current versions of the Joomla! CMS.

== Dealing with API changes ==
You will regularly bump into cases where an API has changed between Joomla! 1.5, 1.6 and 1.7. In order to cater for them, you need to run slightly different code based on the Joomla! version. Right now it's possible to do that by writing conditional statements like this:

<source lang="php">
if(version_compare(JVERSION,'1.7.0','ge')) {
// Joomla! 1.7 code here
} elseif(version_compare(JVERSION,'1.6.0','ge')) {
// Joomla! 1.6 code here
} else {
// Joomla! 1.5 code here
}
</source>

If you do not have Joomla! 1.7-specific code -i.e it is the same as the Joomla! 1.6-specific code- please use the following code:

<source lang="php">
if(version_compare(JVERSION,'1.6.0','ge')) {
// Joomla! 1.6 code here
} else {
// Joomla! 1.5 code here
}
</source>

While this conditional statement looks like an overkill, it has two major advantages:
* Compatibility with all Joomla! versions using the same package, therefore using the same codebase, ergo less maintenance overhead
* Once, let's say, Joomla! 1.8 is released and you decide to drop support for earlier Joomla! releases, we can just search your code for "if(version_compare(JVERSION," and remove all of the legacy code.

== One XML configuration file, multiple Joomla! versions ==

Various XML files in Joomla! accept settings, or parameters. For example your extension manifest file, the config.xml file and the view XML files all accept such settings. You may have noticed that whereas in Joomla! 1.5 these were found under the <params> tags, in Joomla! 1.6 and later they are found inside <filedsets>. One hidden secret of Joomla! is that Joomla! 1.5 will ignore Joomla! 1.6 syntax, whereas Joomla! 1.6/1.7 will ignore Joomla! 1.5 syntax. This allows you to have a single XML file which caters for all Joomla! releases. For example, here's a sample config.xml file, to be placed in the component's backend directory:

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<config>

<params>
<param name="foobar" type="text" default="" size="30"
label="COM_FOOBAR_OPTION_FOOBAR_LBL"
description ="COM_FOOBAR_OPTION_FOOBAR_DESC" />
</params>


<fieldset
name="basic"
label="COM_FOOBAR_OPTIONS_SECTION_BASIC_LBL"
description="COM_FOOBAR_OPTIONS_SECTION_BASIC_DESC"
>
<field name="foobar" type="text" default="" size="30"
label="COM_FOOBAR_OPTION_FOOBAR_LBL"
description ="COM_FOOBAR_OPTION_FOOBAR_DESC" />
</fieldset>
</config>
</source>

That's how easy it is!

== Dealing with languages ==

=== How to load component-local translation files in Joomla! 1.5 ===

Joomla! 1.6 introduced a new feature where a user can place language files inside the component's directory, e.g. administrator/com_foobar/language/en-GB/en-GB.com_foobar.ini, in order to provide language overrides. But Joomla! 1.5 doesn't support this feature. Or does it? Even though it can not do that automatically, you can do so in your extension's dispatcher file, e.g. administrator/com_foobar/foobar.php. Here's the magic code to do that in the backend:
<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_ADMINISTRATOR, null, true);
$jlang->load('com_foobar', JPATH_COMPONENT_ADMINISTRATOR, null, true);
</source>
and the frontend:
<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_SITE, null, true);
$jlang->load('com_foobar', JPATH_COMPONENT, null, true);
</source>

=== Tips and tricks for language strings ===

All your translation keys should consist of uppercase characters without spaces (that is A-Z, 0-9 and underscores). All translation values should be included in double quotation marks. This allows the translation files to be parsed by Joomla! 1.5/1.6/1.7 alike. You are also suggested to prefix your translation keys with the extension's name, albeit this is not required. For example, this is a good translation string:
COM_FOOBAR_CPANEL_TITLE="Foobar Control Panel"
whereas this is a '''bad''' translation string:
CONTROL PANEL=Foobar Control Panel
The former works with all current versions of Joomla!, the latter doesn't.

If you have double quotation marks in your translation values, please replace them with single quotation marks. While Joomla! 1.5 allowed escaping the double quotation marks with \", Joomla! 1.6 under newer versions of PHP don't and require you to escape them as "__QQ__" which throws off Joomla! 1.5's parser. The workaround is to take advantage of a little known fact about HTML, that attributes can be wrapped in single quotation marks. For instance, change this:
COM_FOOBAR_SOME_KEY=<a href="http://www.example.com">Just a test</a>
to this:
COM_FOOBAR_SOME_KEY="<a href='http://www.example.com'>Just a test</a>"
It is valid HTML, it works on Joomla! 1.5/1.6/1.7 but it will invalidates XHTML. You can't always win, sorry.

=== Making untranslated strings look more beautiful ===

The problem with using tight translation keys as we described is that untranslated strings now look something like COM_FOOBAR_VIEWNAME_SOMEKEY. If you have volunteer translators you can bet your head that most translations will not be in sync with your component and you will have untranslated strings. In Joomla! 1.5, using "natural language" keys, you got to show your users the default (English) text if a translation key didn't exist in their language. This is impossible in Joomla! 1.6... or maybe not?

We can use the same little trick in our component's dispatcher as with our component-local translation loading string above. Here's how to load the English translation file in the backend of your component, then overwrite only the keys which exist with the user's selected language, essentially allowing untranslated keys to show in English:

<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_ADMINISTRATOR, 'en-GB', true);
$jlang->load('com_foobar', JPATH_ADMINISTRATOR, null, true);
</source>

The same thing in the front-end:

<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_SITE, 'en-GB', true);
$jlang->load('com_foobar', JPATH_SITE, null, true);
</source>

== JElement vs JFormField ==

Oh, the struggle! You need a custom widget in the configuration section of your component. In Joomla! 1.5 you could just create a new JElement. In Joomla! 1.6 you could just create a new JFormField. But both? In a single file? You can employ a simple trick. In the following example I am going to create a rather lame element, called SQL2, which displays a multi-selection box out of the results of a SQL statement. This is made as part of a fictitious module called mod_foobar

First, let your configuration know where to load the custom widget files from, by putting this in your module's XML manifest file:

<source lang="xml">
<params addpath="/modules/mod_foobar/elements">
<param name="ids" type="sql2" default=""
label="MOD_FOOBAR_LEVELS_TITLE"
description="MOD_FOOBAR_LEVELS_DESC"
query="SELECT `foobar_level_id`, `title` FROM `#__foobar_levels`"
key_field="foobar_level_id"
value_field="title" />
</params>

<config addfieldpath="/modules/mod_foobar/elements">
<fields name="params">
<fieldset name="basic">
<field name="ids" type="sql2" default=""
label="MOD_FOOBAR_LEVELS_TITLE"
description="MOD_FOOBAR_LEVELS_DESC"
query="SELECT `foobar_level_id`, `title` FROM `#__foobar_levels`"
key_field="foobar_level_id"
value_field="title" />
</fieldset>
</fields>
</config>
</source>

As you see, we instruct both Joomla! 1.5 and 1.6/1.7 to look into the same directory, for the same-named file (sql2.php). Here are the contents of the modules/mod_foobar/elements/sql2.php file:

<source lang="php">
defined('_JEXEC') or die('Restricted Access');

/*
* This trick allows us to extend the correct class, based on whether it's Joomla! 1.5 or 1.6
*/
if(!class_exists('JFakeElementBase')) {
if(version_compare(JVERSION,'1.6.0','ge')) {
class JFakeElementBase extends JFormField {
// This line is required to keep Joomla! 1.6/1.7 from complaining
public function getInput() {}
}
} else {
class JFakeElementBase extends JElement {}
}
}

/**
* Our main element class, creating a multi-select list out of an SQL statement
*/
class JFakeElementSQL2 extends JFakeElementBase
{
var $_name = 'SQL2';

// Joomla! 1.5
function fetchElement($name, $value, &$node, $control_name)
{
$db = & JFactory::getDBO();
$db->setQuery($node->attributes('query'));
$key = ($node->attributes('key_field') ? $node->attributes('key_field') : 'value');
$val = ($node->attributes('value_field') ? $node->attributes('value_field') : $name);
return JHTML::_('select.genericlist', $db->loadObjectList(), ''.$control_name.'['.$name.'][]', 'class="inputbox" multiple="multiple" size="5"', $key, $val, $value, $control_name.$name);
}

// Joomla! 1.6
function getInput()
{
$db = & JFactory::getDBO();
$db->setQuery($this->element['query']);
$key = ($this->element['key_field'] ? $this->element['key_field'] : 'value');
$val = ($this->element['value_field'] ? $this->element['value_field'] : $this->name);
return JHTML::_('select.genericlist', $db->loadObjectList(), $this->name, 'class="inputbox" multiple="multiple" size="5"', $key, $val, $this->value, $this->id);
}
}

/*
* Part two of our trick; we define the proper element name, depending on whether it's Joomla! 1.5 or 1.6
*/
if(version_compare(JVERSION,'1.6.0','ge')) {
class JFormFieldSQL2 extends JFakeElementSQL2 {}
} else {
class JElementSQL2 extends JFakeElementSQL2 {}
}
</source>

Considering that most custom widgets have a lot more code than this, you can create two different initialisation sections for Joomla! 1.5 and 1.6/1.7 (fetchElement and getInput), populate class variables, then call a big, common method to render the bulk of the widget (just like we did with JHTML's genericlist in the example above). This will eliminate the need to rewrite the same code over again just to cater for a new Joomla! version.

== Content plugins work slightly different ==

The content plugins in Joomla! 1.5 were using the onPrepareContent method, whereas the content plugins in Joomla! 1.6/1.7 use the onContentPrepare method. The arguments have also changed. You can, however, create a single content plugin which runs on both Joomla! versions without rewriting code. Here's how:

<source lang="php">
defined('_JEXEC') or die();

jimport('joomla.plugin.plugin');

class plgContentFoobar extends JPlugin
{
public function onPrepareContent( &$article, &$params, $limitstart = 0 )
{
$article->text = $this->doSomethingWith($article->text);
}

public function onContentPrepare($context, &$row, &$params, $page = 0)
{
// Danger, Will Robinson! $row in Joomla! 1.6/1.7 may be a string, not an article object!
if(is_object($row)) {
return $this->onPrepareContent($row, $params, $page);
} else {
$row = $this->doSomethingWith($row);
}

return true;
}

private function doSomethingWith($text)
{
// Apparently, you have to do something here ;)
return $text;
}
}
</source>

== Updating doesn't work as you'd expect ==

There is a small but very disturbing bug in Joomla! 1.6. Updating a component whose manifest XML states version="1.5.0" doesn't allow you to run the SQL statements. Namely, the SQL files you specify under the "<install><sql>" tags won't run. You can neither use the new "<update>" tag. You are stuck with no way to run SQL commands on component update!

The ugly workaround is to create a file named script.foobar.php with the following contents:

<source lang="php">
<?php
define('_JEXEC') or die();

class Com_FoobarInstallerScript {

function update($parent) {
$db = JFactory::getDBO();
// Obviously you may have to change the path and name if your installation SQL file ;)
if(method_exists($parent, 'extension_root')) {
$sqlfile = $parent->getPath('extension_root').DS.'install.sql';
} else {
$sqlfile = $parent->getParent()->getPath('extension_root').DS.'install.sql';
}
// Don't modify below this line
$buffer = file_get_contents($sqlfile);
if ($buffer !== false) {
jimport('joomla.installer.helper');
$queries = JInstallerHelper::splitSql($buffer);
if (count($queries) != 0) {
foreach ($queries as $query)
{
$query = trim($query);
if ($query != '' && $query{0} != '#') {
$db->setQuery($query);
if (!$db->query()) {
JError::raiseWarning(1, JText::sprintf('JLIB_INSTALLER_ERROR_SQL_ERROR', $db->stderr(true)));
return false;
}
}
}
}
}
}
</source>

Reference that file in the end of your manifest XML file, just above the closing install tag, with:
<source type="xml">
<scriptfile>script.foobar.php</scriptfile>
</source>

This will force Joomla! 1.6 to run your extension's installation SQL file during the component update, just like Joomla! 1.5 used to do. Enjoy!

== Menu item creation tricks ==

===For Joomla! 1.5===

You have to add a line similar to the following in your component's manifest XML file, inside the <code><administration><code> tag.

<source lang="xml">
<menu view="yourview" img="../media/com_example/logo-16.png">COM_EXAMPLE</menu>
</source>
or
<source lang="xml">
<menu view="yourview" img="../media/com_example/logo-16.png">Example Component</menu>
</source>

In both cases, you need to create a file named en-GB.com_example.menu.ini in administrator/languages/en-GB (you can use the manifest's <code><languages></code> tag to copy it during installation). In the first case (using a translation key), its contents should be:
<source>
COM_EXAMPLE=Example Component
</source>
In the second case (using natural language strings) its contents should be
<source>
Example Component=Example Component
</source>

NB: Joomla! 1.5 sorts the Component menu items based on the key you supply in your XML manifest. If you use the COM_EXAMPLE approach, your component will be sorted with all the components beginning with "C", e.g. just before Contacts on a fresh Joomla! 1.5 installation, no matter what the translation is! This leads to funny results, especially with non-English languages where the translated component names do not follow the same sorting order as their English names. If you are bilingual or multilingual, I think you know what I mean…

===For Joomla! 1.6 and later versions===

You have to add a line similar to the following in your component's manifest XML file, inside the <code><administration></code> tag.
<source lang="xml">
<menu view="yourview" img="../media/com_example/logo-16.png">COM_EXAMPLE</menu>
</source>

You can not use a natural language string. Doing so will result in your component name appearing as example-component in the menu and you will be unable to provide a translation.

You need to create a file named en-GB.com_example.sys.ini in administrator/languages/en-GB (you can use the manifest's <code><languages></code> tag to copy it during installation) or in administrator/components/com_example/language/en-GB. In the latter case, you must not include the translation file in the <code><languages></code> tag. As long as you have placed the language directory in your <code><files></code> tag, it will be copied along when the component is being installed.

The contents of that file should be:
<source>
COM_EXAMPLE="Example Component"
</source>

Please note that the language string must be enclosed in double quotes, as per Joomla!'s translation standards.

NB: Joomla! 1.6 and later sorts the Component menu items based on the actual translation of the key you supply in your XML manifest. This means that the sorting order is correct no matter what you call your translation key and no matter which language the site is being displayed in. Essentially, Joomla! 1.6 fixed the wrong sorting of the Components menu for the majority (non-English speaking!) of Joomla! users.

===How to have a cross-version (Joomla! 1.5, 1.6 and later) component===

If your component is supposed to be installed under both Joomla! 1.5 and Joomla! 1.6/1.7/2.5, you can do a little trick. You have to add a line similar to the following in your component's manifest XML file, inside the <code><administration></code> tag.
<source lang="xml">
<menu view="yourview" img="../media/com_example/logo-16.png">COM_EXAMPLE</menu>
</source>

Now, you need to create two files, one for Joomla! 1.5 and one for Joomla! 1.6. For Joomla! 1.5 you need to create a file named en-GB.com_example.menu.ini in administrator/languages/en-GB (you can use the manifest's <code><languages></code> tag to copy it during installation). Its contents should be:
<source>
COM_EXAMPLE=Example Component
</source>
For Joomla! 1.6 you need to create a file named en-GB.com_example.sys.ini in administrator/languages/en-GB (you can use the manifest's <code><languages></code> tag to copy it during installation) or in administrator/components/com_example/language/en-GB. In the latter case, you must not include the translation file in the <code><languages></code> tag. As long as you have placed the language directory in your <code><files></code> tag, it will be copied along when the component is being installed.

The contents of that file should be:
<source>
COM_EXAMPLE="Example Component"
</source>

The only drawback is that your component will appear as weirdly sorted in the Components menu of Joomla! 1.5. Given the very near expiration date of Joomla! 1.5 (April 2012) this is not a major drawback and experience shows that users don't really care that much.

===What if you do that and nothing happens?===

Joomla! is supposed to create the components menu entries afresh every time you re-install the component. If this doesn't happen in your case, try uninstalling and re-installing your component. If you're not sure if Joomla! has the correct Components menu item translation key, you can always check the menu items database table. This will prevent you from unnecessary frustration when your translation files don't work simply because Joomla! has the wrong translation key in the table.

== More tricks? ==

I am sure that by writing this page I have left out a number of tricks which I am already using in my software. If you get stuck somewhere, feel free to take a look at how I've implemented things in Admin Tools Core, Akeeba Backup Core and Akeeba Release System, my Joomla! 1.5/1.6/1.7 compatible extensions. If you find a better way to implement something, or found a trick not listed here, feel free to edit this wiki page. Sharing the knowledge is caring!

Peace, love and friendship,

Nicholas K. Dionysopoulos, AkeebaBackup.com Lead Developer

Manifest files

2011-09-10T20:23:14Z

Nikosdion: Improved the menu item creation with further information

{{incomplete}}
{{inuse}}
{{RightTOC}}
==Introduction==
Within Joomla there are manifest files for all of the extensions. These files include the general installation information as well as parameters for the configuration of the [[extension]] itself. Since Joomla! 1.6 {{JVer|1.6}}, there are very few differences between the manifest file formats for the different [[Extension types (technical definitions)|types of extensions]], allowing each type to access the full power of the Joomla! installer.

==Naming conventions==
The file must be named <tt>manifest.xml</tt> or <tt><extension_name>.xml</tt> and located in the root directory of the installation package.

==Syntax==

=== Root element ===
The primary tag of the installation file is:
<source lang=xml><extension></extension></source>

This starting and closing tags are now valid for all extensions. The new tag <extension> replaces the old <install></install> from Joomla {{JVer|1.5}}. The following attributes are allowed within the tag:

{|class="wikitable"
|-
! style="width: 150px" | Attribute || style="width: 150px" | Values || Applicable to || Description
|-
| type || <code>component</code><br /><code>module</code><br /><code>plugin</code><br /><code>template</code> || All extensions
| This attribute describes the type of the extension for the installer. Based on this type further requirements to sub-tags apply.
|-
| version
| <code>1.6</code> || All extensions
| String that identifies the version of Joomla for which this extension is developed. For Joomla 1.6 a version higher than 1.5 is required.
|-
| method
| <code>new</code><br /><code>upgrade</code> || All extensions
| The default value install will be also used if the method attribute is not used. In these cases the installer will gracefully stop if he finds any existing file/folder of the new extension
|-
| client
| <code>site</code><br /><code>administrator</code> || Modules
| The client allows to specify for which application client the new module is available.
|-
| group
| ''string'' || Plugins
| The group name specifies for which group of plugins the new plugin is available. The existing groups are the folder names within the directory <tt>/plugins</tt>. The installer will create new folder names for group names that do not exist yet.
|}

=== Metadata ===

The following elements can be used to insert metadata. None of these elements are required; if they are present, they must be a child of the root element.

* <code><name></code> – raw component name (e.g. <code>com_banners</code>)
* <code><author></code> – author's name (e.g. <code>Joomla! Project</code>)
* <code><creationDate></code> – date of creation or release (e.g. <code>April 2006</code>)
* <code><copyright></code> – a copyright statement (e.g. <code>(C) 2005 - 2011 Open Source Matters. All rights reserved.</code>)
* <code><license></code> – a license statement (e.g. <code>NU General Public License version 2 or later; see LICENSE.txt</code>)
* <code><authorEmail></code> – author's email address (e.g. <code><nowiki>admin@joomla.org</nowiki></code>)
* <code><authorUrl></code> – URL to the author's website (e.g. <code><nowiki>www.joomla.org</nowiki></code>)
* <code><version><code> – the version number of the extension (e.g. <code>1.6.0</code>)
* <code><description></code> – the description of the component. This is a translatable field. (e.g. <code>COM_BANNERS_XML_DESCRIPTION</code>)

=== Front-end files ===

<source lang="xml">
<files folder="from-folder">
<filename>example.php</filename>
<folder>examples</folder>
</files>
</source>

Files to copy to the front-end directory should be placed in the <code><files></code> element. You can use the optional <code>folder</code> attribute to specify a directory '''in the ZIP package''' to copy '''from'''. Each file to copy must be represented by a <code><filename></code> element. If you want to copy an entire folder at once, you can define it as a <code><folder></code>.

=== Administration section ===

<source lang="xml">
<administration>
</source>

The administration section is defined in the <code><administration></code> element. Since only [[Component|components]] apply to both the [[Site (Application)|site]] and the [[Administrator (Application)|administrator]], '''only component manifests can include this element'''.

==== Back-end files ====

Files to copy to the back-end directory should be placed in the <code><files></code> element under the <code><administration></code>. You can use the optional <code>folder</code> attribute to specify a directory '''in the ZIP package''' to copy '''from'''. See ''Front-end files'' for further rules.

==== Menu links and submenus ====

<source lang="xml">
<menu>COM_EXAMPLE</menu>
<submenu>
<menu link="anoption=avalue">COM_EXAMPLE_ANOPTION</menu>
</submenu>
</source>

The text for the main menu item for the component is defined in the <code><menu><code> item, a child of <code><administration></code>. A <code><submenu></code> element may also be present (also a child of <code><administration></code>), which may contain more menu items defined by <code><menu></code>.

Additionally, each <code><menu></code> item can define the following attributes:

{| class="wikitable"
! style="width: 150px" | Attribute || Description
|-
| link || A link to send the user to when the menu item is clicked
|-
| view || (optional) The name of the view to load. E.g. <code><menu view="cpanel">COM_EXAMPLE</menu></code> in com_example's XML manifest would cause the URL of the menu item to be index.php?option=com_example&view=cpanel
|-
| img || The (relative) path to an image (16x16 pixels) to appear beside the menu item
|-
| alt ||
|}

The value inside the tag is the menu's label. Unlike Joomla! 1.5, you can not use a natural language string. For example, if you would enter "Example Component" instead of COM_EXAMPLE, it would result in your component name appearing as example-component in the menu and you would be unable to provide a translation. In order to provide a translation you need to create a file named en-GB.com_example.sys.ini in administrator/languages/en-GB (you can use the manifest's <code><languages></code> tag to copy it during installation) or in administrator/components/com_example/language/en-GB. In the latter case, you must not include the translation file in the <code><languages></code> tag. As long as you have placed the language directory in your <code><files></code> tag, it will be copied along when the component is being installed.

The contents of that file should be:
<source>
COM_EXAMPLE="Example Component"
COM_EXAMPLE_ANOPTION="Another Option"
</source>

Please note that the language string must be enclosed in double quotes, as per Joomla!'s translation standards. Important note: Joomla! 1.6 and later sorts the Component menu items based on the actual translation of the key you supply in your XML manifest. This means that the sorting order is correct no matter what you call your translation key and no matter which language the site is being displayed in. Essentially, Joomla! 1.6 fixed the wrong sorting of the Components menu for the majority (non-English speaking!) of Joomla! users experienced under Joomla! 1.5.

{{Needsinfo|what does alt do?}}

=== Configuration ===
The <code><config></code> element, a child of the root, describes the configuration options for the extension. If applicable, the options will be shown by the appropriate Manager (Plugin Manager, Module Manager or Template Manager). '''Configuration options can also be defined in a separate file named <code>config.xml</code>. Its root element should be <code><config></code>.'''

{{:XML JForm form definitions}}

=== SQL ===

<source lang="xml">
<install>
<sql>
<file driver="mysql" charset="utf8">example.install.sql</file>
</sql>
</install>
<uninstall>
<sql>
<file driver="mysql" charset="utf8">example.uninstall.sql</file>
</sql>
</uninstall>
</source>

You can execute SQL during installation and/or uninstallation using the <code><install></code> and <code><uninstall></code> elements, respectively. An <code><sql></code> element should appear as a child of these elements. <code><sql></code> can contain any number of <code><file></code> elements, each defining a single SQL file to execute. Their database driver types are described by the <code>driver</code> attribute, their character sets by the <code>charset</code> attribute.

=== Script file ===

<source lang="xml">
<scriptfile>example.script.php</scriptfile>
</source>

A '''script file''' (PHP code that is run before, during and/or after installation, uninstallation and upgrading) can be defined using a <code><scriptfile></code> element.

=== Update servers ===

<source lang="xml">
<updateservers>
<server type="extension" priority="1" name="Extension Update Site">http://example.com/extension.xml</server>
<server type="collection" priority="2" name="Collection Update Site">http://example.com/collection.xml</server>
</updateservers>
</source>

Update servers can be defined in the <code><updateservers></code> element, a child of the root. This element may contain one or more <code><server></code> element, each describing a location to fetch updates from. Each <code><server></code> item can define the following attributes:

{| class="wikitable"
! style="width: 150px" | Attribute || style="width: 150px" | Values || Description
|-
| type || <code>extension</code><br /><code>collection</code> || The update server type
|-
| priority || ''integer'' || The priority of the update server
|-
| name || ''string'' || The name of the update server
|}

== Examples ==
For a real-life example, see [http://joomlacode.org/gf/project/joomla/scmsvn/?action=browse&path=%2Fdevelopment%2Ftags%2F1.6.x%2F1.6.5%2Fadministrator%2Fcomponents%2Fcom_banners%2Fbanners.xml&view=markup the manifest of the Banner component in version 1.6.5].

The Joomla testing process uses several extensions to test whether the installer works correctly. The latest versions of the manifests of these extensions are:

* [http://svn.joomla.org/project/cms/development/trunk/tests/_data/installer_packages/com_alpha/alpha.xml com_alpha manifest]
* [http://svn.joomla.org/project/cms/development/trunk/tests/_data/installer_packages/mod_alpha/mod_alpha.xml mod_alpha manifest]
* [http://svn.joomla.org/project/cms/development/trunk/tests/_data/installer_packages/plg_system_alpha/alpha.xml plg_system_alpha manifest]
* [http://svn.joomla.org/project/cms/development/trunk/tests/_data/installer_packages/tpl_simple/templateDetails.xml tpl_simple manifest]
* [http://svn.joomla.org/project/cms/development/trunk/tests/_data/installer_packages/lng_xx-XX/xx-XX.xml lng_xx-XX manifest]

== Contributors ==
*[[User:akede|Alex Kempkens]]
*[[User:dperaza|Daniel Peraza]]
*[[User:nikosdion|Nicholas K. Dionysopoulos]]

[[Category:Extension development]]
[[Category:Specifications]]

Local Joomla Communities

2011-07-30T11:04:33Z

Nikosdion: /* Greek */

Joomla is an international project with many users worldwide. The main language of the Joomla.org family websites is English. In the past years many groups of Joomla users created their own local Joomla community with Joomla information in their native language.

Help me to build a list of all local/country/area Joomla communities per language by adding new local communities or completing information so we create a nice overview.

Please use format: <code><nowiki>Website Name [http://www.websitename.com] (Target country/area)</nowiki></code>

Thanks, [http://twitter.com/sanderpotjer Sander Potjer]

=Danish=
joomla.dk [http://www.joomla.dk] (Danmark)

=Dutch=

DutchJoomla.org [http://www.dutchjoomla.org] (The Netherlands/Belgium)

JoomlaCommunity.eu [http://www.joomlacommunity.eu] (The Netherlands/Belgium)

=English=
Australian Joomla User Groups [http://www.joomla.org.au] (Australia)
=Estonian=
Joomla! Eesti kasutajaskond [http://www.eraser.ee] (Estonia)
=French=
joomla.fr [http://www.joomla.fr] (France)

=German=
joomla.at [http://www.joomla.at] (Austria)

joomla.de [http://www.joomla.de] (Germany)

joomla.ch [http://www.joomla.ch] (Switzerland)

=Greek=
MyJoomla.gr [http://www.myjoomla.gr] (Greece, Athens)

Joomla! Fans.gr [http://www.joomlafans.gr/] (Greece, Thessaloniki)

=Hebrew=
joomla.org.il [http://www.joomla.org.il] (Israel)

=Hungarian=
joomla.org.hu [http://www.joomla.org.hu] (Hungary)

=Italian=

joomla.it [http://www.joomla.it] (Italy)

=Japanese=

joomla.jp [http://www.joomla.jp] (Japan)

=Portuguese=
joomlapt.com [http://www.joomlapt.com] (Portugal)

=Spanish=

joomlaspanish.org [http://www.joomlaspanish.org] (?)

=Turkish=
Joomla! Türkiye [http://www.joomlatr.org] (Turkey)

Local Joomla Communities

2011-07-30T11:04:11Z

Nikosdion: /* Greek */

Joomla is an international project with many users worldwide. The main language of the Joomla.org family websites is English. In the past years many groups of Joomla users created their own local Joomla community with Joomla information in their native language.

Help me to build a list of all local/country/area Joomla communities per language by adding new local communities or completing information so we create a nice overview.

Please use format: <code><nowiki>Website Name [http://www.websitename.com] (Target country/area)</nowiki></code>

Thanks, [http://twitter.com/sanderpotjer Sander Potjer]

=Danish=
joomla.dk [http://www.joomla.dk] (Danmark)

=Dutch=

DutchJoomla.org [http://www.dutchjoomla.org] (The Netherlands/Belgium)

JoomlaCommunity.eu [http://www.joomlacommunity.eu] (The Netherlands/Belgium)

=English=
Australian Joomla User Groups [http://www.joomla.org.au] (Australia)
=Estonian=
Joomla! Eesti kasutajaskond [http://www.eraser.ee] (Estonia)
=French=
joomla.fr [http://www.joomla.fr] (France)

=German=
joomla.at [http://www.joomla.at] (Austria)

joomla.de [http://www.joomla.de] (Germany)

joomla.ch [http://www.joomla.ch] (Switzerland)

=Greek=
MyJoomla.gr [http://www.myjoomla.gr] (Greece, Athens)
Joomla! Fans.gr [http://www.joomlafans.gr/] (Greece, Thessaloniki)

=Hebrew=
joomla.org.il [http://www.joomla.org.il] (Israel)

=Hungarian=
joomla.org.hu [http://www.joomla.org.hu] (Hungary)

=Italian=

joomla.it [http://www.joomla.it] (Italy)

=Japanese=

joomla.jp [http://www.joomla.jp] (Japan)

=Portuguese=
joomlapt.com [http://www.joomlapt.com] (Portugal)

=Spanish=

joomlaspanish.org [http://www.joomlaspanish.org] (?)

=Turkish=
Joomla! Türkiye [http://www.joomlatr.org] (Turkey)

Extension Installer/Installer Hooks

2011-07-19T09:50:42Z

Nikosdion: Updated with information shared by Sam Moffat on the developer's mailing list

Some extension installers offer installer hooks for the installing application, such as the component installer. This system replaces the older 'com_install' and 'com_uninstall' methods that used to exist instead using an object to contain this information.

The class name of the item should be the element name followed by "InstallerScript". So for "com_alpha" the class name would be "com_alphaInstallerScript". The hooks, in order of execution, are:
* preflight
* install
* uninstall
* update
* discover_install
* postflight

Install and uninstall are analogous to to the old "com_install" and "com_uninstall" functions. Update is a new function handled for update situations and "discover_install" is a special version of install that is used when the extension is 'discovered'. Finally preflight and postflight accepts a param display what sort of operation we're doing (one of the above options: install, uninstall, update, discover_install) and is triggered before different operations take place.

You can find practical examples on using the installation script files and hooks inside the tests/_data/installer_packages directory of Joomla!'s SVN repository. It's advisable to study com_alpha and try to install it on a Joomla! 1.6/1.7 install to literally see the execution order of these hooks. Other components, like com_beta, showcase other use cases of the installer scripts. For instance, com_beta shows you how to abort the extension installation.

== The preflight hook ==

Effectively preflight runs as soon as possible after we've got the manifest file, worked out if we need to switch into an update mode from the install (e.g. if the extension is installed then the system transparently swaps into the update mode out of install so that the installation hooks work properly) and has worked out where the script file is and loaded it. At this point you could conceivably prevent the installation by calling the abort mechanism from the parent or prepare anything ahead of the file copy and database changes occurring. It is one of the new hooks in 1.6 to let you get your own code in as close to the installer process kicking off as the developers felt safe. You're also handed a copy of the installer object (from memory) and a param to say if the preflight is for install or update so that if there is a difference you can handle that.

== The install/update/discover_install/uninstall hooks ==

The install/update hooks run effectively where com_install ran which was after the files have been copied (except the manifest) and the database has been updated (except for the #__extensions or equivalent entry).

The install hook runs only when a component is being installed, i.e. it wasn't already installed. The update hook runs when the component is being updated, i.e. when it was already installed. The discover_install run when a component has all of its files copied manually and the user is using the Discover feature of extensions manager to install it, i.e. let Joomla! update its database so that it "knows" about this components. Naturally, the uninstall hook runs when the extension is being uninstalled.

== The postflight hook ==

Postflight, at least for components, runs after the #__extensions entry has been made/updated (install/update) and that the manifest file has been copied. At this point there should be no reason for the extension to fail. For those extensions utilising a redirect that broke with the shift from 1.5 to 1.6, where 1.5 com_installer doesn't do a redirect after install and now 1.6 com_installer does, you can instruct the installer in postflight to redirect to a custom extension installation screen from a component (see com_alpha's scriptfile for an example of this).

Making single installation packages for Joomla! 1.5 and 2.5 series

2011-07-17T09:26:05Z

Nikosdion: Finished writing this huge page!

{{review}}

It is possible to create a single installation package which can install a component in Joomla! 1.5, 1.6 and 1.7 with minor changes. Below you will find some of the most common tricks required to create an extension which is compatible with all current versions of the Joomla! CMS.

== Dealing with API changes ==
You will regularly bump into cases where an API has changed between Joomla! 1.5, 1.6 and 1.7. In order to cater for them, you need to run slightly different code based on the Joomla! version. Right now it's possible to do that by writing conditional statements like this:

<source lang="php">
if(version_compare(JVERSION,'1.7.0','ge') {
// Joomla! 1.7 code here
} elseif(version_compare(JVERSION,'1.6.0','ge') {
// Joomla! 1.6 code here
} else {
// Joomla! 1.5 code here
}
</source>

If you do not have Joomla! 1.7-specific code -i.e it is the same as the Joomla! 1.6-specific code- please use the following code:

<source lang="php">
if(version_compare(JVERSION,'1.6.0','ge') {
// Joomla! 1.6 code here
} else {
// Joomla! 1.5 code here
}
</source>

While this conditional statement looks like an overkill, it has two major advantages:
* Compatibility with all Joomla! versions using the same package, therefore using the same codebase, ergo less maintenance overhead
* Once, let's say, Joomla! 1.8 is released and you decide to drop support for earlier Joomla! releases, we can just search your code for "if(version_compare(JVERSION," and remove all of the legacy code.

== One XML configuration file, multiple Joomla! versions ==

Various XML files in Joomla! accept settings, or parameters. For example your extension manifest file, the config.xml file and the view XML files all accept such settings. You may have noticed that whereas in Joomla! 1.5 these were found under the <params> tags, in Joomla! 1.6 and later they are found inside <filedsets>. One hidden secret of Joomla! is that Joomla! 1.5 will ignore Joomla! 1.6 syntax, whereas Joomla! 1.6/1.7 will ignore Joomla! 1.5 syntax. This allows you to have a single XML file which caters for all Joomla! releases. For example, here's a sample config.xml file, to be placed in the component's backend directory:

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<config>
<params>

<param name="foobar" type="text" default="" size="30"
label="COM_FOOBAR_OPTION_FOOBAR_LBL"
description ="COM_FOOBAR_OPTION_FOOBAR_DESC" />
</params>

<fieldset>

name="basic"
label="COM_FOOBAR_OPTIONS_SECTION_BASIC_LBL"
description="COM_FOOBAR_OPTIONS_SECTION_BASIC_DESC"
>
<field name="foobar" type="text" default="" size="30"
label="COM_FOOBAR_OPTION_FOOBAR_LBL"
description ="COM_FOOBAR_OPTION_FOOBAR_DESC" />
</fieldset>
</config>
</source>

That's how easy it is!

== Dealing with languages ==

=== How to load component-local translation files in Joomla! 1.5 ===

Joomla! 1.6 introduced a new feature where a user can place language files inside the component's directory, e.g. administrator/com_foobar/language/en-GB/en-GB.com_foobar.ini, in order to provide language overrides. But Joomla! 1.5 doesn't support this feature. Or does it? Even though it can not do that automatically, you can do so in your extension's dispatcher file, e.g. administrator/com_foobar/foobar.php. Here's the magic code to do that in the backend:
<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_ADMINISTRATOR, null, true);
$jlang->load('com_foobar', JPATH_COMPONENT_ADMINISTRATOR, null, true);
</source>
and the frontend:
<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_SITE, null, true);
$jlang->load('com_foobar', JPATH_COMPONENT, null, true);
</source>

=== Tips and tricks for language strings ===

All your translation keys should consist of uppercase characters without spaces (that is A-Z, 0-9 and underscores). All translation values should be included in double quotation marks. This allows the translation files to be parsed by Joomla! 1.5/1.6/1.7 alike. You are also suggested to prefix your translation keys with the extension's name, albeit this is not required. For example, this is a good translation string:
COM_FOOBAR_CPANEL_TITLE="Foobar Control Panel"
whereas this is a '''bad''' translation string:
CONTROL PANEL=Foobar Control Panel
The former works with all current versions of Joomla!, the latter doesn't.

If you have double quotation marks in your translation values, please replace them with single quotation marks. While Joomla! 1.5 allowed escaping the double quotation marks with \", Joomla! 1.6 under newer versions of PHP don't and require you to escape them as "__QQ__" which throws off Joomla! 1.5's parser. The workaround is to take advantage of a little known fact about HTML, that attributes can be wrapped in single quotation marks. For instance, change this:
COM_FOOBAR_SOME_KEY=<a href="http://www.example.com">Just a test</a>
to this:
COM_FOOBAR_SOME_KEY="<a href='http://www.example.com'>Just a test</a>"
It is valid HTML, it works on Joomla! 1.5/1.6/1.7 but it will invalidates XHTML. You can't always win, sorry.

=== Making untranslated strings look more beautiful ===

The problem with using tight translation keys as we described is that untranslated strings now look something like COM_FOOBAR_VIEWNAME_SOMEKEY. If you have volunteer translators you can bet your head that most translations will not be in sync with your component and you will have untranslated strings. In Joomla! 1.5, using "natural language" keys, you got to show your users the default (English) text if a translation key didn't exist in their language. This is impossible in Joomla! 1.6... or maybe not?

We can use the same little trick in our component's dispatcher as with our component-local translation loading string above. Here's how to load the English translation file in the backend of your component, then overwrite only the keys which exist with the user's selected language, essentially allowing untranslated keys to show in English:

<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_ADMINISTRATOR, 'en-GB', true);
$jlang->load('com_foobar', JPATH_ADMINISTRATOR, null, true);
</source>

The same thing in the front-end:

<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_SITE, 'en-GB', true);
$jlang->load('com_foobar', JPATH_SITE, null, true);
</source>

== JElement vs JFormField ==

Oh, the struggle! You need a custom widget in the configuration section of your component. In Joomla! 1.5 you could just create a new JElement. In Joomla! 1.6 you could just create a new JFormField. But both? In a single file? You can employ a simple trick. In the following example I am going to create a rather lame element, called SQL2, which displays a multi-selection box out of the results of a SQL statement. This is made as part of a fictitious module called mod_foobar

First, let your configuration know where to load the custom widget files from, by putting this in your module's XML manifest file:

<source lang="xml">
<params addpath="/modules/mod_foobar/elements">
<param name="ids" type="sql2" default=""
label="MOD_FOOBAR_LEVELS_TITLE"
description="MOD_FOOBAR_LEVELS_DESC"
query="SELECT `foobar_level_id`, `title` FROM `#__foobar_levels`"
key_field="foobar_level_id"
value_field="title" />
</params>

<config addfieldpath="/modules/mod_foobar/elements">
<fields name="params">
<fieldset name="basic">
<field name="ids" type="sql2" default=""
label="MOD_FOOBAR_LEVELS_TITLE"
description="MOD_FOOBAR_LEVELS_DESC"
query="SELECT `foobar_level_id`, `title` FROM `#__foobar_levels`"
key_field="foobar_level_id"
value_field="title" />
</fieldset>
</fields>
</config>
</source>

As you see, we instruct both Joomla! 1.5 and 1.6/1.7 to look into the same directory, for the same-named file (sql2.php). Here are the contents of the modules/mod_foobar/elements/sql2.php file:

<source lang="php">
defined('_JEXEC') or die('Restricted Access');

/*
* This trick allows us to extend the correct class, based on whether it's Joomla! 1.5 or 1.6
*/
if(!class_exists('JFakeElementBase')) {
if(version_compare(JVERSION,'1.6.0','ge')) {
class JFakeElementBase extends JFormField {
// This line is required to keep Joomla! 1.6/1.7 from complaining
public function getInput() {}
}
} else {
class JFakeElementBase extends JElement {}
}
}

/**
* Our main element class, creating a multi-select list out of an SQL statement
*/
class JFakeElementSQL2 extends JFakeElementBase
{
var $_name = 'SQL2';

// Joomla! 1.5
function fetchElement($name, $value, &$node, $control_name)
{
$db = & JFactory::getDBO();
$db->setQuery($node->attributes('query'));
$key = ($node->attributes('key_field') ? $node->attributes('key_field') : 'value');
$val = ($node->attributes('value_field') ? $node->attributes('value_field') : $name);
return JHTML::_('select.genericlist', $db->loadObjectList(), ''.$control_name.'['.$name.'][]', 'class="inputbox" multiple="multiple" size="5"', $key, $val, $value, $control_name.$name);
}

// Joomla! 1.6
function getInput()
{
$db = & JFactory::getDBO();
$db->setQuery($this->element['query']);
$key = ($this->element['key_field'] ? $this->element['key_field'] : 'value');
$val = ($this->element['value_field'] ? $this->element['value_field'] : $this->name);
return JHTML::_('select.genericlist', $db->loadObjectList(), $this->name, 'class="inputbox" multiple="multiple" size="5"', $key, $val, $this->value, $this->id);
}
}

/*
* Part two of our trick; we define the proper element name, depending on whether it's Joomla! 1.5 or 1.6
*/
if(version_compare(JVERSION,'1.6.0','ge')) {
class JFormFieldSQL2 extends JFakeElementSQL2 {}
} else {
class JElementSQL2 extends JFakeElementSQL2 {}
}
</source>

Considering that most custom widgets have a lot more code than this, you can create two different initialisation sections for Joomla! 1.5 and 1.6/1.7 (fetchElement and getInput), populate class variables, then call a big, common method to render the bulk of the widget (just like we did with JHTML's genericlist in the example above). This will eliminate the need to rewrite the same code over again just to cater for a new Joomla! version.

== Content plugins work slightly different ==

The content plugins in Joomla! 1.5 were using the onPrepareContent method, whereas the content plugins in Joomla! 1.6/1.7 use the onContentPrepare method. The arguments have also changed. You can, however, create a single content plugin which runs on both Joomla! versions without rewriting code. Here's how:

<source lang="php">
defined('_JEXEC') or die();

jimport('joomla.plugin.plugin');

class plgContentFoobar extends JPlugin
{
public function onPrepareContent( &$article, &$params, $limitstart = 0 )
{
$article->text = $this->doSomethingWith($article->text);
}

public function onContentPrepare($context, &$row, &$params, $page = 0)
{
// Danger, Will Robinson! $row in Joomla! 1.6/1.7 may be a string, not an article object!
if(is_object($row)) {
return $this->onPrepareContent($row, $params, $page);
} else {
$row = $this->doSomethingWith($row);
}

return true;
}

private function doSomethingWith($text)
{
// Apparently, you have to do something here ;)
return $text;
}
}
</source>

== Updating doesn't work as you'd expect ==

There is a small but very disturbing bug in Joomla! 1.6. Updating a component whose manifest XML states version="1.5.0" doesn't allow you to run the SQL statements. Namely, the SQL files you specify under the "<install><sql>" tags won't run. You can neither use the new "<update>" tag. You are stuck with no way to run SQL commands on component update!

The ugly workaround is to create a file named script.foobar.php with the following contents:

<source lang="php">
<?php
define('_JEXEC') or die();

class Com_FoobarInstallerScript {

function update($parent) {
$db = JFactory::getDBO();
// Obviously you may have to change the path and name if your installation SQL file ;)
if(method_exists($parent, 'extension_root')) {
$sqlfile = $parent->getPath('extension_root').DS.'install.sql';
} else {
$sqlfile = $parent->getParent()->getPath('extension_root').DS.'install.sql';
}
// Don't modify below this line
$buffer = file_get_contents($sqlfile);
if ($buffer !== false) {
jimport('joomla.installer.helper');
$queries = JInstallerHelper::splitSql($buffer);
if (count($queries) != 0) {
foreach ($queries as $query)
{
$query = trim($query);
if ($query != '' && $query{0} != '#') {
$db->setQuery($query);
if (!$db->query()) {
JError::raiseWarning(1, JText::sprintf('JLIB_INSTALLER_ERROR_SQL_ERROR', $db->stderr(true)));
return false;
}
}
}
}
}
}
</source>

Reference that file in the end of your manifest XML file, just above the closing install tag, with:
<source type="xml">
<scriptfile>script.foobar.php</scriptfile>
</source>

This will force Joomla! 1.6 to run your extension's installation SQL file during the component update, just like Joomla! 1.5 used to do. Enjoy!

== More tricks? ==

I am sure that by writing this page I have left out a number of tricks which I am already using in my software. If you get stuck somewhere, feel free to take a look at how I've implemented things in Admin Tools Core, Akeeba Backup Core and Akeeba Release System, my Joomla! 1.5/1.6/1.7 compatible extensions. If you find a better way to implement something, or found a trick not listed here, feel free to edit this wiki page. Sharing the knowledge is caring!

Peace, love and friendship,

Nicholas K. Dionysopoulos, AkeebaBackup.com Lead Developer

Making single installation packages for Joomla! 1.5 and 2.5 series

2011-07-17T09:14:19Z

Nikosdion: Added content plugin information; still work in progress

{{underconstruction}}

It is possible to create a single installation package which can install a component in Joomla! 1.5, 1.6 and 1.7 with minor changes. Below you will find some of the most common tricks required to create an extension which is compatible with all current versions of the Joomla! CMS.

== Dealing with API changes ==
You will regularly bump into cases where an API has changed between Joomla! 1.5, 1.6 and 1.7. In order to cater for them, you need to run slightly different code based on the Joomla! version. Right now it's possible to do that by writing conditional statements like this:

<source lang="php">
if(version_compare(JVERSION,'1.7.0','ge') {
// Joomla! 1.7 code here
} elseif(version_compare(JVERSION,'1.6.0','ge') {
// Joomla! 1.6 code here
} else {
// Joomla! 1.5 code here
}
</source>

If you do not have Joomla! 1.7-specific code -i.e it is the same as the Joomla! 1.6-specific code- please use the following code:

<source lang="php">
if(version_compare(JVERSION,'1.6.0','ge') {
// Joomla! 1.6 code here
} else {
// Joomla! 1.5 code here
}
</source>

While this conditional statement looks like an overkill, it has two major advantages:
* Compatibility with all Joomla! versions using the same package, therefore using the same codebase, ergo less maintenance overhead
* Once, let's say, Joomla! 1.8 is released and you decide to drop support for earlier Joomla! releases, we can just search your code for "if(version_compare(JVERSION," and remove all of the legacy code.

== One XML configuration file, multiple Joomla! versions ==

Various XML files in Joomla! accept settings, or parameters. For example your extension manifest file, the config.xml file and the view XML files all accept such settings. You may have noticed that whereas in Joomla! 1.5 these were found under the <params> tags, in Joomla! 1.6 and later they are found inside <filedsets>. One hidden secret of Joomla! is that Joomla! 1.5 will ignore Joomla! 1.6 syntax, whereas Joomla! 1.6/1.7 will ignore Joomla! 1.5 syntax. This allows you to have a single XML file which caters for all Joomla! releases. For example, here's a sample config.xml file, to be placed in the component's backend directory:

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<config>
<params>

<param name="foobar" type="text" default="" size="30"
label="COM_FOOBAR_OPTION_FOOBAR_LBL"
description ="COM_FOOBAR_OPTION_FOOBAR_DESC" />
</params>

<fieldset>

name="basic"
label="COM_FOOBAR_OPTIONS_SECTION_BASIC_LBL"
description="COM_FOOBAR_OPTIONS_SECTION_BASIC_DESC"
>
<field name="foobar" type="text" default="" size="30"
label="COM_FOOBAR_OPTION_FOOBAR_LBL"
description ="COM_FOOBAR_OPTION_FOOBAR_DESC" />
</fieldset>
</config>
</source>

That's how easy it is!

== Dealing with languages ==

=== How to load component-local translation files in Joomla! 1.5 ===

Joomla! 1.6 introduced a new feature where a user can place language files inside the component's directory, e.g. administrator/com_foobar/language/en-GB/en-GB.com_foobar.ini, in order to provide language overrides. But Joomla! 1.5 doesn't support this feature. Or does it? Even though it can not do that automatically, you can do so in your extension's dispatcher file, e.g. administrator/com_foobar/foobar.php. Here's the magic code to do that in the backend:
<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_ADMINISTRATOR, null, true);
$jlang->load('com_foobar', JPATH_COMPONENT_ADMINISTRATOR, null, true);
</source>
and the frontend:
<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_SITE, null, true);
$jlang->load('com_foobar', JPATH_COMPONENT, null, true);
</source>

=== Tips and tricks for language strings ===

All your translation keys should consist of uppercase characters without spaces (that is A-Z, 0-9 and underscores). All translation values should be included in double quotation marks. This allows the translation files to be parsed by Joomla! 1.5/1.6/1.7 alike. You are also suggested to prefix your translation keys with the extension's name, albeit this is not required. For example, this is a good translation string:
COM_FOOBAR_CPANEL_TITLE="Foobar Control Panel"
whereas this is a '''bad''' translation string:
CONTROL PANEL=Foobar Control Panel
The former works with all current versions of Joomla!, the latter doesn't.

If you have double quotation marks in your translation values, please replace them with single quotation marks. While Joomla! 1.5 allowed escaping the double quotation marks with \", Joomla! 1.6 under newer versions of PHP don't and require you to escape them as "__QQ__" which throws off Joomla! 1.5's parser. The workaround is to take advantage of a little known fact about HTML, that attributes can be wrapped in single quotation marks. For instance, change this:
COM_FOOBAR_SOME_KEY=<a href="http://www.example.com">Just a test</a>
to this:
COM_FOOBAR_SOME_KEY="<a href='http://www.example.com'>Just a test</a>"
It is valid HTML, it works on Joomla! 1.5/1.6/1.7 but it will invalidates XHTML. You can't always win, sorry.

=== Making untranslated strings look more beautiful ===

The problem with using tight translation keys as we described is that untranslated strings now look something like COM_FOOBAR_VIEWNAME_SOMEKEY. If you have volunteer translators you can bet your head that most translations will not be in sync with your component and you will have untranslated strings. In Joomla! 1.5, using "natural language" keys, you got to show your users the default (English) text if a translation key didn't exist in their language. This is impossible in Joomla! 1.6... or maybe not?

We can use the same little trick in our component's dispatcher as with our component-local translation loading string above. Here's how to load the English translation file in the backend of your component, then overwrite only the keys which exist with the user's selected language, essentially allowing untranslated keys to show in English:

<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_ADMINISTRATOR, 'en-GB', true);
$jlang->load('com_foobar', JPATH_ADMINISTRATOR, null, true);
</source>

The same thing in the front-end:

<source lang="php">
$jlang =& JFactory::getLanguage();
$jlang->load('com_foobar', JPATH_SITE, 'en-GB', true);
$jlang->load('com_foobar', JPATH_SITE, null, true);
</source>

== JElement vs JFormField ==

Oh, the struggle! You need a custom widget in the configuration section of your component. In Joomla! 1.5 you could just create a new JElement. In Joomla! 1.6 you could just create a new JFormField. But both? In a single file? You can employ a simple trick. In the following example I am going to create a rather lame element, called SQL2, which displays a multi-selection box out of the results of a SQL statement. This is made as part of a fictitious module called mod_foobar

First, let your configuration know where to load the custom widget files from, by putting this in your module's XML manifest file:

<source lang="xml">
<params addpath="/modules/mod_foobar/elements">
<param name="ids" type="sql2" default=""
label="MOD_FOOBAR_LEVELS_TITLE"
description="MOD_FOOBAR_LEVELS_DESC"
query="SELECT `foobar_level_id`, `title` FROM `#__foobar_levels`"
key_field="foobar_level_id"
value_field="title" />
</params>

<config addfieldpath="/modules/mod_foobar/elements">
<fields name="params">
<fieldset name="basic">
<field name="ids" type="sql2" default=""
label="MOD_FOOBAR_LEVELS_TITLE"
description="MOD_FOOBAR_LEVELS_DESC"
query="SELECT `foobar_level_id`, `title` FROM `#__foobar_levels`"
key_field="foobar_level_id"
value_field="title" />
</fieldset>
</fields>
</config>
</source>

As you see, we instruct both Joomla! 1.5 and 1.6/1.7 to look into the same directory, for the same-named file (sql2.php). Here are the contents of the modules/mod_foobar/elements/sql2.php file:

<source lang="php">
defined('_JEXEC') or die('Restricted Access');

/*
* This trick allows us to extend the correct class, based on whether it's Joomla! 1.5 or 1.6
*/
if(!class_exists('JFakeElementBase')) {
if(version_compare(JVERSION,'1.6.0','ge')) {
class JFakeElementBase extends JFormField {
// This line is required to keep Joomla! 1.6/1.7 from complaining
public function getInput() {}
}
} else {
class JFakeElementBase extends JElement {}
}
}

/**
* Our main element class, creating a multi-select list out of an SQL statement
*/
class JFakeElementSQL2 extends JFakeElementBase
{
var $_name = 'SQL2';

// Joomla! 1.5
function fetchElement($name, $value, &$node, $control_name)
{
$db = & JFactory::getDBO();
$db->setQuery($node->attributes('query'));
$key = ($node->attributes('key_field') ? $node->attributes('key_field') : 'value');
$val = ($node->attributes('value_field') ? $node->attributes('value_field') : $name);
return JHTML::_('select.genericlist', $db->loadObjectList(), ''.$control_name.'['.$name.'][]', 'class="inputbox" multiple="multiple" size="5"', $key, $val, $value, $control_name.$name);
}

// Joomla! 1.6
function getInput()
{
$db = & JFactory::getDBO();
$db->setQuery($this->element['query']);
$key = ($this->element['key_field'] ? $this->element['key_field'] : 'value');
$val = ($this->element['value_field'] ? $this->element['value_field'] : $this->name);
return JHTML::_('select.genericlist', $db->loadObjectList(), $this->name, 'class="inputbox" multiple="multiple" size="5"', $key, $val, $this->value, $this->id);
}
}

/*
* Part two of our trick; we define the proper element name, depending on whether it's Joomla! 1.5 or 1.6
*/
if(version_compare(JVERSION,'1.6.0','ge')) {
class JFormFieldSQL2 extends JFakeElementSQL2 {}
} else {
class JElementSQL2 extends JFakeElementSQL2 {}
}
</source>

Considering that most custom widgets have a lot more code than this, you can create two different initialisation sections for Joomla! 1.5 and 1.6/1.7 (fetchElement and getInput), populate class variables, then call a big, common method to render the bulk of the widget (just like we did with JHTML's genericlist in the example above). This will eliminate the need to rewrite the same code over again just to cater for a new Joomla! version.

== Content plugins work slightly different ==

The content plugins in Joomla! 1.5 were using the onPrepareContent method, whereas the content plugins in Joomla! 1.6/1.7 use the onContentPrepare method. The arguments have also changed. You can, however, create a single content plugin which runs on both Joomla! versions without rewriting code. Here's how:

<source lang="php">
defined('_JEXEC') or die();

jimport('joomla.plugin.plugin');

class plgContentFoobar extends JPlugin
{
public function onPrepareContent( &$article, &$params, $limitstart = 0 )
{
$article->text = $this->doSomethingWith($article->text);
}

public function onContentPrepare($context, &$row, &$params, $page = 0)
{
// Danger, Will Robinson! $row in Joomla! 1.6/1.7 may be a string, not an article object!
if(is_object($row)) {
return $this->onPrepareContent($row, $params, $page);
} else {
$row = $this->doSomethingWith($row);
}

return true;
}

private function doSomethingWith($text)
{
// Apparently, you have to do something here ;)
return $text;
}
}
</source>

Making single installation packages for Joomla! 1.5 and 2.5 series

2011-07-17T09:07:13Z

Nikosdion: Added more information; still work in progress

Making single installation packages for Joomla! 1.5 and 2.5 series

2011-07-17T08:29:21Z

Nikosdion: Started working on the page; currently in progress!

Portal:Developers

2011-07-17T08:13:45Z

Nikosdion:

{{RightTOC}}
{{Developer profile}}

A complete contents list of all pages of interest to developers can be found in the [[:Category:Development|development category]].

== Reference Material ==

* [[Framework|Joomla Framework]].
* [http://api.joomla.org API documentation] automatically generated using phpDocumentor.

== Articles and Tutorials ==

=== General ===
* [[Setting up your workstation for Joomla! development]]. A step-by-step guide to installing the Eclipse IDE on your local workstation for Joomla! development.
* [[Setting up your workstation for extension development]] A guide to Joomla Extension development
* [http://community.joomla.org/blogs/community/828-webinar-using-eclipse-for-joomla-development.html Using Eclipse for Joomla! Development] Video webinar demonstrating overview of Eclipse features for Joomla! development
* [[Running Automated Tests for Version 1.6]] {{JVer|1.6}}
* [[How to debug your code]] ([[Do not use die to debug]]!)
* [[Joomla Beginning Developer Course]]
* [[Secure coding guidelines]]

=== Migration ===
* [[Adapting a Joomla 1.0 extension to Joomla 1.5]]
* [[Adapting a Joomla 1.5 extension to Joomla 1.6]]
* [[Version 1.6 Developer Notes]]
* [[Making single installation packages for Joomla! 1.5, 1.6 and 1.7]]

=== Components ===
{{RecReading|Component|dev|topic}}
=== Modules ===
{{RecReading|Module|dev|topic}}
=== Plugins ===
{{RecReading|Plugin|dev|topic}}
=== Templates ===
{{RecReading|Template|dev|topic}}
===Parameters===
* [[Standard parameter types]]
* [[Custom parameter types]]
* [[Component parameters]]
* [[Creating custom template parameter types]]
See also: [[:Category:Parameters]]

=== Core extensions summary ===
* [[Banner component]] {{JVer|1.6}}

=== Security ===
* [[How to add CSRF anti-spoofing to forms]]
* [http://developer.joomla.org/tutorials/181-preventing-sql-injections.html Preventing SQL Injections]
* [[Securing Joomla extensions]]

=== Database ===
* [[How to use the database classes in your script]]
* [[How to use the JTable class]]
* [[How to connect to an external database]]

=== Localisation ===
* [http://community.joomla.org/magazine/article/508-developer-localization-advancements-in-joomla-15.html Localization Advancements in Joomla! 1.5]
* [[Adding multi-language support]]
* [[Language Guidelines for 3rd Party Extensions]]
* [[Adding Joomfish functionality to custom components]]
* [[Specification of language files]] {{JVer|1.6}}
* [[Language Metadata]] {{JVer|1.6}}

=== Access Control ===
* [[Access Control System In Joomla 1.6]] {{JVer|1.6}}

=== Miscellaneous ===
* [[How to use the filesystem package]]
* [[API Execution Order]]
* [[Accessing the current user object]]
* [[Adding JavaScript and CSS to the page]]
* [[Constants]] used in the Joomla [[Framework]].
* [[Client-side form validation]]
* [[How to create a custom button]]
* [[How to create a stand-alone application using the Joomla! Framework]]
* [[How to use user state variables]]
* [[Adding template overridable images in your extension]]
* [[Retrieving data from GET and POST requests]]
* [[Cache]] and [[Using caching to speed up your code]]
* [[Using the installer API to support package installation]]
* [[How to add tooltips to your Joomla! website]]
* [[Display error messages and notices]].
* [[Errors]]
* [[Creating a custom form field type]] {{JVer|1.6}}

== Contributing to Joomla Development ==
The development of Joomla itself is carried out by the [[Development Working Group]] and third party developers.

* [[Participating in the community]]: a brief description of how people can get involved.
* [[Developer Email lists]]: a list of email lists for developers, including third party developers.
* [[Coding style and standards]] (To be reviewed).
* [[Setting up your workstation for Joomla! development]]. A step-by-step guide to installing the Eclipse IDE on your local workstation for Joomla! development.
* [http://docs.joomla.org/Setting_up_your_workstation_for_Joomla!_development_--_Part_2#Check_Out_Joomla.21_Source_Code How to check out SVN Code]
* [[Patch submission guidelines]].
* [[Filing bugs and issues]].
* [[How to release a distribution tarball]].
* [[How to create a continuous integration]].

== Contributing to Joomla Developer Documentation ==
The development of Joomla developer documentation is carried out primarily by the [[Documentation Working Group]]. There are currently two sub-projects of interest to developers:
* [[Joomla! 1.5 Template Tutorials Project]]
* [[API Reference Project]]

When creating a new page, ensure you place the following marker at the bottom of the page so it is included in the category list:

<pre><nowiki>[[Category:Development]]
</nowiki></pre>

If you locate other articles you think are relevant to developers, please add this marker to those pages.

=== Suggested topics ===
This is a short list of articles that might be written to support developers. Please feel free to add further topic ideas.

* [[Adding configuration objects to modules and plugins]].
* [[Storing data in the session between page loads]].
* [[Suppressing output of extra HTML]].
* [[How to use the filter package]].
*: Describe how and when to use the Filter package and explain what needs to be filtered for various situations (for queries, for URLs, etc)
* [[How to use the registry package]]
* [[How to use JSimpleXML]].
*: How to load and store XML files and how to work with them
* [[How to create component feeds]] (RSS/ATOM)
* [[How to create PDF views]]
* [[How to generate paths for client side and server side]]
* [[How to access information from the request]]
*: This focuses on using the JBrowser class to retrieve information about the features available in the user's browser.
* [[How to create an editor plugin]]
* [[What can be done with a user plugin]]
* [[How to work with parameters]]
* [[How to cloak email addresses]]
* [[Using the caching system in your component]]. This might be enough (for now?) -> [[Cache]]
* [[Extending Joomla's MVC Architecture]]

==Joomla Security Guide==
Developers should also be aware of security issues.
{{Security Guide}}

[[Category:Development]]
[[Category:JED]]
[[Category:Joomla! user profiles]]

Government Websites Using Joomla

2011-04-14T13:38:04Z

Nikosdion: Adding more European Union sites

= Multinational Organizations =

== European Union ==

Delegation to the United States [http://eurunion.org]
European Forest Fire Information System [http://effis.jrc.ec.europa.eu]
Europead Forest Data Centre [http://efdac.jrc.ec.europa.eu/]
European Maritime Safety Agency [http://www.emsa.europa.eu/]
Forest Data and Information Systems [http://forest.jrc.ec.europa.eu/]

== United Nations ==

Regional Information Centre Europe [http://unric.org]

UN in Turkmenistan [http://www.untuk.org]

UN Information Centre Cairo [http://www.unic-eg.org/]

UN Infomation Centre in Paname [http://www.cinup.org/susitio/]

United Nations Information Centre for the Caribbean Area [http://portofspain.unic.org/]

UN in Swaziland [http://www.sz.one.un.org/]

The United Nations Office on Sport for Development and Peace [http://www.peace-sport.org/]

== World Health Organization ==

Regional Office for Africa [http://www.afro.who.int/]

== Other ==

The East African Community [http://www.eac.int/]

ECOWAS Small Arms Control Programme [http://www.ecosap.ecowas.int/]

Secretariat of the Pacific Community [http://www.spc.int]

Center for Environment and Development for the Arab Region and Europe [http://www3.cedare.int/]

Common Market for Eastern and Southern Africa Programmes(COMESA) [http://programmes.comesa.int/]

International Security Assistance Force (NATO) [http://www.isaf.nato.int/]

B7 Baltic Islands Network [http://www.b7.org/]

South East Asian Ministers of Education [http://www.seameo.org/]

= Afghanistan =

Ministry of Education [http://pashto.moe.gov.af]

Independent Directorate of Local Governance [http://www.idlg.gov.af]

Criminal Justice Task Force [http://www.cjtf.gov.af]

Control and Audit Office [http://www.cao.gov.af]

Government Media and Information Center (English) [http://www.gmic.gov.af/english]

Government Media and Information Center (Dari) [http://www.gmic.gov.af/dari]

Government Media and Information Center (Pashto) [http://www.gmic.gov.af/pashto]

Afghanistan Civil Service Institute [http://www.acsi.gov.af]

Independent Administrative Reform and Civil Service Commission [http://www.iarcsc.gov.af]

Civil Service Management Department [http://www.csmd.gov.af]

= Albania =

Ministry of Foreign Affairs [http://www.mfa.gov.al]

Institute of Social Security [http://www.issh.gov.al/]

Ministry of Environment, Forestry and Water Administration [http://www.moe.gov.al/en/]

AlbInvest [http://www.albinvest.gov.al/]

National Food Authority [http://www.mbumk.gov.al/]

Regional Directorate of Health - South [http://drshberat.gov.al/]

Municipality of Fier [http://www.qarkufier.gov.al/]

= Algeria =

Portal of the Prime Minister [http://www.cg.gov.dz/]

National Archives [http://www.archives-dgan.gov.dz/]

Ministry of National Planning [http://www.mate.gov.dz/]

Directorate of Trade [http://www.dcommercebba.gov.dz/]

Ministry of Transport[http://www.ministere-transports.gov.dz/]

Ministry of Communication [http://www.ministerecommunication.gov.dz/]

= Andorra =

Trademark Office [http://www.ompa.ad/]

Department of Immigration [http://www.immigracio.ad/]

Department of Youth [http://www.puntjove.ad/]

Department of Education [http://www.educacio.ad/]

Department of Labour [http://www.treball.ad/]

Department of Tourism [http://www.turisme.ad/]

Department of Energy [http://www.energia.ad/]

Department of Research [http://www.recerca.ad/]

Department of Higher Education [http://www.ensenyamentsuperior.ad/]

Andorran Customs [http://www.duana.ad/]

Ministry of Finance [http://www.finances.ad/]

Francofonia [http://www.francofonia.ad/]

Secretariat of State for Culture[http://www.cultura.ad/]

Voluntariat [http://www.voluntariat.ad/]

Language Policy Service[http://www.catala.ad/]

Web Portal for Youth [http://www.joventut.ad/]

Unit for the Prevention and Fight against Corruption[http://www.uprevencio.ad/]

Government Procedures [http://www.tramits.ad/]

Civil Registry [http://www.registrecivil.ad/]

Ministry of Education and Culture [http://www.formacioprofessorat.ad/]

School Exchange Project [http://www.intercat.ad/]

Technological Development Area Education [http://www.claudigital.ad/]

Cultural Heritage [http://www.patrimonicultural.ad/]

Fire Brigade [http://www.bombers.ad/]

Centre for Educational and Vocational Guidance [http://www.coep.ad/]

Entrepeneurs [http://www.emprenedors.ad/]

Institute of Andorran Studies [http://www.iea.ad/]

= Angola =

Instituto Nacional de Luta Contra a Sida [http://sida.gov.ao]

= Antigua and Barbuda =

National Office of Disaster Services [http://www.nods.gov.ag/]

= Argentina =

President of Argentina [http://www.casarosada.gov.ar]

Direccion Nacional de Informacion y Evaluacion de la Calidad Educativa [http://diniece.me.gov.ar]

Programa de Servicios Agrícolas Provinciales [http://www.proargex.gov.ar]

Tourism of the Municipality of Capilla del Monte [http://turismo.capilladelmonte.gov.ar/

Government of the Province of La Rioja [http://www.larioja.gov.ar/]

Education Department of Government of the Province of La Rioja [http://www.larioja.gov.ar/idukay/]

Domestic Trade Department of Government of the Province of La Rioja [http://www.larioja.gov.ar/comerciointerior]

Department of Mental Health Government of the Province of Mendoza [http://www.saludmental.mendoza.gov.ar/]

Buenos Aires Provincial Institute of Public Administration [http://www.ipap.sg.gba.gov.ar/]

Honorable Court of Auditors Buenos Aires Province [http://www.tribctas.gba.gov.ar/sitio/]

Municipality of Cipolletti [http://cipolletti.gov.ar/]

Municipality of Dos De Mayo [http://www.dosdemayo.gov.ar/]

Famaillá City [http://www.famailla.gov.ar/]

Government of the Province of Misiones [http://www.misiones.gov.ar/]

Free Software Mission of the Government of the Province of Misiones [http://www.softwarelibre.misiones.gov.ar/]

Trade and Integration - Government of the Province of Misiones [http://www.misiones.gov.ar/sucei/joomla/]

Ministry of Health - Government of Entre Rios [http://www.entrerios.gov.ar/salud/]

Sitio Oficial Turístico de Valle Hermoso [http://www.vallehermoso.gov.ar/]

= Armenia =

Ministry of Energy and Natural Resources [http://www.minenergy.am]

Police [http://www.police.am]

Armenian Rescue Service [http://www.ema.am]

Vocational Education and Training System [http://vet.am/]

National Statistic Service [http://www.stat-nkr.am/]

= Aruba =

Department of Economic Affairs [http://www.arubaeconomicaffairs.aw/]

= Australia =

Darren Cheeseman MP [http://darrencheeseman.org.au]

Department of Environment and Conservation [http://dec.wa.gov.au]

Education and Training International [http://www.eti.wa.edu.au]

High Court of Australia [http://www.hcourt.gov.au]

Keep Australia Beautiful WA [http://www.kabc.wa.gov.au]

National Capital Authority [http://www.nationalcapital.gov.au]

Premier of South Australia [http://www.premier.sa.gov.au]

QRAA Queensland Government [http://www.qraa.qld.gov.au]

Business.gov.au SmartForms [http://smartforms.business.gov.au/]

Regional Marine Planning [http://rmp.dec.wa.gov.au/]

Public Health Information Development Unit[http://www.publichealth.gov.au/]

Wimmera Catchment Authority [http://www.wcma.vic.gov.au/]

Cobaw Community Health Service [http://www.cobaw.vic.gov.au/]

Kiama Library [http://www.library.kiama.nsw.gov.au/]

City of Geraldton-Greenough Library [http://www.library.cgg.wa.gov.au/]

Narromine Shire Council [http://www.narromine.nsw.gov.au/]

Devonport City Council [http://www.devonport.tas.gov.au/]

= Austria =

Board of Education of Lower Austria [http://www.lsr-noe.gv.at/]

Advocacy For People With Disabilities [http://www.behindertenanwaltschaft.ktn.gv.at/]

Austrian Association of Cities and Towns [http://www.staedtebund.gv.at/]

Federal Office for Viticulture [http://www.bawb.bmlfuw.gv.at/]

Horn [http://www.horn.gv.at/]

Kötschach-Mauthen [http://www.koetschach-mauthen.gv.at/]

Oberwart [http://www.oberwart.gv.at/]

Radenthein [http://www.radenthein.gv.at/]

Sankt Valentin [http://www.st-valentin.gv.at/]

Schwarzach [http://www.schwarzach-pongau.gv.at/]

= Azerbaijan =

Ministry of Foreign Affairs [http://mfa.gov.az/]

Ministry of Economic Development [http://www.economy.gov.az/]

Civil Service Commission [http://dqmk.az/]

Council of State Support to Non-Governmental Organizations [http://www.cssn.gov.az/]

= Bahamas =

The Grand Bahama Port Authority, Government Offices [http://gbpa.com/home/]

= Bahrain =

Bahrain Vision 2030 [http://www.2030.bh]

= Bangladesh =

Main country website [http://bangladesh.gov.bd/]

Prime Minister's Office [http://www.pmo.gov.bd/]

Ministry of Foreign Affairs [http://www.mofa.gov.bd/]

Ministry of Labour and Employment [http://www.mole.gov.bd/]

Ministry of Education [http://www.moedu.gov.bd/]

Ministry of Science and Information & Communication Technology[http://www.mosict.gov.bd/]

Ministry of Religious Affairs [http://www.mora.gov.bd/]

Ministry of Industries [http://www.moind.gov.bd/]

Ministry of Finance [http://www.mof.gov.bd/en/]

Ministry of Health and Family Welfare [http://www.mohfw.gov.bd/]

Ministry of Establishment[http://www.moestab.gov.bd/]

Ministry of Liberation War Affairs [http://www.molwa.gov.bd/]

Ministry of Shipping [http://www.mos.gov.bd/]

Directorate General of Health Services [http://www.dghs.gov.bd/]

Public Service Commission [http://www.bpsc.gov.bd/2011/]

Controller of Certifying Authorities [http://www.cca.gov.bd/]

Department of Textiles [http://www.dot.gov.bd/]

Boalmari Upazila [http://www.unoboalmari.gov.bd/]

Embassy in Brussels [http://brussels.mofa.gov.bd/]

Bangladesh Television [http://www.btv.gov.bd/]

Directorate of Archive and Libraries [http://www.nanl.gov.bd/]

Mongla Port Authority [http://www.mpa.gov.bd/]

Chittagong Hill Tracts Development Board [http://www.chtdb.gov.bd/]

Office of the Controller General of Accounts [http://www.cga.gov.bd/]

Civil Service Administration Academy [http://www.bcsadminacademy.gov.bd/]

Small & Cottage Industries Corporation [http://www.bscic.gov.bd/]

Agricultural Development Corporation[http://www.badc.gov.bd/]

Emergency 2007 Cyclone Recovery and Restoration Project http://www.ecrrp.gov.bd/]

Access 2 Information [http://www.a2i.pmo.gov.bd/]

Power Development Board [http://www.bpdb.gov.bd/bpdb/]

Chittagong Development Authority [http://www.cda.gov.bd/]

Rural Development Board [http://brdb.gov.bd/]

Rural Development & Cooperative Division [http://www.rdcd.gov.bd/]

Govt Bangla College [http://www.sarkaribanglacollege.gov.bd/]

Govt Titumir College [http://www.titumircollege.gov.bd/]

Chittagong College [http://www.ctgcollege.gov.bd/]

Govt Commerce College Chittagong [http://ctgcommercecollege.gov.bd/]

Govt. Brojomohun College [http://www.bmcollege.gov.bd/]

Kabi Nazrul Govt College [http://www.kncollege.gov.bd/]

Press Council [http://presscouncil.gov.bd/]

Skills Development Project [http://www.sdp.gov.bd/]

Dhaka Metropolitan Police [http://www.dmp.gov.bd/]

Bangabandhu Sheikh Mujibur Rahman Novo Theatre [http://www.novotheatre.gov.bd/]

National Museum [http://bangladeshmuseum.gov.bd/site/]

Industrial Technical Assistance Center [http://www.bitac.gov.bd/]

Institute of Textile Technology [http://www.titangail.gov.bd/]

Microcredit Regulatory Authority [http://www.mra.gov.bd/]

Bangladesh Bridge Authority [http://www.bba.gov.bd/]

Disaster Management and Relief Division [http://www.dmrd.gov.bd/]

Implementation Monitoring and Evaluation Division [http://www.imed.gov.bd/]

National Social Welfare Council [http://bnswc.gov.bd/]

Agricultural Research Institute [http://www.bari.gov.bd/]

Food Division [http://www.fd.gov.bd/]

Vulnerable Group Development for Ultra-Poor [http://www.vgdupdwa.gov.bd/]

Economic Relations Division [http://www.erd.gov.bd/]

Instrumentation & Calibration Services Laboratory[http://www.icsl.gov.bd/]

Rural Electrification Board (REB) [http://www.reb.gov.bd/]

Deputy High Commission Kolkata [http://kolkata.mofa.gov.bd/]

Water Development Board [http://www.bpdb.gov.bd/bpdb/]

Large Tax Payers Unit [http://www.ltuvat-gov.org/]

Madrasha Teacher Training Institute [http://www.bmtti.gov.bd/]

Climate Change & Health Promotion Unit [http://cchpu-mohfw.gov.bd/]

Business Laws and Licenses [http://www.businesslaws.boi.gov.bd/]

Government Press [http://www.bgpress.gov.bd/]

Coast Guard [http://www.coastguard.gov.bd/main/]

= Barbados =

National Council for Science and Technology [http://www.ncst.gov.bb/]

Fair Trading Commission [http://www.ftc.gov.bb/]

Corporate Affairs and Intellectual Property Office [http://caipo.gov.bb/]

= Belarus =

Ministry of Trade [http://www.mintorg.gov.by]

Ministry of Emergency Situations, Aftermath of Chernobyl [http://www.chernobyl.gov.by]

Ministry of Internal Affairs [http://bep.gov.by]

Gomel Customs [http://gomel.customs.gov.by]

Vitebsk Customs [http://vitebsk.customs.gov.by]

Brest Customs [http://brest.customs.gov.by]

= Belgium =

ICT en Zorg, from REB Vlaanderen, an initiative of the Vlaamse Minister van Onderwijs en Vorming [http://www.ictenzorg.be/]

CODA-CERVA, the federal 'Veterinary and Agrochemical Research Centre' by the Federal government [http://www.var.fgov.be]

= Belize =

Southern Health Region [http://shr.health.gov.bz]

Ministry of Education [http://www.moe.gov.bz]

Police Department [http://www.police.gov.bz]

= Benin =

Supreme Court [http://www.coursupreme.gouv.bj/]

Ombudsman [http://www.mediateur.gouv.bj/]

Army [http://www.etamajorgeneral.gouv.bj/]

= Bhutan =

Department of Human Resources [http://www.molhr.gov.bt]

Department of Trade [http://www.trade.gov.bt/]

Ministry of Labour and Human Resources [http://www.molhr.gov.bt/]

Cabinet Secretariat [http://www.cabinet.gov.bt]

Department of Trade [http://www.trade.gov.bt]

Infocomm and Media Authority [http://www.bicma.gov.bt]

Thimpu District Municipality [http://www.tcc.gov.bt]

Drug Regulatory Authority [http://dra.gov.bt/]

= Bolivia =

Vicepresidencia de la Nación [http://www.vicepresidencia.gob.bo/]

Ministerio de Hidrocarburos y Energía [http://www.hidrocarburos.gob.bo/sitio/]

Ministerio del Trabajo y Previsión Social [http://www.empleo.gob.bo/]

Ministerio de Desarrollo Productivo [http://www.senavex.gob.bo/]

Ministerio de Autonomía [http://intranet.autonomia.gob.bo/intranet/]

Gobierno Autónomo Departamental de Tarija [http://www.e-tarija.gob.bo/]

Gobierno Autónomo Municipal de Cobija [http://www.gmcobija.gob.bo/]

Gobierno Autónomo Departamental de Pando [http://www.pando.gob.bo/]

Gobierno Departamental de Tarija [http://www.tarija.gob.bo/]

Insumos de Bolivia [http://www.insumosbolivia.gob.bo/]

Programa de Gobierno sobre Electricidad [http://www.idtr.gob.bo/sitio/]

Servicio Nacional de Areas Protegidas [http://www.sernap.gob.bo/]

Servicio Salud Depratamental La Paz [http://www.sedeslapaz.gob.bo/]

Gobernabilidad Democrática en Bolivia [http://www.gobernabilidad.org.bo/]

= Bosnia Herzegovina =

Statistical Council [http://stat.gov.ba]

Centre for Information and Recognition of Qualifications in Higher Education [http://www.cip.gov.ba]

Institut Za Standardizaciju [http://www.bas.gov.ba]

Komisija Za Vrijednosne Papire [http://www.komvp.gov.ba]

Market Surveillance Agency [http://annt.gov.ba]

Public Procurement Agency [http://www.javnenabavke.gov.ba]

Civil Service Agency [http://www.ads.gov.ba]

Commission for the Coordination of Youth Issues [http://www.mladi.gov.ba]

Agency for Pre-Primary and Secondary Education [http://www.aposo.gov.ba]

Office of Attorney General [http://www.pbr.gov.ba]

Directorate of Civil Aviation [http://www.bhdca.gov.ba]

Ministry of Finance and Treasury [http://www.mft.gov.ba]

= Botswana =

Ministry of Trade and Industry [http://www.mti.gov.bw]

Ministry of Foreign Affairs and International Cooperation [http://www.mofaic.gov.bw]

Directorate of Public Service Management [http://www.dpsm.gov.bw]

Central Statistics Office [http://www.cso.gov.bw]

Ministry of Youth, Sport, and Culture [http://www.mysc.gov.bw]

= Brazil =

Ministry of Education [http://portal.mec.gov.br/]

Ministry of Defense [https://www.defesa.gov.br/]

Brazilian Defense Industry [http://imbel.gov.br]

Pará State Health Council [http://www.sespa.pa.gov.br/ces/]

5th Region Federal District Court [http://www.trf5.jus.br/]

Public Ministry of Paraíba [http://www.mp.pb.gov.br/]

Public Ministry of the Federal District and the Territories [http://www.mpdft.gov.br/portal/]

Applied Economic Research Institute [http://www.ipea.gov.br/portal/]

National Institute of Colonization and Agrarian Reform [http://www.incra.gov.br/portal/]

State Traffic Department of Acre [http://www.detran.ac.gov.br/]

State Traffic Department of Pernambuco [http://www.detran.pe.gov.br/]

São Paulo State Secretary of Metropolitan Transport [http://www.stm.sp.gov.br/]

National Programme For The Rational Use of Oil and Natural Gas - CONPET [http://www.conpet.gov.br/w3/]

State Government of Paraíba [http://www.paraiba.pb.gov.br/]

Institute of Radioprotection and Dosimetry [http://www.ird.gov.br/]

Superintendency for the Development of Amazonia (SUDAM) [http://www.ada.gov.br/]

School of Government and Public Administration [http://egap.fundap.sp.gov.br/]

State University of Paraíba [http://www.uepb.pb.gov.br/]

Communication and Information System (SIC) / National Institute of Educational Studies Anísio Teixeira (INEP) [http://www.sic.inep.gov.br/]

National School of Public Administration [http://www.enap.gov.br/]

Coordination for the Improvement of Higher Education Personnel (CAPES) [http://www.capes.gov.br/]

Open University of Brazil [http://www.uab.capes.gov.br/]

Brazilian Mint [http://www.casadamoeda.gov.br/portal/]

Rio de Janeiro State Foundation for Support to the Technical School (FAETEC) [http://www.faetec.rj.gov.br/]

Union Public Defender's Office [http://www.dpu.gov.br/]

FNDE - National Fund for Development of Education [http://www.fnde.gov.br/]

Casa de Oswaldo Cruz (COC) / Oswaldo Cruz Foundation (FIOCRUZ) [http://www.coc.fiocruz.br/]

Ministério das Comunicações / Brazilian Government [http://www.mc.gov.br/]

Ministério da Educação / Brazilian Government [http://portal.mec.gov.br/]

Ministério Público Distrito Federal Territórios / Brazilian Government [http://www.mpdft.gov.br/portal/]

Tribunal de Justiça do Estado da Bahia [http://www5.tjba.jus.br/]

Secretaria de Estado de Educação - Acre [http://www.see.ac.gov.br/portal/]

Secretaria de Estado da Fazenda - Acre [http://www.sefaz.ac.gov.br/sefaz2010/]

Ministério Público do Estado do Amazonas [http://www.mp.am.gov.br/]

Secretaria de Estado do Meio Ambiente e Desenvolvimento Sustentável - Amazonas [http://www.sds.am.gov.br/]

Governo do Estado de Roraima [http://www.rr.gov.br/]

Tribunal de Justiça do Estado de Roraima [http://www.tjrr.jus.br/sistemas/php/joomla/]

Tribunal de Justiça do Estado do Amapá [http://www.tjap.jus.br/portal/]

Governo do Estado do Ceará [http://www.ceara.gov.br/]

= Brunei Darussalam =

Ministry of Industry and Primary Resources [http://www.bruneimipr.gov.bn]

Attorney General's Chambers [http://www.agc.gov.bn]

Department of Civil Aviation [http://www.civil-aviation.gov.bn]

Prime Minister's Officer [http://www.jpm.gov.bn]

Energy Division, Prime Minister's Office [http://www.energy.gov.bn]

Judiciary [http://www.judicial.gov.bn]

Ministry of Communications [http://www.mincom.gov.bn]

MOD [http://www.mod.gov.bn]

E-Business Leadership Forum [http://www.eblf.gov.bn]

Ministry of Defence [http://www.mindef.gov.bn]

=Bulgaria=

Executive Energy Efficiency Agency [http://www.seea.government.bg/]

Operational Programme Administrative Capacity [http://www.opac.government.bg/]

National Service for Agricultural [http://www.naas.government.bg/]

Regional Administration Kyustendil [http://www.kn.government.bg/]

Regional Administration Pernik [http://www.pk.government.bg/]

Regional administration of Sofia Region [http://www.sofoblast.government.bg/]

=Burkina Faso=

Ministry Of Youth And Employment [http://www.mje.gov.bf/]

= Burundi =

Ministry of East African Community [http://www.eac.bi]

Ministry of Public Health [http://www.minisante.bi/]

Revenue Authority [http://www.obr.bi]

National Postal Authority [http://www.poste.bi]

= Cameroon =

Ministry of Higher Education [http://www.minesup.gov.cm]

Ministry of Youth Affairs [http://www.minjeun.gov.cm]

Ministry of Urban Development [http://www.minduh.gov.cm]

Ministry of Economy, Planning, and Regional Development [http://www.minepat.gov.cm]

= Cambodia =

Senate of the Kingdom of Cambodia [http://www.senate.gov.kh/]

Supreme Court and Prosecutor's General Office [http://www.supremecourt.gov.kh/]

National Institute of Statistcs [http://www.nis.gov.kh/]

National Employment Agency [http://www.nea.gov.kh/]

Accreditation Committee of Cambodia [http://www.acc.gov.kh/]

Council for Administrative Reform []http://www.car.gov.kh/

Immigration Department [http://www.immigration.gov.kh/]

General Department of National Treasury [http://www.treasury.gov.kh/]

Cambodian Mine Action and Victim Assistance Authority [http://www.cmaa.gov.kh/]

Cambodian National Petroleum Authority [http://cnpa.gov.kh/]

Demand for Good Governance Project [http://www.dfggmoi.gov.kh/]

Ministry of Justice [http://www.moj.gov.kh/]

Ministry of Tourism [http://www.cambodiatourismindustry.gov.kh/]

Ministry of Rural Development [http://www.mrd.gov.kh/]

National Multi Sector Orphans and Vulnerable Children Task Force [http://novctf.gov.kh/]

Tonle sap Authority [http://www.tonlesap.gov.kh/]

= Canada =

Farm Products Council [http://www.fpcc-cpac.gc.ca/index.php/eng/home]

= Cape Verde =

President of Cape Verde [http://www.primeiroministro.cv]

Ministério dos Negócios Estrangeiros [http://www.mnecc.gov.cv]

Ministry of Health, Dengue Fever [http://www.dengue.gov.cv]

Ministry of Education and Sport [http://www.minedu.gov.cv]

Ministry of Environment and Agriculture [http://www.madrm.gov.cv]

Coordination Unit for State Reform [http://www.reformadoestado.gov.cv]

Mundu Novu [http://www.mundunovu.gov.cv]

Ministry of Economy, Growth and Competitiveness [http://www.mecc.gov.cv]

Direccao-Geral do Ensino Superior e Ciencia [http://www.dgesc.gov.cv]

Ministry of Health [http://www.minsaude.gov.cv]

Ministry of Finance [http://www.minfin.gov.cv]

Cape Verde 2016 [http://www.caboverde2016.gov.cv]

Ministry of Justice [http://www.mj.gov.cv]

Ministry of Labour, Family and Social Solidarity [http://www.mtfs.gov.cv]

= Cayman Islands =

Water Authority [http://www.waterauthority.ky/]

National Gallery [http://www.nationalgallery.org.ky/]

National Roads Authority [http://www.caymanroads.com/]

Cayman Islands Elections Office [http://www.electionsoffice.ky/]

= Ceuta =

Government of Ceuta [http://www.gobiernodeceuta.es/]
= China =

Liaoning Provincial Sports Bureau [http://www.lnsports.gov.cn]

Jiading District Water Authority [http://www.jdwater.gov.cn]

Beijing Science and Technology Cooperation Center [http://www.beijingstcc.gov.cn]

Dalian City Public Security Bureau Traffic Police Detachment [http://www.dlutc.gov.cn]

Sichuan Enviornmental Protection [http://www.schj.gov.cn]

Aksu City Government [http://www.akss.gov.cn]

= Chile =

Comisión Chilena de Energía Nuclear [http://www.cchen.cl/]

Comunidad Tecnológica [http://www.comunidadtecnologica.gob.cl]

Conace [http://conacedrogas.gov.cl]

Instituto Forestal [http://www.infor.gov.cl]

Instituto de Desarrollo Agropecuario [http://www.indap.gov.cl]

Servicio Nacional de Geología y Minería [http://www.sernageomin.gov.cl]

Dirección de Crédito Prendario [http://www.dicrep.gov.cl]

Instituto de Previsión Social [http://ips.gov.cl]

Servicio Nacional de Pesca [http://www.sernapesca.gov.cl]

Municipalidad de Aihue [http://www.comunaalhue.cl]

Municipalidad de Algarrobo [http://www.municipalidadalgarrobo.cl]

Municipalidad de Alto del Carmen [http://www.munialtodelcarmen.cl/]

Municipalidad de Alto Hospicio [http://maho.cl]

Municipalidad de Arauco [http://www.muniarauco.cl]

Municipalidad de Buin [http://www.buin.cl]

Municipalidad de Cabildo [http://www.municipiocabildo.cl]

Municipalidad de Carahue [http://www.carahue.cl/]

Municipalidad de Cartagena [http://www.cartagena-chile.cl/]

Municipalidad de Casablanca [http://www.e-casablanca.cl/]

Municipalidad de Catemu [http://www.municatemu.cl/]

Municipalidad de Cauquenes [http://www.cauquenes.cl/]

Municipalidad de Chaitén [http://www.municipalidaddechaiten.cl/]

Municipalidad de Chonchi [http://www.municipalidadchonchi.cl/]

Municipalidad de Cobquecura [http://www.cobquecura.cl/]

Municipalidad de Cochrane [http://www.cochranepatagonia.cl/]

Municipalidad de Coinco [http://www.municoinco.cl/]

Municipalidad de Combarbalá [http://www.combarbala.cl/]

Municipalidad de Concón [http://www.concon.cl/]

Municipalidad de Coronel [http://www.coronel.cl]

Municipalidad de Curacautín [http://www.mcuracautin.cl/]

Municipalidad de Curacaví [http://www.municipalidadcuracavi.cl/]

Municipalidad de Curanilahue [http://www.munichue.cl/]

Municipalidad de Dalcahue [http://www.dalcahue.cl/]

Municipalidad de El Carmen [http://www.municipalidadelcarmen.cl/]

Municipalidad de El Tabo [http://www.eltabo.cl]

Municipalidad de Ercilla [http://www.muniercilla.cl/]

Municipalidad de Fresia [http://www.munifresia.cl]

Municipalidad de Freire [http://www.munifreire.cl/]

Municipalidad de Gorbea [http://www.municipalidadgorbea.cl/]

Municipalidad de Hualpén [http://www.hualpenciudad.cl/]

Municipalidad de Hualqui [http://www.munihualqui.cl/]

Municipalidad de Las Guaitecas [http://www.muniguaitecas.cl]

Municipalidad de Illapel [http://www.municipalidadillapel.cl/]

Municipalidad de Iquique [http://www.municipioiquique.cl]

Municipalidad de La Higuera [http://www.munilahiguera.cl/]

Municipalidad de Lanco [http://www.munilanco.cl]

Municipalidad de Lautaro [http://www.munilautaro.cl]

Municipalidad de La Unión [http://www.munilaunion.cl/]

Municipalidad de Llanquihue [http://www.munillanquihue.cl/]

Municipalidad de Lo Barnechea [http://www.lobarnechea.cl]

Municipalidad de Loncoche [http://municipalidadloncoche.cl]

Municipalidad de Los Andes [http://www.munilosandes.cl/]

Municipalidad de Los Alamos [http://www.municipalidadlosalamos.cl]

Municipalidad de Los Lagos [http://www.muniloslagos.cl]

Municipalidad de Los Muermos [http://www.muermos.cl/]

Municipalidad de Lota [http://www.lota.cl/]

Municipalidad de Lumaco [http://www.comunalumaco.com]

Municipalidad de Machalí [http://www.machali.cl/]

Municipalidad de Mafil [http://www.munimafil.cl]

Municipalidad de Maullín [http://www.municipalidadmaullin.cl]

Municipalidad de Maullín - Departamento de Salud [http://www.desam-maullin.cl/]

Municipalidad de Melipeuco [http://www.melipeuko.cl/]

Municipalidad de Melipilla [http://www.melipilla.cl]

Municipalidad de Monte Patria [http://www.munimontepatria.cl/]

Municipalidad de Mulchen [http://www.munimulchen.cl]

Municipalidad de Nancagua [http://www.ilustremunicipalidaddenancagua.cl]

Municipalidad de Ninhue [http://www.munininhue.cl]

Municipalidad de Ñiquén [http://www.muniniquen.cl]

Municipalidad de Ovalle [http://www.municipalidaddeovalle.cl]

Municipalidad de Paillaco [http://www.munipaillaco.cl/]

Municipalidad de Palmilla [http://www.munipalmilla.cl/]

Municipalidad de Panguipulli [http://www.municipalidadpanguipulli.cl]

Municipalidad de Paredones [http://www.comunaparedones.cl/]

Municipalidad de Pedro Aguirre Cerda [http://www.pedroaguirrecerda.cl]

Municipalidad de Pelarco [http://www.municipalidaddepelarco.cl/]

Municipalidad de Perquenco [http://www.perquenco.cl/]

Municipalidad de Pinto [http://www.municipalidaddepinto.cl]

Municipalidad de Providencia [http://www.providencia.cl]

Municipalidad de Puerto Montt [http://www.puertomonttchile.cl]

Municipalidad de Puerto Natales [http://www.muninatales.cl/]

Municipalidad de Puqueldon [http://www.munipuqueldon.cl]

Municipalidad de Puyehye [http://www.puyehuechile.cl/]

Municipalidad de Quemchi [http://www.municipalidadquemchi.cl]

Municipalidad de Quilicura [http://www.muniquilicura.cl/]

Municipalidad de Quillota [http://www.quillota.cl/]

Municipalidad de Quinchao [http://www.islaquinchao.com/]

Municipalidad de Quinta Normal [http://www.quintanormal.cl]

Municipalidad de Quirihue [http://www.municipalidadquirihue.cl]

Municipalidad de Rinconada [http://www.munirinconada.cl/]

Municipalidad de Río Negro [http://www.rionegrochile.cl/]

Municipalidad de Rauco [http://www.munirauco.cl/]

Municipalidad de San Antonio [http://www.sanantonio.cl/]

Municipalidad de San Gregorio [http://www.sangregorio.cl/]

Municipalidad de San Ramón [http://www.msanramon.cl/]

Municipalidad de Santa Cruz [http://www.municipalidadsantacruz.cl/]

Municipalidad de Santa María [http://www.imsantamaria.cl/]

Municipalidad de Santa Juana [http://www.santajuana.cl/]

Municipalidad de Talcahuano [http://www.talcahuano.cl]

Municipalidad de Teno [http://www.municipalidaddeteno.cl/]

Municipalidad de Teodoro Schmidt [http://web.muniteodoro.cl/]

Municipalidad de Tirúa [http://www.tiruaweb.cl/]

Municipalidad de Torres del Paine [http://www.torresdelpayne.cl/]

Municipalidad de Tucapel [http://www.municipalidadtucapel.cl/]

Municipalidad de Vallenar [http://www.vallenar.cl/]

Municipalidad de Vicuña [http://www.munivicuna.cl/]

Municipalidad de Vilcún [http://www.vilcun.cl/]

Municipalidad de Villa Alegre [http://www.villalegre.cl/contenido]

Municipalidad de Yungay [http://www.yungay.cl/]

Servicio Vivienda y Urbanismo Región Metropolitana [http://www.serviurm.cl]

Servicio Vivienda y Urbanismo Región O'Higgins [http://www.serviuohiggins.cl]

Agencia Regional Desarrollo Productivo Antofagasta [http://www.agenciaantofagasta.cl]

Agencia Regional Desarrollo Productivo O'Higgins [http://www.agenciaohiggins.cl]

Ministerio de Justicia [http://www.minjusticia.gob.cl]

Servicio Nacional de la Mujer [http://www.sernam.cl]

Portal Compras Públicas Chilecompra [http://www.chilecompra.cl]

Dirección General del Territorio Marítimo [http://www.directemar.cl]

Fundación para la promoción y desarrollo de la mujer PRODEMU [http://www.prodemu.cl/web2]

Fundación de la Familia [http://www.fundaciondelafamilia.cl]

Dirección para la Comunidad de Chilenos en el Exterior [http://www.chilesomostodos.gov.cl]

Comité de Inversiones Extranjeras [http://www.inversionextranjera.cl]

Corporación Nacional Indígena [http://www.conadi.gov.cl]

Junta Nacional de Jardines Infantiles [http://www.junji.cl]

División de Organizaciones Sociales Participemos [http://www.participemos.gob.cl]

Instituto de Previsión Social [http://www.ips.gob.cl]

Instituto de Desarrollo Agropecuario [http://www.indap.gob.cl]

Instituto Nacional de Propiedad Intelectual [http://www.inapi.cl]

Servicio de Salud Metropolitano Occidente [http://www.saludoccidente.cl]

Servicio Médico Legal [http://www.sml.cl/portal]

Superintendencia de Quiebras [http://www.squiebras.cl]

Cámara de Comercio Asia Pacífico [http://www.asiapacific.cl/camara/]

Cámara de Comercio Quiplué [http://www.ccq.cl/]

Cámara de Comercio Valparaíso [http://www.cctvalparaiso.cl/]

Cámara de Comercio Antofagasta [http://www.camaracomercioantofagasta.cl/portal/]

Cámara Regional de Comercio Valpo [http://www.crcpvalpo.cl/]

= Colombia =

Embassy to the United States [http://www.colombiaemb.org/]

National Bureau of Statistics-DANE [http://www.dane.gov.co/]

Statistics Portal [http://www.colombiestad.gov.co/]

Secretaría del Gobierno de Bogotá [http://www.gobiernobogota.gov.co/]

Secretaría del Interior y Convivencia Ciudadana [http://secinterior.cartagena.gov.co/]

Ministry of Transport [http://www.supertransporte.gov.co/super/]

Institute of Tourism and Culture Caquetta [http://www.icdtcaqueta.gov.co/web/]

Mass Transit Medellin [http://www.metrodemedellin.gov.co/]

Urban Development Corporation Medellín [http://www.edu.gov.co/]

Department of Security [http://www.das.gov.co/]

Malvinas Hospital [http://www.hospitalmalvinas.gov.co/site/]

Superintendency of Notaries and Registration [http://www.supernotariado.gov.co/supernotariado/]

Columbian Institute of Geology and Mining [http://www.ingeominas.gov.co/]

Salt Cathedral [http://www.catedraldesal.gov.co/]

Commission for the Regulation of Communications [http://www.crcom.gov.co/]

Regional Autonomous Corporation CORNARE [http://www.cornare.gov.co/]

= Comores =
Comores Telecom [http://comorestelecom-evenements.km/]

= Cote d'Ivoire =

Ministry of Environment, Water and Forests [http://www.environnement.gouv.ci/]

Ministry of Agriculture [http://www.agriculture.gouv.ci/]

Ministry of Commerce [http://www.commerce.gouv.ci/]

Ministry of the Fight against AIDS [http://www.mlsida.gouv.ci/]

Ministry of Finance and economy [http://www.finances.gouv.ci/]

= Cook Island =

Office of the Prime Minister [http://www.pmoffice.gov.ck]

Business Trade Investment Board [http://www.btib.gov.ck]

Ministry of Finance and Economic Management [http://www.mfem.gov.ck]

Ministry of Foreign Affairs and Immigration [http://www.mfai.gov.ck/]

Ministry of Internal Affairs [http://www.intaff.gov.ck/]

Ministry of Education [http://www.education.gov.ck/]

Ministry of Cultural Development [http://www.mocd.gov.ck/]

Ministry of Justice [http://justice.gov.ck/]

Ministry of Agriculture [http://www.agriculture.gov.ck/]

Ministry of Health [http://www.health.gov.ck/]

National Environment Service [http://www.environment.gov.ck/]

Office of the Ombudsman [http://www.ombudsman.gov.ck/]

Financial Intelligence Unit [http://www.cifiu.gov.ck/]

Cook Islands Police [http://dev.police.gov.ck/]

Department Of National Human Resources Development [http://www.nathrd.gov.ck/]

Public Service Commissioner [http://www.psc.gov.ck/]

= Costa Rica =

President of the Republic of Costa Rica [http://www.casapres.go.cr/]

National Musuem [http://www.museocostarica.go.cr/]

National Commission for Risk Prevention and Emergency Response [http://www.cne.go.cr/]

Ministry of Justice and Peace [http://mjp.go.cr/]

Ministry of Planning[http://www.mideplan.go.cr/]

Costa Rican Drug Institute [http://www.icd.go.cr/]

National Women's Institute [http://www.inamu.go.cr/]

City of Santa Ana [http://www.santaanaenlinea.go.cr/]

City of Heredia [http://www.heredia.go.cr/]

= Croatia =

Sisak Moslavina County [http://www.smz.hr]

= Cuba =

Spatial Data Infrastructure of the Republic of Cuba [http://www.iderc.co.cu]

Ministry of Higher Education [http://www.mes.edu.cu/]

= Cyprus =

Ministry of Interior [http://moi.gov.cy]

Department of Electronic Communications [http://www.emf.mcw.gov.cy]

= Czech Republic =
Municipal Milotice [http://www.milotice.cz/]

Municipal Urbanov [http://www.urbanov.com/]

Praha Petrovice [http://www.prahapetrovice.cz/]

= Denmark =

Education for Sustainable Development, Ministry of Education / UNESCO national committee [http://ubuportalen.dk/]

Healt in your language, National Department of Health Odense University [http://www.sundhedpaamitsprog.dk/]

Ministry of Environment Kort & Matrikelstyrelsen [http://visstedet.kms.dk/]

= Djibouti =

Ministry of National Education and Higher Education [http://www.education.gov.dj]

= Dominica =

Inland Revenue Division [http://ird.gov.dm]

Customs and Excise Division [http://www.customs.gov.dm]

Ministry of Agriculture and Forestry [http://agriculture.gov.dm]

= Dominican Republic =

National Institute for Consumer Rights Protection [http://www.proconsumidor.gov.do]

Presidential Commission on the Millennium Development Goals [http://copdes.gov.do]

INESPRE [htpp://www.inespre.gov.do]

Ministry of Labor [http://www.set.gov.do]

Ministry of Environment and Natural Resources [http://www.ambiente.gov.do]

Corporation of State Electrical Companies [http://www.cdeee.gov.do]

Ministry of Foreign Affairs [http://www.serex.gov.do]

Ministry of Foreign Affairs 2 [http://www.mirex.gov.do]

Dominican Coffee Council [http://www.codocafe.gov.do]

Institute for Development and Credit Cooperative [http://idecoop.gov.do]

Metropolitan Transportation Authority [http://www.amet.gov.do]

= Dubai =

Dubai Civil Defence [http://www.dcd.gov.ae]

Ministry of Foreign Trade WTO [http://www.moft.gov.ae/wto/]

Financial Audit Authority [http://www.fad.gov.ae/]

National Transport Authority [http://www.nta.gov.ae/]

Ajman Free Zone Authority [http://www.afza.gov.ae/]

Hamdan Educational Award [http://www.hamdanaward.gov.ae/]

= East Timor =

Sail Timor-Leste and Darwin Dili Yacht Rally [http://www.sailtimorleste.org/]

Timor-Leste 2010 Shanghai Expo website [http://www.timor-leste2010shanghaiexpo.com/]

= Ecuador =

President of Ecuador [http://elciudadano.gov.ec] here is the vídeo when the former president Rafael Correa ask the goverment to use Open Source [http://www.youtube.com/watch?v=Hy5yAk4dYOk]

Ministerio de Salud Pública [http://www.msp.gov.ec/]

Ministerio de Coordinación y Desarrollo Social - Infoinclusión [http://www.infoinclusion.gov.ec/]

Ministerio Coordinador de Patrimonio [http://www.ministeriopatrimonio.gov.ec/]

Secretaria Nacional de Telecomunicaciones [http://www.conatel.gov.ec/site_conatel/]

Corporación Financiera Nacional [http://www.cfn.fin.ec/]

Ministerio de Industrias y Productividad [http://www.micip.gov.ec/]

Sistema Nacional de Información [http://www.sni.gov.ec]

= Egypt =

Alexandria Port Authority [http://www.apa.gov.eg/]

Aswan [http://www.aswan-sun.gov.eg/]

= El Salvador =

Ministry of Interior [http://www.gobernacion.gob.sv/]

Ministry of Foreign Affairs [http://www.rree.gob.sv/]

Ministry of Economy [http://www.minec.gob.sv/]

Ministry of Public Works [http://www.mop.gob.sv/]

Ministry of Public Works Transparency [http://transparencia.mop.gob.sv/]

Ministry of National Defence [http://www.fuerzaarmada.gob.sv/]

National Registration Center [http://www.cnr.gob.sv]

National Lottery [http://www.lnb.gob.sv/]

National Energy Board [http://www.cne.gob.sv/]

Vice Ministry of Transport [http://www.vmt.mop.gob.sv/]

Civil Aviation Authority [http://www.aac.gob.sv/]

Institute for Municipal Development [http://www.isdem.gob.sv/nwises/]

Social Security Institute[http://www.isss.gob.sv/]

Commission of National Bicentenary [http://www.bicentenario.gob.sv/]

Institute for Municipal Development [http://www.isdem.gob.sv/nwises/]

= Equatorial Guinea =

Centro de Referencia para el Control de Endemias en Guinea Ecuatorial [http://www.crce-guinea.org/]

= Eritrea =

Ministry of Energy and Mines [http://www.moem.gov.er/]

Ministry of Information [http://www.shabait.com/index.php]

= Estonia =
Kaitseressursside Amet - Estonian Defence Resources Office [http://www.kra.ee/]

Eesti Kaitseväe Värbamiskeskus - Recruiting Center of Estonian Army [http://vk.kra.ee/]

= Ethiopia =

Addis Ababa City [http://Addisababacity.gov.et]

Arra[http://Arra.org.et]

CSA [http://Csa.gov.et]

EIAR [http://Eiar.gov.et]

Election Ethiopia [http://Electionethiopia.org]

EWCA [http://Ewca.gov.et]

HAPCO [http://Hapco.gov.et]

Harar Municipality [http://Hararmunicipality.org]

HOF Ethiopia [http://Hofethiopia.gov.et]

Kolfekernio [http://Kolfekeranio.gov.et]

Modfed [http://Modfed.gov.et]

MOH [http://Moh.gov.et]

MOYS [http://Moys.gov.et]

Ogaden [http://Ogaden.com]

SNNPREB [http://Snnpreb.gov.et]

SRS [http://Srsinfo.gov.et]

= Faroe Islands =

National Library of the Faroe Islands[http://www.flb.fo/]

Faroese Council of Artists[http://www.lisa.fo/]

= Fiji =

Fiji Government Online Portal [http://www.fiji.gov.fj/]

Department of Immigration [http://www.immigration.gov.fj/]

Department of Town and Country Planning [http://www.townplanning.gov.fj/]

Department of Information Technology and Computing Services http://www.itc.gov.fj/]

Department of Civil Aviation [http://www.civilaviation.gov.fj/]

Ministry of Foreign Affairs & International Cooperation [http://www.foreignaffairs.gov.fj/]

Ministry of Works Transport & Public Utilities [http://mwtpu.gov.fj/]

Ministry of Finance [http://www.finance.gov.fj/]

Fiji Police Force [http://police.gov.fj/]

Higher Education Commission [http://www.fhec.gov.fj/]

Government Shipping Services [http://www.governmentshipping.gov.fj/]

Fiji Islands Marine Safety Commission [http://www.fimsa.gov.fj/]

National Archives of Fiji [http://www.archives.gov.fj/]

Strategic Framework for Change Coordinating Office[http://www.sfcco.gov.fj/]

= Finland =

Regional Council of Southwest Finland [http://www.varsinais-suomi.fi]

= France =

Eiffel Tower [http://www.tour-eiffel.com/]

Journal Officiel [http://www.journal-officiel.gouv.fr/]

Direction de la sécurité de l'aviation civile sud ouest [http://www.dac-so.aviation-civile.gouv.fr/]

L’Observatoire national de l’enfance en danger [http://oned.gouv.fr/]

Direction Régionale des Affaires Culturelles d'Auvergne [http://www.auvergne.culture.gouv.fr/]

= Gabon =

Ministry of Economy, Commerce, Industry and Tourism [http://www.dge.gouv.ga/]

Department of Procurement [http://www.marchespublics.gouv.ga/]

= Gambia =

Official Government Web Portal [http://www.gambia.gov.gm/]

Ministry of Works, Construction and Infrastructure [http://www.mowci.gov.gm/]

Ministry of Petroleum [http://www.mop.gov.gm/]

Ministry of Basic and Secondary Education [http://www.mobse.gov.gm/]

Ministry of Economic Planning and Industrial Development [http://www.mepid.gov.gm/]

Ministry of Higher Education, Research, Science and Technology [http://www.moherst.gov.gm/]

Ministry of the Interior [http://www.moi.gov.gm/]

Ministry of Finance [http://www.mof.gov.gm/]

Ministry of Health and Social Welfare [http://www.moh.gov.gm/]

Ministry of Tourism and Culture [http://www.motc.gov.gm/]

Ministry of Youth and Sports [http://www.moys.gov.gm/]

Personnel Management Office [http://www.pmo.gov.gm/]

Public Service Commission [http://www.psc.gov.gm/]

Gambia Immigration Department [http://www.gid.gov.gm/]

Judiciary of The Gambia [http://www.gov.gm/judiciary]

National Planning Commission [http://www.npc.gov.gm/]

= Georgia =

Kutaisi City [http://kutaisi.gov.ge/]

Gori Municipality [http://www.gori.gov.ge/]

Inspection of Environmental Protection [http://iep.gov.ge/]

Support Georgian Book and Literature [http://www.book.gov.ge/]

= Germany=
AStA der RWTH Aachen [http://www.asta.rwth-aachen.de/]

Gemeinde Breklum [http://breklum.de/]

Gemeinde Brüggen [http://www.brueggen.de/]

Gemeinde Süderlügum [http://suederluegum.de/]

Stadt Adenau [http://www.stadt-adenau.de/]

Stadt Braunlage [http://www.stadt-braunlage.de/]

Stadt Frankfurt: Älterwerden in Frankfurt [http://aelterwerden-in-frankfurt.de/]

Stadt Frankfurt: Ferienkarussell [http://www.ferienkarussell-frankfurt.de/]

Stadt Frankfurt: Kinderkultur [http://www.kinderkultur-frankfurt.de/]

Stadt Neubrandenburg [http://www.neubrandenburg.de]

Stadt Kolbermoor [http://www.stadt-kolbermoor.de/]

Stadt Seeland [http://www.stadt-seeland.de/]

Stadt Sulzbach/Saar [http://www.stadt-sulzbach.de/]

Stadt Wertingen [http://www.wertingen.de/]

= Ghana =

Ghana Government Official Portal [http://www.ghana.gov.gh/]

Office of the President [http://www.oop.gov.gh/]

Child Protection Ghana[http://www.childprotection.gov.gh/]

Highways Authority [http://www.highways.gov.gh/]

Controller & Accountant General's Department[http://cagd.gov.gh/]

Ministry of Information [http://www.moi.gov.gh/]

Ministry of the Interior [http://www.mint.gov.gh/]

Ghana Investment Fund for Electronic Communication [http://www.gifec.gov.gh/]

Environmental Protection Agency [http://www.epa.gov.gh/site/]

Ghana Extractive Industry Transparency Initiative [http://www.geiti.gov.gh/site/]

National Pensions Regulatory Authority [http://npra.gov.gh/site/]

Judicial Service of Ghana [http://www.judicial.gov.gh/]

Ghana Revenue Authority [http://www.gra.gov.gh/]

National Accreditation Board [http://www.nab.gov.gh/]

= Gibraltar =

Government of Gibraltar [http://www.gibraltar.gov.gi/]

Gibraltar Health Authority [http://www.health.gov.gi/]

= Greece =

Ministry of Education [http://www.minedu.gov.gr]

www.gss.gov.gr [http://www.gss.gov.gr]

http://chalki.gov.gr [http://chalki.gov.gr]

http://www.halkidiki.gov.gr [http://www.halkidiki.gov.gr]

Portal of Municipality of Nea Smirni [http://www.neasmyrni.gov.gr]

http://www.nom-athinas.gov.gr [http://www.nom-athinas.gov.gr]

Municipality of Nikaia, Attica [http://www.polisnikaia.gr]

= Greenland =

Bureau of Minerals and Petroleum[http://www.bmp.gl/]

= Grenada =

CWA 2010 [http://cwa.gov.gd/]

= Guatemala =

Secretaría de Bienestar Social [http://www.sbs.gob.gt/]

Ministerio de Finanzas Públicas [http://minfin.gob.gt]

= Guayana =

President of Guayana [http://opnew.op.gov.gy/]

Ministry of Foreign Affairs [http://www.minfor.gov.gy/tsite/]

= Guinea =

Présidence de la République de Guinée [http://www.guinee.gov.gn/pr/]

= Haiti =

Ministry of Haitians Living Abroad [http://www.mhave.gouv.ht]

Department of Public Health and Population [http://www.mspp.gouv.ht]

International Port of Port-au-Prince [http://www.apn.gouv.ht]

DINEPA [http://www.dinepa.gouv.ht]

= Honduras =

National Service of Agricultural Health [http://www.senasa-sag.gob.hn]

President of Honduras [http://www.presidencia.gob.hn]

Secretary of State [http://www.sdp.gob.hn]

Minister of National Women's Institute [http://www.inam.gob.hn]

Secretary of Culture, Arts, and Sports [http://www.scad.gob.hn]

Ministry of Agriculture and Livestock [http://www.sag.gob.hn]

Technical Secretariat of Planning and External Cooperation [http://www.seplan.gob.hn]

National Commission on Energy [http://www.cne.gob.hn]

= Hong Kong =

Family Friendly Employers [http://event.familycouncil.gov.hk/]

= Hungary =

National Tax and Customs Training, Health and Cultural Institute [https://abpe.nav.gov.hu]

= Iceland =

Directorate of Immigration[http://www.utl.is/]

United Nations Women Rights in Iceland [http://www.unwomen.is/]

East Iceland Invest [http://www.east-iceland.is/]

= India =

Competition Commission of India [http://www.cci.gov.in/]

Wildlife Institute of India [http://www.wii.gov.in/]

Government of Kerala [http://www.kerala.gov.in/]

Kerala Forests and Wildlife Department [http://www.keralaforest.gov.in/]

Non-resident Keralites' Affairs [http://www.norka.gov.in/]

District Court Thiruvanathapuram Website [http://trivandrumdistrictcourt.gov.in/]

Unique Identification Authority of India [http://uidai.gov.in/]

Government of Mizoram - Department of Cooperation [http://www.coop.mizoram.gov.in/]

Bruhat Bengaluru Mahanagara Palike [http://bbmp.gov.in/]

= Indonesia =

Main country website [http://indonesia.go.id/]

State Secretariat [http://www.setneg.go.id/]

National Election Commission [http://kpu.go.id/]

Ministry of Environment [http://www.menlh.go.id/home/]

Ministry of Cooperatives and Small and Medium Enterprise [http://www.depkop.go.id/]

Ministry of Empowerment of Women and Child Protection [http://www.menegpp.go.id/]

Ministry of State Apparatus & Bureaucracy Reform [http://www.menpan.go.id/]

Ministry of Health [http://www.depkes.go.id/]

Ministry of Energy & Mineral Resources [http://www.esdm.go.id/]

Directorate General of Higher Education [http://dikti.go.id/]

Directorate General of Immigration, Ministry of Law and Human Rights [http://www.imigrasi.go.id/]

Directorate General of Taxes [http://www.pajak.go.id/]

Media Center, Ministry of Defense [http://www.dmc.kemhan.go.id/]

Geological Survey Centre of Geological Agency, Ministry of Energy & Mineral Resources [http://psg.bgl.esdm.go.id/]

Training, Research & Development Body, Ministry of Religious Affairs [http://balitbangdiklat.kemenag.go.id/]

Lajnah Pentasihan Mushlaf Al-Qur'an, Ministry of Religious Affairs [http://lajnah.kemenag.go.id/]

Hydro-Oceanographic Office, Indonesian Navy [http://dishidros.go.id/hidros/]

City of Banda Aceh, Aceh Province [http://bandaacehkota.go.id/]

City of Sabang, Aceh Province [http://www.sabangkota.go.id/]

City of Lhokseumawe, Aceh Province [http://www.lhokseumawekota.go.id/]

City of Langsa, Aceh Province [http://langsakota.go.id/]

Aceh Jaya Regency of Aceh Province [http://www.acehjayakab.go.id/]

South Aceh Regency of Aceh Province [http://www.acehselatankab.go.id/]

Pidie Jaya Regency of Aceh Province [http://www.pidiejayakab.go.id/]

City of Binjai, North Sumatera Province [http://www.binjai.go.id/]

Serdang Bedagai Regency of North Sumatera Province [http://serdangbedagaikab.go.id/]

Karo Regency of North Sumatera Province [http://www.karokab.go.id/]

Samosir Regency of North Sumatera Province [http://www.samosirkab.go.id/]

Mandailing Natal Regency of North Sumatera Province [http://www.madina.go.id/]

Central Tapanuli Regency of North Sumatera Province [http://www.tapteng.go.id/]

Simalungun Regency of North Sumatera Province [http://www.simalungunkab.go.id/]

City of Solok, West Sumatera Province [http://www.solokkota.go.id/]

City of Padang Panjang, West Sumatera Province [http://www.padangpanjangkota.go.id/]

City of Padang, West Sumatera Province [http://www.padang.go.id/]

Dharmasraya Regency of West Sumatera Province [http://old.dharmasrayakab.go.id/]

Pasaman Regency of West Sumatera Province [http://www.pasamankab.go.id/]

West Pasaman Regency of West Sumatera Province [http://www.pasbarkab.go.id/]

Tanah Datar Regency of West Sumatera Province [http://www.tanahdatar.go.id/]

City of Jambi, Jambi Province [http://www.kotajambi.go.id/id/]

Batanghari Regency of Jambi Province [http://www.batangharikab.go.id/]

East Tanjung Jabung Regency of Jambi Province [http://www.tanjabtimkab.go.id/]

City of Dumai, Riau Province [http://www.dumaikota.go.id/]

Indragiri Hilir Regency of Riau Province [http://www.inhilkab.go.id/]

Kampar Regency of Riau Province [http://www.kamparkab.go.id/]

Regional House of Representatives, Rokan Hilir Regency of Riau Province [http://www.dprd-rohilkab.go.id/]

Pemalang Regency of Central Java Province [http://www.pemalangkab.go.id/]

Regional House of Representatives, Tulungagung Regency of East Java Province [http://www.dprd-tulungagungkab.go.id/]

South Kalimantan Province [http://www.kalselprov.go.id]

Gorontalo Province [http://www.gorontaloprov.go.id/]

Sinjai Regency of South Sulawesi Province [http://sinjai.go.id/sinjai/]

Aceh Syari'ah Court [http://www.mahkamahsyariahaceh.go.id/]

National Commission for Child Protection [http://www.kpai.go.id/]

National Commission for Human Rights [http://www.komnasham.go.id/]

Judicial Commission [http://www.komisiyudisial.go.id/]

Office of Cooperatives and SME, East Java Province [http://www.diskopjatim.go.id/]

Information & Documentation Officer, Office of Cooperatives and SME, East Java Province [http://www.ppid.diskopjatim.go.id/]

Office of Labour, Transmigration & Population, East Java Province [http://disnakertransduk.jatimprov.go.id/]

Zakat Infaq & Sadaqah Management Body, Jakarta Special Capitol Region Province [http://bazisdki.go.id/]

Office of Natural Recources Conservation in Central Kalimantan, Ministry of Forestry [http://bksdakalteng.dephut.go.id/]

= Iran =

Ayatollah Ali Khamenei [http://arabic.khamenei.ir/]

National Portal for Electronic Service of Iran (English) [http://en.iran.ir/]

National Portal for Electronic Service of Iran [http://www.iran.ir/]

= Iraq =

Baghdad Governorate [http://www.baghdad.gov.iq/en]

Inspector General Office [http://www.igoil.gov.iq/]

SOMO Oil Marketing Company [http://somooil.gov.iq/]

= Ireland =

Adoption Authority [http://www.aai.gov.ie/]

Patient Safety First [http://www.patientsafetyfirst.gov.ie/]

= Israel =

Civil Aviation Authority [http://caa.gov.il]

Ministry of Transport and Road safety [http://en.mot.gov.il]

Shipping and Ports Authority [http://spa.mot.gov.il/]

= Italy =

City of Capoterra [http://www.comune.capoterra.ca.it]

Ministry of Economic Development [http://www.sviluppoeconomico.gov.it]

Directorate-General for Anti-Counterfeiting Italian Patent and Trademark Office [http://www.uibm.gov.it]

Minister for the Equal Opportunities [http://www.pariopportunita.gov.it]

Regione Calabria [http://www.regione.calabria.it/]

Unioncamere [http://www.unioncamere.gov.it]

= Japan =
Kofu City Official Web Site [http://www.city.kofu.yamanashi.jp/]

= Jamaica =

Houses of Parliament [http://www.japarliament.gov.jm/]

= Jordan =

Jordan Enterprise Development Corporation [http://www.jedco.gov.jo/]

Ministry of the Interior General Directorate Of Gendarmerie [http://www.jdf.gov.jo/]

Jordan Aid Information Managment System [http://www.mopic-jaims.gov.jo/]

Jordan Deposit Insurance Corporation [http://www.dic.gov.jo/]

Telecommunication Regulatory Commission [http://www.trc.gov.jo/]

Tourism Police Department [http://www.tourist-police.psd.gov.jo/]

National Resources Authority [http://www.nra.gov.jo/]

= Kazakhstan =

Ministry of Agriculture [http://www.minagri.gov.kz/]

Ministry of Defence [http://mod.gov.kz/]

Ministry of Communication and Information [http://mci.gov.kz/]

Agency of Construction, Housing and Utilities [http://www.ads.gov.kz/]

= Kenya =

Office of the President [http://www.cabinetoffice.go.ke/]

Ministry of Foreign Affairs [http://www.mfa.go.ke/]

Ministry of Justice & Constitutional Affairs [http://www.justice.go.ke/]

Ministry of Livestock Development [http://www.livestock.go.ke/]

Ministry of Public Works [http://www.publicworks.go.ke/]

Ministry of Labour [http://www.labour.go.ke/]

Ministry of Industrialisation [http://www.industrialization.go.ke/]

Directorate of e-Government [http://www.e-government.go.ke/]

National Council for Science and Technology [http://www.ncst.go.ke/]

Kenya OCT Bosrd [http://www.ict.go.ke/]

National Environment Managment Authority [http://www.nema.go.ke/]

National Disaster Operations Centre [http://www.nationaldisaster.go.ke/]

Insurance Regulatory Authority [http://www.ira.go.ke/]

City Council of Nairobi [http://www.nairobicity.go.ke/]

Municipal Council of Nyahururu[http://www.nyahururumunicipal.go.ke/]

Karibu Town Council of Ukwala [http://www.ukwalatown.go.ke/]

= Kiribati =

Ministry of Labour Human Resource Development [http://www.labour.gov.ki]

Kiribati National Tourism Organisation [http://www.kiribatitourism.gov.ki]

Public Service Office [http://www.pso.gov.ki]

National Audit Office [http://knao.gov.ki/]

Telecommunications Authority [http://www.tak.gov.ki/]

Kiribati Adaptation Project [http://www.kap.gov.ki/]

= Kosovo =

Ministry of Public Administration [http://esk.rks-gov.net/]

= Kuwait =

Ministry of Foreign Affairs [http://www.mofa.gov.kw]

= Kyrgyzstan =

Government of Kyrgyzstan [http://www.gov.kg/]

Ministry of Transport and Communications [http://www.mtk.gov.kg/]

National Library [http://nlkr.gov.kg/]

= Laos=

Luang Prabang Province [http://luangprabang.gov.la/]

Ministry of Agriculture [http://www.maf.gov.la/index.php]

Ministry of Education [http://www.moe.gov.la/index.php]

Ministry of Energy and Mines [http://www.mem.gov.la/index.php]

Ministry of Health [http://www.moh.gov.la]

National Authority of Science and Technology [http://nast.gov.la]

National Authority of Post and Telecommunications [http://www.napt.gov.la/]

Statistics Bureau [http://www.nsc.gov.la/]

= Latvia =

Main Government website [http://www.li.lv/]

Cultural Education and Intangible Heritage Centre [http://www.knmc.gov.lv/]

State Agency of Intangible Cultural Heritage [http://www.nkmva.gov.lv/en/]

School of Public Administration [http://www.vas.gov.lv/]

= Lebanon =

Municipality of Zgharta [http://www.zgharta.gov.lb/]

Central Administration of Statistics [http://cas.gov.lb/]

= Lesotho =

Ministry of Education [http://www.education.gov.ls]

Ministry of Natural Resources [http://www.mines.gov.ls/]

= Liberia =

Anti-Corruption Commission [http://www.lacc.gov.lr/]

Judiciary [www.judiciary.gov.lr]

Ministry of Planning and Economic Affairs [http://nao.mopea.gov.lr/]

= Libya =

Several Government ministry web sites are reported by google as being Joomla but the entire internet for Libya seems to be out of reach at the moment

= Liechtenstein =

Government Institution Vaduz, Government of Liechtenstein [http://www.ausgewogen2015.li/]

= Lithuania =

State Property Fund [http://www.vtf.lt/]

Lithuanian Business Employers' Confederation [http://www.svv.lt/]

Certification Center of Building Products [http://www.spsc.lt/]

Government Project "Lithuania 2030" [http://www.lietuva2030.lt/]

= Luxembourg =

Youth [http://www.youth.lu]

= Macau =

Macau Government Tourist Office [http://www.macautourism.gov.mo/]

Unitary Police Service [http://www.spu.gov.mo/]

Office for Preparation of Macau's Participation in World Expo Shanghai [http://www.2010expomacao.gov.mo/]

= Madagascar =

Le Conseli Supérieur de la Transition [http://www.senat.gov.mg/]

Ministère des Finances et du Budget [http://www.mfb.gov.mg/]

Ministère de L'Energie et des Mines [http://www.mines.gov.mg/]

Ministère de L'Environnement et des Forêts [http://www.meeft.gov.mg/]

Ministère de la Sécurité Intérieure [http://www.policenationale.gov.mg/]

Ministère des Forces Armees [http://www.defense.gov.mg/]

Ministère de l'Agriculture [http://www.agriculture.gov.mg/]

Ministère de la Population et des Affaires Sociales [http://www.population.gov.mg/]

High Constitutional Court [http://www.hcc.gov.mg/]

= Malawi =

Official Site of the Malawi Government [http://www.malawi.gov.mw/]

Financial Intelligence Unit [http://www.fiumalawi.gov.mw/]

Ministry of Finance [http://www.finance.gov.mw/]

Ministry of Foreign Affairs [http://www.foreignaffairs.gov.mw/]

Office of the Director of Public Procurement [http://www.odpp.gov.mw/]

= Malaysia =

Department of Syariah Judiciary Malaysia [http://www.jksm.gov.my/]

Malaysian Medical Council [http://www.mmc.gov.my/v1/]

Ministry of Human Resources, Malaysia [http://www.mohr.gov.my/]

Pahang Library [http://web.pahanglibrary.gov.my/]

Penang Development Corporation [http://pdc.gov.my/]

Public Sector ICT Security [http://www.ictsecurity.gov.my/index.php]

Veterinary Services Department, Perak [http://www.jpvpk.gov.my/]

= Maldives =

Department of National Planning [http://planning.gov.mv/]

Environment Protection Agency [http://epa.gov.mv/]

Maldives Pension Administration Office [http://pension.gov.mv/]

= Mali =

Primature [http://www.primature.gov.ml/]

Ministère de l'Economie et des Finances [http://www.finances.gov.ml/]

Direction Générale des Marchés Public et des Délegations de Service Public [http://www.dgmp.gov.ml/]

Direction Nationale des Domaines et du Cadastre [http://www.dndc.gov.ml/]

Ministry of Health [http://www.sante.gov.ml/]

entre Nationale de Traitement des Informations Financières [http://www.centif.gov.ml/]

= Malta =

Eco-Gozo [http://www.eco-gozo.gov.mt/]

= Mauritius =

Black River District Council [http://brdc.mu]

Municipal Council of Quatre Borne [http://qb.mu/]

Mauritius Tourism Promotion Authority [http://www.tourism-mauritius.mu/]

Pamplemousses-Rivière du Rempart District Council [http://prdc.mu/]

= Mauritania =

National Agency of Civil Aviation [http://anac.mr]

= Mexico =

Bicentenary Celebrations [http://www.bicentenario.gob.mx]

Ministry of Foreign Affairs [http://www.sre.gob.mx]

National Fund for the Promotion of the Crafts [http://www.fonart.gob.mx]

= Micronesia =

Department of Resources and Development - Federated States of Micronesia [http://www.fsmrd.fm/]

= Moldova =

Academy of Public Administration [http://aap.gov.md/]

Ministry of Transport [http://www.mtid.gov.md/]

= Mongolia =

Ministry of Nature, Environment and Tourism [http://www.mne.mn/mn]

Altanbulag Free Trade and Economic Zone [http://www.altanbulag.gov.mn]

= Montenegro =

Institute for the Education of Montenegro [http://www.zavodzaskolstvo.gov.me/]

= Montserrat =

Government Information Unit [http://giu.gov.ms]

= Morocco =

Regional African Centre of Science, Technology and Space [http://www.enssup.gov.ma/craste/]

Ministry of Education [http://www.dfc.gov.ma/dfc/]

Ministry of Culture [http://www.minculture.gov.ma/]

Center for Training in ICT for Education [http://cnipe.men.gov.ma/cmcf-tice/]

= Mozambique =

Tax Authority [http://www.at.gov.mz]

Ministry of National Defence [http://www.mdn.gov.mz/]

Ministry of Foreign Affairs and Cooperation [http://www.minec.gov.mz]

Ministry of Fisheries [http://www.mozpesca.gov.mz/]

Ministry of Mineral Resources [http://www.mirem.gov.mz/]

Ministry of Planning and Development [http://www.mpd.gov.mz]

Ministry of Transport and Communication [http://www.mtc.gov.mz/]

Ministry of Women and Social Work [http://www.mmas.gov.mz/]

Special Economic Zones Office [http://www.gazeda.gov.mz]

Environmental Law [http://www.legisambiente.gov.mz/]

Institute for the Promotion of Exports [http://www.ipex.gov.mz]

Institute for Agricultural Research [http://www.iiam.gov.mz]

Institute for the Promotion of Small and Medium Enterprises [http://www.ipeme.gov.mz/]

Institute

Centre for Promotion of Agriculture [http://www.cepagri.gov.mz/]

Made in Mozambique [http://www.madeinmozambique.gov.mz/]

State National Archives [http://www.cedimo.gov.mz/]

Judiciary Portal [http://www.portaldojudiciario.gov.mz/]

National Press [http://www.imprensanac.gov.mz/]

Conservation Areas [http://www.actf.gov.mz/index/]

Clean Development Mechanism [http://www.mdl.gov.mz/]

National Institute for Aquaculture Development [http://www.inaqua.gov.mz/]

National Institute of Social Action [http://www.inas.gov.mz/

National Institute for Mine Clearance [http://www.ind.gov.mz/]

National Park of Quirimbas [http://www.quirimbas.gov.mz/]

Attorney General's Office [http://www.pgr.gov.mz/]

= Myanmar =

Department of Meteorology and Hydrology [http://www.dmh.gov.mm/]

Ministry of Science and Technology [http://www.most.gov.mm/]

Ministry of Rail Transportation [http://www.mrt.gov.mm/]

Myanma Port Authority [http://www.mpa.gov.mm/]

= Namibia =

Social Security Commission [http://www.ssc.org.na/]

= Nepal =

Alternative Energy Promotion Center [http://www.aepc.gov.np]

Ministry of Science and Technology [http://www.moest.gov.np]

National Population and Housing Census [http://www.census.gov.np]

Department of Mines and Geology [http://www.dmgnepal.gov.np]

Office of the Attorney General [http://www.attorneygeneral.gov.np]

Postal Services [http://www.nepalpost.gov.np]

Nepal Police Hospital [http://nph.nepalpolice.gov.np]

Nepal Police [http://nepalpolice.gov.np]

Department of Forests [http://www.dof.gov.np]

National Police Academy [http://npa.nepalpolice.gov.np]

Ministry of Environment, Department of Hydrology and Meteorology [http://www.hydrology.gov.np]

National Foundation for Development of Indigenous Nationalities [http://www.nfdin.gov.np]

Ministry of Science and Technology [http://www.most.gov.np]

Nepal Water Supply Corporation [http://www.nwsc.gov.np]

National Information Technology Center [http://nitc.gov.np]

Nepal Engineering Council [http://www.nec.gov.np]

Copyright Registrar's Office [http://www.nepalcopyright.gov.np]

Ministry of Education, Department of Education, Sindhupalchok District Office [http://www.deosipa.gov.np]

Law Commission [http://www.lawcommission.gov.np]

= Netherlands =

De Sociale Inlichtingen [http://www.siod.nl/]

e-overheid [http://www.prod.joomla.ictu.asp4all.nl/]

Stichting ICTU [http://www.ictu.nl/]

Patent Office [http://www.octrooicentrum.nl/]

Essentieprogramma [http://www.ambtenaar10.nl]
Ministerie van Binnenlandse Zaken en Koninkrijksrelaties

Regio Twente [http://www.regiotwente.nl/]
Samenwerkingsverband van de veertien Twentse gemeenten

Skillsmasters [http://www.skillsmasters.nl]
Provincie Zuid-Holland

Stichting Provinciale Atlas [http://www.provincialeatlas-nh.nl]
Provincie Noord-Holland in samenwerking met het Rijksarchief in Noord-Holland

FriesArchiefNet [http://www.friesarchiefnet.nl/]
Provincie Fryslân, de Friese waterschappen en gemeenten en de drie archiefdiensten in de provincie

= New Zealand =

Matamata-Piako District [http://www.mpdc.govt.nz/home.html]

Rangitikei District Council [http://www.rangdc.govt.nz/]

Timaru District Council [http://www.timaru.govt.nz/]

South Waikato District Council [http://www.southwaikato.govt.nz/]

Buller District Council [http://www.bullerdc.govt.nz/]

= Nicaragua =

Presidencia [http://www.presidencia.gob.ni/]

National Assembly [http://www.asamblea.gob.ni/]

Supreme Electoral Council [http://www.cse.gob.ni/]

Ministry of the Environment [http://marena.gob.ni/]

Ministry of Foreign Affairs [http://oaip.cancilleria.gob.ni/]

Institute of Territorial Studies [http://www.ineter.gob.ni/]

Commission National Free Zones [http://www.cnzf.gob.ni/]

= Niger =

President [http://www.presidence.ne]

National Portal [http://www.gouv-niger.ne/]

Ministry of Secondary and Higher Education and Scientific Research [http://www.messrs.ne/]

Ministry of Communication, New Technology and Culture [http://www.mcntic.ne/]

Office of Broadcast Television [http://www.ortn.ne/]

= Nigeria =

Corporate Affairs Commission [http://www.cac.gov.ng/]

Cross River State Government [http://www.crossriverstate.gov.ng/]

Education Trust Fund [http://www.etf.gov.ng/]

Federal Capital Territory Administration [http://www.fct.gov.ng/]

National Agency for the Prohibition of Traffic in Persons [http://www.naptip.gov.ng/]

National Pension Commission [http://www.pencom.gov.ng/]

Nigerian financial Intelligence Unit [http://www.nfiu.gov.ng/]

Petroleum Technology Development Fund [http://www.ptdf.gov.ng/]

River State [http://www.riversstate.gov.ng/]

= Northern Mariana Islands =

Department of Public Saftey [http://www.dps.gov.mp/]

Homeland Security [http://www.cnmihomelandsecurity.gov.mp/]

= Norway =

Ålesund kommune [http://alesund.kommune.no/]

Andøy kommune [http://www.andoy.kommune.no/]

Evenes kommune [http://www.evenes.kommune.no/]

Gildeskål kommune [https://gildeskal.kommune.no/]

Grue kommune [http://www.grue.kommune.no/]

Hadsel kommune [http://www.hadsel.kommune.no/]

Hurum kommune [http://www.hurum.kommune.no/]

Kvæfjord kommune [http://www.kvafjord.kommune.no/]

Nesna kommune [http://www.nesna.kommune.no/]

Skånland kommune [http://www.skanland.kommune.no/]

Statens Dataforum [http://www.statens-dataforum.no/]

Sør-Odal kommune [http://www.sor-odal.kommune.no/]

Tjeldsund kommune [http://www.tjeldsund.kommune.no/]

Vestvågøy kommune [http://www.vestvagoy.kommune.no/]

Øksnes kommune [http://oksnes.kommune.no/]

= Oman =

Higher Education Admissions Centre [http://www.heac.gov.om/]

Ministry of Higher Education Graduate Survery System [http://www.ogss.gov.om/]

= Pakistan =

National Highway Authority [http://www.nha.gov.pk/]

National Commission for Human Development [http://www.nchd.gov.pk/]

Pakistan Telecommunications Agency [http://www.pta.gov.pk/]

Electronic Media Regulatory Authority [http://www.pemra.gov.pk/]

National Database & Registration Authority [http://www.nadra.gov.pk/]

Competition Commission [http://www.cc.gov.pk/]

District Government Sukkur [http://www.sukkur.gov.pk/]

Air Force Air War College [http://www.pafawc.gov.pk/]

Federally Administered Tribal Areas [http://fata.gov.pk/]

Government of Balochistan [http://www.balochistan.gov.pk/]

Pakistan Academy of Letters [http://www.pal.gov.pk/]

Higher Education Job Portal [http://hjp.hec.gov.pk/]

Disaster Management Authority [http://www.fdma.gov.pk/]

Iqbal Acadamey [http://www.iap.gov.pk/]

= Palau =

Ministry of Health [http://www.palau-health.net/]

Palau International Coral Reef Center [http://picrc.org/]

= Palestinian territories =

The Governmental Committee for breaking the siege [http://www.gcbs.gov.ps/en]

Council of Ministers [http://www.pmo.gov.ps/]

Financial and Administrative Control Bureau [http://www.facb.gov.ps/]

Judicial Authority [http://www.ljc.gov.ps/]

Ministry of Agriculture [http://www.moa.gov.ps/]

Ministry of Detainee's Affairs [http://www.mod.gov.ps/]

Ministry of Social Affairs [http://www.mosa.gov.ps/ar/]

Ministry of Youth and Sport [http://www.mys.gov.ps/]

Ministry of Interior and National Security [http://www.gca.gov.ps/new/]

National Institute for Training [http://www.niet.gov.ps/portal/]

Military Judicial Staff [http://www.tmj.gov.ps/]

High Council of Judicial [http://www.hjc.gov.ps/]

Security and Protection [http://www.spf.gov.ps/]

Government Computer Centre [http://www.spf.gov.ps/]

Integration of Government Data [http://www.takamul.gov.ps/]

National Security Forces [http://www.nsf.gov.ps/ar/]

Fatwa and Legislation Office [http://www.dft.gov.ps/]

Energy and National Resources Authority [http://penra.gov.ps/]

Political and Moral Guidance Commision [http://www.gca.gov.ps/new/]

Attorney General [http://www.gp.gov.ps/]

= Panama =

Civil Aeronautics Authority [http://www.aeronautica.gob.pa]

Agricultural Research Institute [http://www.idiap.gob.pa/]

Film Commission [http://pfc.mici.gob.pa]

Trade and Investment Agency [http://proinvex.mici.gob.pa]

Financial Analysis Unit for the Prevention of Money Laundering and Terrorist Financing [http://www.uaf.gob.pa]

Municipality of Santiago Veraguas [http://www.municipiosantiago.gob.pa/]

Municipality of Buguba [http://www.municipiobugaba.gob.pa/]

Municipality of Penonome [http://www.municipiopenonome.gob.pa/]

Municipality of David [http://www.municipiodavid.gob.pa/]

Capital Savings and Pension of Public Servants [http://www.siacap.gob.pa/]

= Papua New Guinea =

Bank of Papua New Guinea [http://www.bankpng.gov.pg/]

Investment Promotion Authority [http://www.ipa.gov.pg/]

National Disaster Centre [http://www.pngndc.gov.pg/]

Department of Environment and Conservation [http://www.dec.gov.pg/]

Office of Higher Education [http://www.ohe.gov.pg/]

= Paraguay =

Inter-organization Cooperation [http://www.opaci.org.py/]

Central Bank of Paraguay [http://www.bcp.gov.py/]

Ministry of Mines and Energy [http://www.ssme.gov.py]

General Children's Hospital [http://www.hgp.gov.py/]

National Civil Aeronautics [http://www.dinac.gov.py/]

= Perú =

Ministerio de la Producción de Perú [http://www.miempresa.gob.pe/]

Municipalidad distrital de Munihuarochiri [http://www.munihuarochiri.gob.pe/portal/]

Dirección de salud de Lima: [http://www.disavlc.gob.pe/portal/]

Banco Central de la Reserva de Perú: [http://www.bcrp.gob.pe]

Ministerio de Cultura [http://www.agn.gob.pe/portal/]

Instituto Nacional Telecomunicaciones [http://www.inictel-uni.edu.pe/]

Gobierno Regional de Moquegua [http://www.regionmoquegua.gob.pe/website/]

Gobierno Municipal de Puno [http://www.munipuno.gob.pe/muni2/]

Municipalidad Provincial Hualgayoc - Bambamarca [http://www.munibambamarca.gob.pe/]

Municipalidad Provincial de Pasco [http://www.munipasco.gob.pe/111/]

Municipalidad Provincial Yunguyo [http://www.muniyunguyo.gob.pe/portal/index.php]

Municipalidad de Simón Bolivar [http://www.munisimonbolivar.gob.pe/]

Municipalidad Distrital de Paucarpata [http://www.munipaucarpata.gob.pe/]

Municipalidad Distrital de Punta Negra [http://www.munipuntanegra.gob.pe/]

Municipalidad Distrital de Víctor Larco Herrera [http://www.munivictorlarco.gob.pe/joomlavictorlarco/]

Municipalidad Distrital de Paucartambo [http://www.munipaucartambopasco.gob.pe/]

Municipalidad Provincial de Canas [http://www.municanas.gob.pe/]

Programa de Compensación para la Competitividad [http://www.pcc.gob.pe]

Dirección Regional de Salud Pasco [http://www.diresapasco.gob.pe/]

Municipalidad Distrital de Colan [http://www.municolan.gob.pe/]

Dirección Regioan de Educación de Pasco [http://www.drepasco.gob.pe/]

= Philippines =

Cordillera, Regional Development [http://cordillera.gov.ph/]

Lapu-Lapu City [http://www.lapulapucity.gov.ph/]

Tupi, South Cotabato [http://www.tupi.gov.ph/]

PDEA - Philippine Drug Enforcement Agency [http://www.pdea.gov.ph]

= Poland=

Agencja Rynku Rolnego / Agricultural Market Agency [http://www.arr.gov.pl/]

Agricultural Advisory Centre in Brwinów [http://cdr.gov.pl/]

Civil Aviation Office [http://www.ulc.gov.pl/]

Communal Office Sztabin [http://www.sztabin.ug.gov.pl/]

Consumer Information Centre [http://www.cik.uke.gov.pl/]

I Congress of Agriculture Sciences "Science for Practice" [http://kongres.cdr.gov.pl/]

District Court in Białystok [http://www.bialystok.sr.gov.pl/]

District Court in Białystok [http://www.bialystok.sr.gov.pl/]

District Court in Busko Zdrój [http://bip.busko.sr.gov.pl/]

District Court in Kalisz [http://www.kalisz.so.gov.pl/]

District Court in Konin [http://www.konin.sr.gov.pl/]

District Court in Kielce [http://bip.kielce.sr.gov.pl/]

District Court in Krosno [http://www.krosno.sr.gov.pl/]

District Court in Olecko [http://www.olecko.sr.gov.pl/]

District Court in Szczecin [http://www.szczecin.so.gov.pl/]

District Court in Wrocław[http://www.wroclaw-krzyki.sr.gov.pl/]

District Prosecutor's Office in Tarnobrzeg [http://www.tarnobrzeg.po.gov.pl/]

District Prosecutor's Office in Zamosc [http://www.zamosc.po.gov.pl/]

ePUAP - Electronic Platform of Public Administration Services [http://www.e-puap.mswia.gov.pl/]

EURES POLAND - THE EUROPEAN JOBS NETWORK [http://www.eures.praca.gov.pl/en/]

European Information and Documentation Centre [http://libr.sejm.gov.pl/oide]

Government Legislation Centre [http://www.rcl.gov.pl/]

The Head Office of State Archives [http://www.archiwa.gov.pl/]

Institute of Atomic Energy [http://iea.cyf.gov.pl/]

Institute of Soil Science and Plant Cultivation [http://www.iung.pulawy.pl/]

Institute of Experimental and Clinical Medicine [http://www.biocentrumochota.gov.pl/]

Kampinoski Park Narodowy / National Park [http://www.kampinoski-pn.gov.pl/]

Kujawsko-Pomorski Voivodship Office [http://www.bydgoszcz.uw.gov.pl/]

Nadleśnictwo Bystrzyca Kłodzka (Polish State Forests) [http://wroclaw.lasy.gov.pl/]

National Archives in Poznan [http://www.poznan.ap.gov.pl/]

National Archives in Piotrków Trybunalski [http://www.piotrkow-tryb.ap.gov.pl/]

National Contact Point in Poland [http://en.kpk.gov.pl/]

The Necki Institute of Experimental Biology [http://neurogene.nencki.gov.pl/]

Ministry of National Education [http://www.men.gov.pl/]

Office of Electronic Communications in Poland (UKE) - Telecom Investment Support Team [http://www.investors.uke.gov.pl/]

Office of Electronic Communications (UKE) [http://www.en.prezydencja.uke.gov.pl/]

PARSP / Post-Accession Rular Support Project [http://www.ppwow.gov.pl/]

Police Headquarters in Chodzież [http://www.chodziez.policja.gov.pl/]

Police Headquarters in Bełchatów [http://www.belchatow.policja.gov.pl/]

Police Headquarters in Bochnia [http://www.bochnia.policja.gov.pl/]

Police Headquarters in Brzesko [http://www.brzesko.policja.gov.pl/]

Police Headquarters in Gniezo [http://www.gniezno.policja.gov.pl/]

Police Headquarters in Gostyń [http://www.gostyn.policja.gov.pl/]

Police Headquarters in Konin [http://www.konin.policja.gov.pl/]

Police Headquarters in Kościan [http://www.koscian.policja.gov.pl/]

Police Headquarters in Łęczyca [http://www.leczyca.policja.gov.pl/]

Police Headquarters in Leszno [http://www.leszno.policja.gov.pl/]

Police Headquarters in Łódź [http://www.lodz.policja.gov.pl/]

Police Headquarters in Nowy Targ [http://www.nowy-targ.policja.gov.pl/]

Police Headquarters in Nowy Sącz [http://www.nowy-sacz.policja.gov.pl/]

Police Headquarters in NowyTomyśl [http://www.nowy-tomysl.policja.gov.pl/]

Police Headquarters in Oborniki [http://www.oborniki.policja.gov.pl/]

Police Headquarters in Opoczno [http://www.opoczno.policja.gov.pl/]

Police Headquarters in Opole / Komenda Wojewódzka Policji w Opolu [http://www.opolska.policja.gov.pl/]

Police Headquarters in Ostrzeszów [http://www.ostrzeszow.policja.gov.pl/]

Police Headquarters in Radomsko [http://www.radomsko.policja.gov.pl/]

Police Headquarters in Piła [http://www.pila.policja.gov.pl/]

Police Headquarters in Poznań [http://www.poznan.policja.gov.pl/]

Police Headquarters in Skierniewice [http://www.skierniewice.policja.gov.pl/]

Police Headquarters in Środa Wielkopolska [http://www.sroda-wielkopolska.policja.gov.pl/]

Police Headquarters in Zakopane [http://www.zakopane.policja.gov.pl/]

Polish Centre for Testing and Certification [http://www.pcbc.gov.pl/]

Portal of Polish Geological Institute [http://ikar2.pgi.gov.pl/]

Refugee Board[http://www.rada-ds-uchodzcow.gov.pl/]

Regional Office for Water Management in Gliwice [http://www.gliwice.rzgw.gov.pl/]

The Regional Water Management Board in Krakow [http://www.krakow.rzgw.gov.pl/]

State Archive in Kalisz [http://www.kalisz.ap.gov.pl/]

Warmińsko-Mazurskie Voivodship Office in Olsztyn. [http://www.olsztyn.uw.gov.pl/]

= Portugal =

UMIC - Agência para a Sociedade do Conhecimento [http://www.umic.pt/]

Escola Básica Integrada de Ribeira Grande [http://escolas.edu.azores.gov.pt/ebirg/]

Serviço de Resposta a Incidentes de Segurança Informática [http://www.forumsi.gov.pt/]

Secretaria-Geral do Ministério da Cultura [http://www.sg.mc.gov.pt/]

Rede Gip Imigrante [http://redeuniva.acidi.gov.pt/]

Secretária de Estado da Modernização Administrativa [http://www.gsema.gov.pt/index.php?lang=pt]

Conferência Ministerial de eGovernment [http://www.megovconf-lisbon.gov.pt/index.php?lang=pt]

Biblioteca Nacional de Portugal [http://www.bn.gov.pt/index.php?option=com_content&view=frontpage&Itemid=1&lang=pt]

Clube Desportivo Escolar de Santa Maria [http://kiosk.ebssm.edu.azores.gov.pt:8080/cde/index.php]

= Puerto Rico =

Office of the Commissioner Insurance [http://www.ocs.gobierno.pr/]

Aguadilla City [http://www.aguadilla.gobierno.pr]

= Qatar =

Institute of Administrative Development [http://www.iad.gov.qa/]

= Republic of Macedonia =

Ministry of Culture [http://www.kultura.gov.mk/]

Bureau of Metrology [http://www.bom.gov.mk/]

Hydrometeorological Service [http://www.meteo.gov.mk/]

Institute for the Accreditation of the Republic of Macedonia [http://www.iarm.gov.mk/]

Energy Agency [http://www.ea.gov.mk/]

World Conference on Dialogue Among Religions and Civilizations [http://www.worldconferenceohrid.kultura.gov.mk/]

National Heritage Centre [http://www.heritage.gov.mk/]

State Market Inspectorate [http://dpi.gov.mk/]

State Attorney[http://www.drzavnopravobranitelstvo.gov.mk/]

Centre for Adult Education [http://cov.gov.mk/]

Unit for Cooperation with NGO [http://www.nvosorabotka.gov.mk/]

Municipality Berovo [http://www.berovo.gov.mk/]

Municipality Brod [http://www.mbrod.gov.mk/]

Municipality Brvenica [http://www.brvenica.gov.mk/]

Municipality Butel [http://www.opstinabutel.gov.mk/]

Municipality of Gevgelija [http://gevgelija.gov.mk/]

Municipality Karpos [http://www.karpos.gov.mk/]

Municipality Lovech and Rostusa [http://www.mavrovoirostuse.gov.mk/]

Municipality Mogila [http://mogila.gov.mk/web/]

Municipality of Novo Selo [http://www.novoselo.gov.mk/]

Municipality Osslome [http://www.osllome.gov.mk/]

Municipality Pehcevo [http://www.pehcevo.gov.mk/]

Municipality Radovis[http://radovis.gov.mk/]

Municipality Rankovce [http://rankovce.gov.mk/web/]

Municipality Sopiste [http://opstinasopiste.gov.mk/]

Municipality Studenicani [http://www.studenicani.gov.mk/]

Municipality Valandovo [http://www.valandovo.gov.mk/]

= Romania =

National Institute for Public Health [http://www.insp.gov.ro/]

National Authority for Consumer Protection [http://www.anpc.gov.ro/]

= Russian Federation =

Department of Civil Service Tomsk [http://gossl.tomsk.gov.ru/]

Office of Drug Control Service of Russia in Moscow region [http://www.50.fskn.gov.ru/]

Official website of the Ombudsman in the Russian Federation [http://ombudsmanrf.org/]

Social Security Department of the Tomsk region [http://socialwork.tomsk.gov.ru/]

Tatischevskogo municipal [http://tatishevo.saratov.gov.ru/]

= Rwanda =

Rwandan Parliament [http://www.parliament.gov.rw/]

Office of the Prime Minister [http://www.primature.gov.rw/]

Ministry of Sports and Culture [http://www.minispoc.gov.rw/]

Ministry of Health [http://www.moh.gov.rw/]

Ministry of Agriculture and Animal Resources [http://www.minagri.gov.rw/]

Ministry of Infrastructure [http://www.mininfra.gov.rw/]

National Unity and Reconciliation Commission [http://www.nurc.gov.rw/]

National Institute of Statistics [http://statistics.gov.rw/]

Rwandan Development Partners [http://www.devpartners.gov.rw/]

National Executive Secretariat of TIG [http://www.tig.minijust.gov.rw/]

15 Years of Liberation [http://www.gov.rw/liberation15/]

= Samoa =

Ministry of Education [http://www.mesc.gov.ws]

= San Marino =

Central Bank [http://www.bcsm.sm/]

= Saudi Arabia =

Computer Emergency Response Centre [http://www.cert.gov.sa/]

Ministry of Education [http://www.cpfdc.gov.sa/]

Ministry of Health eHealth Strategy [http://www.moh.gov.sa/ehealth/]

= Senegal =

Ministry of Foreign Affairs [http://www.diplomatie.gouv.sn/]

Ministry of the Interior [http://www.interieur.gouv.sn/]

Ministry of Justice [http://www.justice.gouv.sn/]

Ministry of Mines, Industry, Agro Industry and SMEs [http://www.industrie.gouv.sn/]

Ministry for the Family [http://www.famille.gouv.sn/]

Ministry of Agriculture [http://www.agriculture.gouv.sn/]

Ministry of Youth [http://www.jeunesse.gouv.sn/]

APDA: Agency for the Promotion and Development of Handicraft [http://www.apda.gouv.sn/]

= Serbia =

Ministry of Labour and Social Policy [http://www.minrzs.gov.rs/cms/]

Ministry of Science and Technological Development [http://www.nauka.gov.rs/]

Radiation Protection and Nuclear Safety Agency [http://www.srbatom.gov.rs/]

Municipality Ljig [http://www.ljig.gov.rs/]

Provincial Secretariat for Regional and International Cooperation [http://www.region.vojvodina.gov.rs/]

Provincial Secretariat for Education[http://www.obrazovanje.vojvodina.gov.rs/]

Government of the Autonomous Province of Vojvodina [http://www.vojvodina.gov.rs/]

= Seychelles =

Ministry of Finance [http://www.finance.gov.sc]

Office of the President [http://www.statehouse.gov.sc]

Department of Employment [http://www.employment.gov.sc]

National Assembly [http://www.nationalassembly.sc/]

= Sierra Leone =

Office of the President [http://www.statehouse.gov.sl/]

Ministry of Finance and Economic Development [http://www.mofed.gov.sl/]

Ministry of Foreign Affairs and International Cooperation [www.foreignaffairs.gov.sl]

Ministry of Youth and Sports [http://education.gov.sl]

Office of the Diaspora [http://www.diasporaaffairs.gov.sl/]

National HIV/Aids Secretariat [http://www.nas.gov.sl/]

= Singapore =

National Parks Singapore [http://www.nparks.gov.sg/cms/]

National Community Leadership Institute [http://www.nacli.pa.gov.sg/]

Outward Bound Singapore [http://www.obs.pa.gov.sg/]

= Slovakia =

National Property Fund [http://www.natfund.gov.sk/]

Regional Office for Road Transport [http://www.tt.kud.gov.sk/]

= Slovenia =

Ministry of Public Administration [http://www.otroci.gov.si/]

National portal for seniors and pensioners [http://www.starejsi.gov.si/]

= Solomon Islands =

Telecommunications Commission[http://www.tcsi.org.sb/]

= Somalia =

The Central Bank of Somalia [http://www.somalbanca.org/]

= South Africa =

National Youth Development Agency [http://www.nyda.gov.za/]

City of Johannesburg [http://joburg.org.za]

Province of the Northern Cape [http://www.northern-cape.gov.za/]

Province of the Eastern Cape - Transport [http://www.ectransport.gov.za/]

Corporate Governance and Traditional Affairs [http://www.cogta.gov.za/]

Department of Communications [http://www.doc.gov.za/]

Department of Social Development [http://www.dsd.gov.za/]

Limpopo Department of Agriculture [http://www.lda.gov.za/]

Presidential National Commission on Information Society & Development [http://www.pnc.gov.za/]

= South Korea =

Embassy of The Republic of Azerbaijan to the Republic of Korea [http://www.azembassy.co.kr/]

= Spain =
=== City/Town Halls ===
''(NOTE: Bold indicates big town / city >40K)''

Ayuntamiento de Aguilar de Campoo [http://aguilardecampoo.com]

Ayuntamiento de Agulo [http://agulo.org/apli/index.php]

Ayuntamiento de Alajeró [http://www.ayuntamientoalajero.es/]

Ayuntamiento de Alanís [http://informacion.alanis.es/]

'''Ayuntamiento de Alcalá de Guadaíra''' [http://www.ciudadalcala.org/portal/]

Ayuntamiento de Alcolea de Calatrava [http://www.alcoleacva.com/]

Ayuntamiento de Aldeadávila [http://www.aldeadavila.com/]

Ayuntamiento de Algodonales [http://www.algodonales.es/]

Ayuntamiento de Aljaraque [http://www.ayto-aljaraque.es/]

Ayuntamiento de Antigua [http://www.ayto-antigua.es/]

Ayuntamiento de Añora [http://www.anora.es/joomla/index.php]

Ayuntamiento de Aracena [http://www.aracena.es/]

Ayuntamiento de Arraitz-Orkin [http://www.arraitz-orkin.com/]

Ayuntamiento de Artenara [http://www.artenara.es/]

Ayuntamiento de Bailén [http://www.ayto-bailen.com/]

Ayuntamiento de Belalcázar [http://www.belalcazar.es/]

Ayuntamiento de Belchite [http://www.belchite.es/]

Ayuntamiento de Breña Baja [http://www.bbaja.es/web/]

Ayuntamiento de Campo de Criptana [http://www.campodecriptana.es/]

Ayuntamiento de Caravaca de la Cruz [http://www.caravaca.org/]

Ayuntamiento de Castrelo do Val [http://www.castrelodoval.com/index.php]

Ayuntamiento de Cella [http://www.cella.es/]

'''Ayuntamiento de Córdoba''' [http://www.ayuncordoba.es/]

Ayuntamiento de El Paso [http://www.elpaso.es/ayto/]

Ayuntamiento de El Tanque [http://www.eltanque.es/]

Ayuntamiento de El Viso (Córdoba) [http://www.ayto-elviso.com/site/index.php]

Ayuntamiento de Espartinas [http://www.espartinas.net/]

Ayuntamiento de Fasnia [http://www.fasnia.com/]

Ayuntamiento de Fregenal de la Sierra [http://www.fregenaldelasierra.es/]

Ayuntamiento de Granadilla de Abona [http://www.granadilladeabona.org/]

Ayuntamiento de Guadalmez [http://www.aytoguadalmez.com/site/index.php]

Ayuntamiento de Guardamar [http://www.guardamar.net/index.php]

Ayuntamiento de Guimar [http://www.guimar.es/]

Ayuntamiento de Ingenio [http://www.ingenio.es/index.php]

Ayuntamiento de Jimena de la Frontera [http://www.jimenadelafrontera.es/]

Ayuntamiento de Hermigua [http://www.hermigua.org/]

Ayuntamiento de Huelma [http://www.aytohuelma.es/nuevaweb/index.php]

Ayuntamiento de Illescas [http://www.illescas.es/joomla/]

Ayuntamiento de la Victoria de Acentejo [http://www.lavictoriadeacentejo.es/]

Ayuntamiento de la Villa de La Matanza de Acentejo [http://www.matanceros.com/]

Ayuntamiento de la Villa de Tegueste [http://www.tegueste.org/]

Ayuntamiento de Las Cabezas de San Juan [http://www.lascabezasdesanjuan.es/web/]

Ayuntamiento de Las Torres de Cotillas [http://www.lastorresdecotillas.net/]

Ayuntamiento de Los Llanos de Aridane [http://www.aridane.org/inicio/index.php]

Ayuntamiento de Macharaviaya [http://www.macharaviaya.es/]

Ayuntamiento de Madridejos [http://www.madridejos.es/]

Ayuntamiento de Madrigal de la Vera [http://madrigaldelavera.es/]

Ayuntamiento de Malagon [http://www.malagon.es/]

'''Ayuntamiento de Marbella''' [http://www.marbella.es/inicio/]

'''Ayuntamiento de Mérida''' [http://www.merida.es/]

Ayuntamiento de Mogán [http://www.mogan.es/]

Ayuntamiento de Mogarraz (Salamanca) [http://www.mogarraz.es/]

Ayuntamiento de Niebla [http://www.aytoniebla.es/portal/index.php]

Ayuntamiento de Pájara [http://www.pajara.es/]

Ayuntamiento de Palomares del Río [http://www.palomaresdelrio.net/]

Ayuntamiento de Peñaflor de Gállego [http://www.penaflordegallego.com/joomla/]

Ayuntamiento de Pepino [http://www.ayto-pepino.com/joomla/]

Ayuntamiento de Plasencia [http://www.plasencia.es/web/index.php]

Ayuntamiento de Puebla de Don Rodrigo [http://www.ayuntamientopuebladedonrodrigo.com/]

Ayuntamiento de Puerto de la Cruz [http://www.puertodelacruz.es/]

Ayuntamiento de Quel [http://www.quel.org/joomla/]

Ayuntamiento de San Bartolomé [http://www.sanbartolome.es/web/]

Ayuntamiento de San Bartolomé de Tirajana [http://www.maspalomas.com/]

Ayuntamiento de San Juan de la Rambla [http://www.aytosanjuandelarambla.es/]

Ayuntamiento de San Martín de la Vega [http://www.ayto-smv.es/2011/]

Ayuntamiento de San Martín de Montalbán [http://sanmartindemontalban.com/ayuntamiento/]

Ayuntamiento de San Miguel de Abona [http://sanmigueldeabona.es/]

Ayuntamiento de San Sebastián de la Gomera [http://www.sansebastiangomera.org/]

Ayuntamiento de Santa Brígida [http://www.santabrigida.es/]

Ayuntamiento de Santa María de Guía de Gran Canaria [http://www.santamariadeguia.es/]

Ayuntamiento de Segura de León [http://www.seguradeleon.com/]

Ayuntamiento de Soto del Real [http://www.ayto-sotodelreal.es/web/]

Ayuntamiento de Tazacorte [http://www.tazacorte.es/ayto/]

Ayuntamiento de Tejeda [http://www.tejeda.es/Ciudadano/]

Ayuntamiento de Telde [http://www.ayuntamientodetelde.org/]

Ayuntamiento de Tijarafe [http://www.tijarafe.es/]

Ayuntamiento de Tórtola de Henares [http://www.tortoladehenares.es/]

Ayuntamiento de Tuineje [http://www.tuineje.es/]

Ayuntamiento de Ubrique [http://www.ayuntamientoubrique.es/]

Ayuntamiento de Valderrubio [http://www.valderrubio.net/]

Ayuntamiento de Valle Gran Rey [http://www.vallegranrey.es/]

Ayuntamiento de Valleseco [http://www.valleseco.es/]

Ayuntamiento de Valsequillo de Gran Canaria [http://www.valsequillogc.es/ayto/]

Ayuntamiento de Vega de San Mateo [http://www.vegadesanmateo.es/]

Ayuntamiento de Vegas del Genil [http://www.aytovegasdelgenil.org/]

Ayuntamiento de Villa de Mallén [http://www.villademallen.com/joomla/]

Ayuntamiento de Villa de Quer [http://www.ayuntamientodequer.es/]

Ayuntamiento de Villanueva de Córdoba [http://www.villanuevadecordoba.com/www/index.php]

Ayuntamiento de Villanueva del Trabuco [http://www.villanuevadeltrabuco.com/]

Ayuntamiento de Villaquilambre [http://www.ayto-villaquilambre.com/Pagina_de_inicio]

=== Chambers of Commerce ===

Cámara Oficial de Comercio e Industria de Alcoy [http://www.camaraalcoy.net/]

Cámara Oficial de Comercio e Industria de Arévalo [http://www.camaradearevalo.com/]

Cámara Oficial de Comercio e Industria de Ávila [http://www.camaradeavila.com/]

Cámara Oficial de Comercio e Industria de Badajoz [http://camarabadajoz.org/index.php]

Cámara Oficial de Comercio e Industria de León [http://www.camaraleon.com/]

Cámara Oficial de Comercio e Industria de Linares [http://www.camaralinares.es/]

Cámara Oficial de Comercio, Industria y Navegación de Pontevedra [http://www.camarapontevedra.com/joomla/]

=== Educational ===

Centro Nacional de Desarrollo Curricular en Sistemas no Propietarios (CeDeC) [http://cedec.ite.educacion.es/]

Consejería de Educación, Ciencia y Cultura de Castilla-La Mancha - Portales web de los Centros Educativos [http://edu.jccm.es]

Consejería de Educación de la Comunidad de Madrid - Formación del Profesorado en línea [http://formacion.enlinea.educa.madrid.org/]

Consejería de Educación de la Junta de Extremadura - Portal de Centros Educativos de la [http://portalcentros.educarex.es/]

Consejería de Educación de la Junta de Extremadura - Rincones Didácticos [http://rincones.educarex.es/]

Consejería de Educación y Ciencia del Gobierno del Principado de Asturias - Educastur [http://www.educastur.es/]

Instituto de Arqueología de Mérida [http://www.iam.csic.es/]

Observatorio de la actividad, la innovación y las tendencias en la Formación en Red SCOPEO [http://scopeo.usal.es/]

Observatorio para la calidad del e-Learning en Andalucía [http://prometeo.us.es/qualitas/]

=== Political Parties ===
(''NOTE: In alphabetical order, and up to a maximum of 3 per party, to avoid favoritism'')

Fundación Progreso y Democracia [http://www.fpyd.es/]

Izquierda Unida de Albacete [http://www.iualbacete.es/]

Izquierda Unida de Extremadura [http://www.iu-extremadura.es/]

Izquierda Unida de Tenerife [http://www.iutenerife.org/]

Partido Pirata [http://www.partidopirata.es/]

Partido Popular de Andalucía [http://www.ppandaluz.es/]

Partido Popular de Canarias [http://ppdecanarias.com/]

Partido Popular de Málaga [http://www.ppmalaga.es/]

Partido Socialista Obrero Español de Extremadura [http://www.psoeextremadura.org/portal/]

Partido Socialista Obrero Español de Murcia [http://murciapsoe.es/]

Partido Socialista Obrero Español de Ronda [http://www.psoederonda.es/psoeronda/index.php]

=== Others ===

CENATIC - Centro Nacional de Referencia de Aplicación de las Tecnologías de la Información y la Comunicación basadas en fuentes abiertas [http://www.cenatic.es/]

Consejo de Seguridad Nuclear [http://www.csn.es/]

Instituto Gallego de Promoción Económica [http://www.igape.es/index.php]

Dirección General de Trabajo y Empleo del Gobierno de Cantabria [http://dgte.cantabria.es/]

Agencia Provincial de la Energía de Cádiz [http://www.fmedioambienteyenergia.es/apec/]

Red de Espacios Tecnológicos de Andalucía [http://reta.es/index.php/inicio.html]

Instituto Municipal de Formación y Empleo de Granada [http://www.imfegranada.es/web/]

Consejo Consultivo de la Comunidad de Madrid [http://www.ccmadrid.org/ccmadrid/]

Instituto de Investigación en Energía de Cataluña [http://www.irec.cat/]

= Sri Lanka =

Government of Sri Lanka [http://www.gov.lk/gov/]

Government Information Centre [http://www.gic.gov.lk/]

Ministry of Justice [http://www.wpc.gov.lk/demo/]

Ministry of Higher Education [http://www.mohe.gov.lk/]

Ministry of External Affairs [http://www.slmfa.gov.lk/]

Ministry of Transport [http://www.transport.gov.lk/]

Department of Immigration and Emigration [http://www.immigration.gov.lk/]

University Grants Commission [http://www.ugc.ac.lk/]

Western Province Regional Council [http://www.wpc.gov.lk/]

Department of Pensions [http://www.pensions.gov.lk/]

= St. Kitts & Nevis =

Nevis Island Government [http://www.nia.gov.kn/]

= St. Lucia =

Ministry of Education and Culture [http://www.education.gov.lc]

= St. Vincent and the Grenadines =

Government of St Vincent and the Grenadines [http://www.gov.vc]

Ministry of Foreign Affairs [http://www.foreign.gov.vc/]

Ministry of Housing [http://www.housing.gov.vc/]

Ministry of Health, Wellness and the Environment [http://www.health.gov.vc/]

Ministry of Finance and Economic Planning [http://www.finance.gov.vc/]

= Sudan =

The Republic of Sudan Secretariat General [http://www.sudan.gov.sd/]

Ministry of the Presidency Affairs [http://www.presidency.gov.sd/]

Ministry of Tourism [http://sudan-tourism.gov.sd/]

Ministry of Information and Communications [http://www.minic.gov.sd/]

Ministry of Irrigation and Water resources [http://www.moiwr.gov.sd/]

Ministry of Science and Technology [http://www.most.gov.sd/]

= Surinam =

Ministry of ATM [http://www.atm.gov.sr/]

Ministry of Trade and Industry [http://www.minhi.gov.sr/]

= Swaziland =

Central Bank [http://www.centralbank.org.sz/]

National Sports Council [http://www.sportscouncil.org.sz/]

= Sweden =

Fagersta kommun [http://www.fagersta.se/]

Norberg kommun [http://www.norberg.se/]

= Syria =

Portal for Rural Syria [http://www.reefnet.gov.sy/reef/]

Syrian Post [http://www.syrianpost.gov.sy/]

General Organisation for Road Transport [http://www.perc.gov.sy/]

National Service Network [http://www.nans.gov.sy/]

Higher Institute for Demograghic Studies & Research [http://www.hidsr.gov.sy/site/]

Industrial Bank [http://www.industrialbank.gov.sy/]

State Council [http://www.cos.gov.sy/]

Damascus University [http://www.damascusuniversity.gov.sy/]

General Establishment of Road Transportation [http://www.perc.gov.sy/moc/]

Export Development and Promotion Agency [http://www.edpa.gov.sy/ar/]

Community Portal [http://www.reefnet.gov.sy/reef/]

Management of the Badia Development [http://gcb.gov.sy/ar/]

Arab Advertising Organisation [http://www.elan.gov.sy/]

= Taiwan =

Construction and Planning Agency [http://www.cpami.gov.tw/english/]

International Taiwan Service Portal (CT) [http://www.i-taiwan.nat.gov.tw/ct]

International Taiwan Service Portal (EN) [http://www.i-taiwan.nat.gov.tw/en]

Taijiang National Park [http://www.tjnp.gov.tw/]

= Tajikistan =

Parliament [http://parlament.tj/]

Ministry of Transport and Communication [http://www.mintranscom.tj/]

Ministry of Health [http://health.tj/]

Customs Service [http://www.customs.tj/]

Constitutional Court [http://www.constcourt.tj/]

State Committee on Investments [http://amcu.gki.tj]

Agency of Regulation of Communication [http://www.arc.tj/]

Investment Council [http://www.investmentcouncil.tj/]

= Tanzania =

Mbeya Region [http://www.mbeya.go.tz/]

Ministry of Finance [http://www.mof.go.tz/]

Ministry of Home Affairs [http://www.moha.go.tz/]

Ministry of Information, Culture and Sports [http://www.hum.go.tz/]

Tanzania Revenue Authority [http://www.tra.go.tz/]

National Council for Technical Education [http://www.nacte.go.tz/]

UNESCO National Commission [http://www.natcom.go.tz/]

Bank of Tanzania Training Institute [http://www.bot.go.tz/TrainingInstitute/]

Higher Education Student's Loans Board [http://www.heslb.go.tz/]

= Tchad =

Government of Tchad [http://www.primature-tchad.org/]

= Thailand =

Ministry of Science and Technology [http://www.most.go.th/main]

Mae Hong Son Province [http://www.maehongsorn.go.th]

National Science and Technology Development Agency [http://www.nstda.or.th]

National Electronics and Computer Technology Center [http://www.nectec.or.th]

The National Telecommunications Commission [http://eng.ntc.or.th]

Krabi Prolice [http://www.krabipolice.go.th]

The Secondary Education Service Area 20 [http://www.sesa20.go.th/]

National Research Counil of Thailand [http://www.nrct.go.th]

Department of Medical Sciences [http://www.dmsc.moph.go.th/dmsc2010/]

Chiangmai Provincial Labour Protection and Welfare Office [http://chiangmai.labour.go.th]

= Togo =

Prime Minister [http://www.primature.gouv.tg/]

Ministry of Foreign Affairs and Cooperation [http://www.diplomatie.gouv.tg/]

Ministry of Economy and Finance [http://www.finances.gouv.tg/]

Ministry of Public Service and Administrative Reform [http://fonctionpublique.gouv.tg/]

Ministry of Planning and Development [http://planification.gouv.tg/]

= Tonga =

Main Government website [https://www.pmo.gov.to/]

Parliament of Tonga [http://www.parliament.gov.to/]

Ministry of Commerce [http://mlci.gov.to/]

Ministry of Information and Communications [http://www.mic.gov.to/]

Ministry of Foreign Affairs and Cooperation [http://www.diplomatie.gouv.tg/]

Ministry of Civil Service [http://fonctionpublique.gouv.tg/]

Ministry of Planning, Development and Planning [http://planification.gouv.tg/]

Official Web Site of The Tongan Monarchy [http://www.palaceoffice.gov.to/]

Ministry of Education, Women Affairs and Culture [http://www.tongaeducation.gov.to/]

Department of Statistics [http://www.pmo.gov.to/tongastats/]

= Trinidad and Tobago =

The Ministry of Food Production, Land and Marine Affairs [http://www.agriculture.gov.tt/]

Tobago House of Assembly [http://www.tha.gov.tt/]

Ministry of Agriculture, Land and Marine Resources [http://agri.gov.tt/home/]

Division of Health and Social Services [http://www.dhsstha.gov.tt/]

= Tunisia =

Main country website [http://www.ministeres.tn/]

President of Tunisia [http://www.carthage.tn/en/index.php]

Ministry of Agriculture and Environent [http://www.apia.com.tn/]

Ministry of National Defence [http://www.defense.tn/]

Office of Tunisians Abroad [http://www.ote.nat.tn/ote_fr/]

= Turkey =

Governorship of Kocaeli - EU Projects Coordination Center [http://www.kocaeliab.gov.tr/]

Governorship of Ordu [http://www.ordu.gov.tr/]

Çankırı Youth Centre[http://www.cankiri-gm.gov.tr/]

Malatyadh State Hospital [http://www.malatyadh.gov.tr/giris/]

Omer Nalbantoğlu Training Dormitory [http://aksarayshcekyurdu.gov.tr/]

Mufti Kahta [http://www.kahtamuftulugu.gov.tr/]

Sirnak Revenue [http://www.sirnakdefterdarligi.gov.tr/]

Adiyaman Mentally Handicapped Rehabilitation and Education Center [http://www.adiyaman80yilrem.gov.tr/]

Board of Higher Education [http://www.yok.gov.tr/]

Youth Centres [http://hakkari-gm.gov.tr/]

Muftumuz District [http://www.gemlikmuftulugu.gov.tr/]

Sultangazi City [http://sultangazi.gov.tr/]

Duzce Ataturk State Hospital [http://www.dadh.gov.tr/]

Kayseri Youth Center [http://www.kayseri-gm.gov.tr/]

Izmir Port Authority [http://www.izmirdenizcilik.gov.tr/]

Topcali Village [http://www.topcali-muh.gov.tr/]

Yenikent Public Education [http://www.yenikenthem.gov.tr/]

Malatya City [http://www.malatya-gsim.gov.tr/]

Narlidere Municipality [http://narlidere-bld.gov.tr/narlidere/]

Gemlik District [http://www.gemlikmuftulugu.gov.tr/]

Eregli District Directorate of Agriculture [http://ereglitarim.gov.tr/]

Bolu Provincial Disaster and Emergency Management [http://www.boluafetacil.gov.tr/]

Uskudar State Hospital [http://www.uskudarhastanesi.gov.tr/]

= Turkmenistan =

Chamber of Commerce and Industry [http://www.cci.gov.tm/en/]

Avaza National Tourist Zone [http://www.avaza.gov.tm/]

State Concern Turkmenavtoyollary [http://turkmenawtoyollary.gov.tm/ru/]

= Tuvalu =

Tuvalu Legislation [http://www.tuvalu-legislation.tv/]

= Uganda =

Uganda Parliament [http://www.parliament.go.ug]

Ministry of Health [http://www.health.go.ug]

Ministry of Information and Communications Technology [http://www.ict.go.ug]

National Banana Research Program [http://www.banana.go.ug]

National Education Support Center [http://www.unesc.go.ug]

Ministry of Justice and Constitutional Affairs [http://www.justice.go.ug]

Ministry of Foreign Affairs [http://www.mofa.go.ug]

National Council for Science and Technology [http://www.uncst.go.ug]

National Integrated Monitoring and Evaluation Strategy [http://www.nimes.go.ug]

Ministry of Water and Environment [http://www.mwe.go.ug]

Judiciary of Uganda [http://www.judicature.go.ug]

Igana District [http://www.iganga.go.ug]

Bushenyi District [http://bushenyi.go.ug]

Mayuge District [http://mayuge.go.ug]

Uganda Police Force [http://www.upf.go.ug]

National Roads Authority [http://www.unra.go.ug]

= Ukraine =

Lviv City [http://www.city-adm.lviv.ua]

Hlobynskoyi City Council [http://www.globyne-rada.gov.ua/]

State Organisation Works [http://rekord.gov.ua/]

State Scientific Institution [http://www.clinic-1.gov.ua/]

Burinska District [http://burin-rada.gov.ua/]

Renyyskoy rayonnoy State Administration [http://reni-rda.gov.ua/]

Berehiv District [http://bereg-rda.gov.ua/]

State Agency for Science, Innovation and Information [http://www.dknii.gov.ua/]

State Prison Service [http://dps-sumy.gov.ua/]

State Agency of Ukraine Water Resources [http://www.scwm.gov.ua/]

= United Kingdom =

Ministry of Defense [http://www.stabilisationunit.gov.uk]

Serious Organised Crime Agency [http://SOCA.gov.uk]

UK Foreign Office Awards ceremony [http://www.foreignofficeawards.co.uk/]

UK Parliamentary Press Gallery [http://www.pressgallery.org.uk/]

Department for Environment & Rural Affairs [http://publicappts.defra.gov.uk/]

Strathclyde Police Authority [http://www.strathclydepoliceauthority.gov.uk/]

Salisbury City Council [http://www.salisburycitycouncil.gov.uk/]

Stroud Town Council [http://www.stroudtown.gov.uk/]

Thame Town Council [http://www.thametowncouncil.gov.uk/]

Central Scotland Fire and Rescue Service [http://www.centralscotlandfire.gov.uk/]

Office of Qualifications and Examinations Regulation [http://www.ofqual.gov.uk/]

Sustainable Development in Government [http://sd.defra.gov.uk/]

Sandwell and West Birmingham Hospitals NHS Trust [http://www.swbh.nhs.uk/]

The Scottish Adult Neuro-Oncology Network [http://www.neurooncology.scot.nhs.uk/]

South Central Clinical Networks (NHS) [http://www.scnetworks.nhs.uk/]

Bassetlaw NHS [http://www.bassetlaw-pct.nhs.uk/]

National Procurement [http://www.nhsscotlandprocurement.scot.nhs.uk/]

Tetbury Town Council [http://www.tetbury.gov.uk/]

Wiltshire Police [http://www.wiltshire.police.uk/]

Bristol Community Health [http://www.briscomhealth.nhs.uk/]

= United Arab Emirates =

General Authority of Youth and Sport Welfare [http://www.uaeyouth.gov.ae/]

Department of Civil Defence [http://www.dcd.gov.ae/]

Ajman Free Zone [http://www.afza.gov.ae/]

Dubai Export Development Corporation [http://www.dedc.gov.ae/]

= United States of America =

== Federal Agencies ==

US Air Force AFPIMS Resource Center [http://training.afnews.af.mil]

Interagency Resources Management Conference [http://www.irmco.gov]

NASA Laser Vegetation Imaging Sensor [https://lvis.gsfc.nasa.gov]

NASA Virtual Magnetospheric Observatory [http://vmo.nasa.gov]

Standard Labor Data Collection and Distribution Application [https://www.sldcada.disa.mil]

US Commission on International Religious Freedom [http://www.uscirf.gov]

NOAA Large Marine Ecosystems of the World [http://www.lme.noaa.gov]

NOAA Coral Health and Monitoring Program [http://www.coral.noaa.gov]

US Group on Earth Observations [http://www.usgeo.gov]

US Department of Agriculture - Coastal Commission [http://www.coastalamerica.gov]

US Bankruptcy Court District of Kansas [http://www.ksb.uscourts.gov]

US Army Architecture [http://architecture.army.mil/]

US Army Corp of Engineers, Los Angeles [http://www.spl.usace.army.mil]

US Army Enterprise Solutions Competency Center [http://escc.army.mil]

US Navy Standard Labor Data Collection and Distribution Application [https://www.sldcada.disa.mil]

US Central Command [http://www.centcom.mil]

US Military Leadership Diversity Commission [http://mldc.whs.mil]

US Department of Defense Sexual Assault Prevention and Response Office [http://www.sapr.mil]

US Court of Appeals for the Federal Circuit [http://www.cafc.uscourts.gov]

US Global Change Research Program [http://www.globalchange.gov]

US District Court Oregon [http://www.ord.uscourts.gov]

== Alaska ==

Denali Commission [http://www.denali.gov]

== California ==

Commission on the Status of Women [http://women.ca.gov/]

Calexico [http://www.calexico.ca.gov]

Port of San Diego [http://www.portofsandiego.org/]

== Colorado ==

City of Boulder [http://www.bouldercolorado.gov/]

== Florida ==

Orange County Comptroller [http://www.occompt.com]

Space Florida [http://www.spaceflorida.gov/]

City of Sebastian [http://www.cityofsebastian.org/]

Sebastian Police Department [http://www.sebastianpd.org/]

City of Sebastian Economic Development [http://sebastianbusiness.org/]

City of Sebastian Municipal Golf Course [http://www.sebastiangolfcourse.org/]

City of Sebastian Municipal Airport [http://www.sebastianairport.org/]

City of Sebastian Retirement Site [http://sebastianretirement.com/]

== Georgia ==

City of Atlanta Geographic Information System (GIS) [http://gis.atlantaga.gov/gishome/]

City of Dalton [http://www.cityofdalton-ga.gov/]

Counsil of State Court Judges [http://www.statecourt.georgiacourts.gov/]

== Guam ==

Department of Labor [http://www.dol.guam.gov]

== Hawaii ==

City and County of Honolulu's Department of Transportation Services (DTS) [http://citytransportationhonolulu.com/]

== Iowa ==

Iowa Department of Education [http://www.iowa.gov/educate]

Iowa Insurance Division - Flood Awareness [http://www.donttestthewatersiowa.gov]

Iowa College Student Aid Commission [http://www.iowacollegeaid.gov]

== Illinois ==

Heyworth [http://www.heyworth-il.gov]

Mattoon [http://mattoon.illinois.gov]

== Indiana ==

City of Richmond [http://richmondindiana.gov]

== Kansas ==

Kansas Racing and Gaming Commission [http://krgc.ks.gov]

City of Emporia [http://www.emporia-kansas.gov]

== Kentucky ==

Frankfort Transit [http://transit.frankfort.ky.gov]

== Maryland ==

Baltimore Police [http://www.baltimorepolice.org/]

== Minnesota ==

Minnesota Pollution Control Agency [http://www.pca.state.mn.us]

Minnesota Management & Budget [http://www.mmb.state.mn.us]

== Mississippi ==

Bay St. Louis [http://www.baystlouis-ms.gov]

== Native American ==

Burns Paiute Reservation [http://www.burnspaiute-nsn.gov]

Hualapai Tribal Nation [http://www.hualapai-nsn.gov]

== Nevada ==

Department of Health and Human Services [https://dwss.nv.gov/]

Division of Mental Health and Development Services [http://mhds.nv.gov]

== New Hampshire ==

Town of Goffstown [http://www.goffstown.com/]

Town of Milton [http://www.miltonnh-us.com/]

Town of New Castle [http://www.newcastlenh.org/]

Town of Newmarket [http://www.newmarketnh.gov/]

Town of Northwood [http://www.northwoodnh.org/]

Town of Plymouth [http://www.plymouth-nh.org/]

Town of Strafford [http://www.strafford.nh.gov/]

== New York ==

City of Henrietta [http://www.henrietta.org/]

== North Carolina ==

Alleghany County [http://www.alleghanycounty-nc.gov/]

County of Moore [http://www.moorecountync.gov/]

== Ohio ==

Brown County [http://www.browncountyohio.gov/]

City of Bexley [http://bexley.org/]

Jackson Township [http://www.jacksontwp.org/]

== Oklahoma ==

Comanche County [http://comanchecounty.us/]

Oklahoma Department of Commerce [http://www.okcommerce.gov]

== Pennsylvania ==

Borough of Greencastle [http://www.greencastlepa.gov]

== Texas ==

Texas Commission on the Arts [http://www.arts.texas.gov/index.php]

== Tennessee ==

Sevier County [http://www.seviercountytn.gov]

== Utah ==

Department of Human Services News [http://www.news.hs.utah.gov]

Utah GIS Portal [http://gis.utah.gov/]

== Washington ==

Washington State Criminal Justice Training Commission [http://www.cjtc.state.wa.us]

== Washington D.C. ==

Destination DC [http://washington.org]

== West Virginia ==

City of Fairmont [http://www.fairmontwv.gov/]

== Wyoming ==

State of Wyoming Department of Agriculture [http://agriculture.wy.gov/]

== Virginia ==

= Uruguay =

Ministry of Tourism and Sport [http://www.turismo.gub.uy/]

Ministry of Agriculture and Fisheries [http://www.dinara.gub.uy/web_dinara/]

Ministry of Labour [http://www.mtss.gub.uy/]

Ministry of Housing, Spatial Planning and Environment [http://www.mvotma.gub.uy/]

National Food Institute [http://www.inda.gub.uy/]

National Police Health Directorate [http://www.sanidadpolicial.gub.uy/]

Department of International Cooperation [http://iuci.opp.gub.uy/cooperacion/]

Regional Programme For The Control Of Chagas Disease [http://chagas.zoonosis.gub.uy/]

Comisión Nacional de Zoonosis [http://www.zoonosis.gub.uy/]

Hospital Maciel [http://www.hmaciel.gub.uy/]

= Uzbekistan =

Center for Coordination and Control over the Securities Market [http://www.csm.gov.uz/]

Official website of the Tashkent Regional Hokimiyat [http://tashvil.gov.uz/]

= Vanuatu =

Government of Vanuatu [http://www.governmentofvanuatu.gov.vu/]

Vanuatu Financial Intelligence Unit [http://www.gov.vu/fiu/]

Customs and Inland Revenue [http://www.customsinlandrevenue.gov.vu/]

Department of Co-operatives & Ni-Vanuatu Business Services[http://www.cooperative.gov.vu/]

Malampa Province [http://malampa.gov.vu/]

Port Vila Municipality Council [http://www.pvmc.gov.vu/fr]

Reserve Bank of Vanuatu [http://www.rbv.gov.vu/]

Telecommunications Regulator [http://www.telecomregulator.gov.vu/]

Utilities Regulatory Authority [http://www.ura.gov.vu/]

Vanuatu Geohazards Observatory [http://www.geohazards.gov.vu/]

National Statistics Office [http://www.vnso.gov.vu/]

= Vatican City =

Pontifical Council for Social Communications [http://www.pccs.va/]

= Venezuela =

Ministerio del Poder Popular para la Alimentación [http://www.minpal.gob.ve]

Ministerio del Poder Popular del Ambiente [[http://www.minamb.gob.ve]]

Ministerio del Poder Popular para el Comercio [[http://www.mincomercio.gob.ve/ ]]

Ministerio del Poder Popular para la Cultura [http://www.ministeriodelacultura.gob.ve/ ]

Ministerio del Poder Popular para la Defensa [http://www.mindefensa.gov.ve/]

Ministerio del Poder Popular para el Deporte [http://www.ind.gob.ve/index.php]

Ministerio del Poder Popular para las Industrias Básicas y la Minería [http://www.mibam.gob.ve/portal/]

Ministerio del Poder Popular para los Pueblos Indígenas [http://www.minpi.gob.ve/web/]

Ministerio del Poder Popular para las Relaciones Exteriores [http://www.mre.gov.ve/]

Ministerio del Poder Popular para las Relaciones Interiores y Justicia [http://www.mpprij.gob.ve/]

Ministerio del Poder Popular del Trabajo y Seguridad Social [http://www.mintra.gov.ve/]

Ministerio del Poder Popular para la Mujer y la Igualdad de Género [http://www.minmujer.gob.ve/]

= Vietnam =

One Thousand Years of Culture [http://english.thanglonghanoi.gov.vn/]

Quang Nam Department of Foreign Affairs [http://www.ngoaivuquangnam.gov.vn/]

Chu Lai Open Economic Zone [http://english.chulai.gov.vn/]

Vietnam Trade Promotion Agency [http://www.vietrade.gov.vn/en/]

National Institute of Science and Technology [http://www.iza.danang.gov.vn/]

Strengthening Environmental Management and Land Administration [http://semla.monre.gov.vn/]

Innovation Partnership Programme [http://www.ipp.gov.vn/]

= Virgin Islands, British =

Development Planning Unit [http://www.dpu.gov.vg]

= Virgin Islands, US =

Office of the Lieutenant Governor [http://ltg.gov.vi/]

= Yemen =

Ministry of Oil and minerals [http://www.mom.gov.ye]

= Zambia =

President of the Republic of Zambia [http://www.statehouse.gov.zm/]

Zambian Parliament [http://www.parliament.gov.zm/]

Ministry of Works and Supply [http://www.mws.gov.zm/]

Ministry of Education [http://www.moe.gov.zm/]

Ministry of Tourism, Environment and Natural Resources[http://www.mtenr.gov.zm/]

Ministry of Local Goverment and Housing [http://www.mlgh.gov.zm/]

Lusaka City Council [http://www.lcc.gov.zm/]

= Zimbabwe =

Ministry of Justice and Legal Affairs [http://www.justice.gov.zw]

Ministry of Water Resources Development and Management [http://www.water.gov.zw]

Ministry of Foreign Affairs [http://www.zimfa.gov.zw]

Ministry of Agriculture, Mechanisation, and Irrigation Development [http://www.moa.gov.zw]

Zimbabwe Government Online [http://www.zim.gov.zw]

Ministry of Health and Child Welfare [http://www.mohcw.gov.zw]

Ministry of Industry and Commerce [http://www.miit.gov.zw]

Ministry of Education, Sports, Arts, and Culture [http://www.moesc.gov.zw]

Ministry of Women Affairs, Gender, and Community Development [http://www.women.gov.zw]

Ministry of Science and Technology Development [http://www.mstd.gov.zw]

Ministry of Small and Medium Enterprises and Cooperative Development [http://www.msmed.gov.zw]

Ministry of Lands and Rural Resettlement [http://www.lands.gov.zw]

Ministry of Transport Communications and Infrastructural Development [http://www.transcom.gov.zw]

Ministry of Small and Medium Enterprises Development [http://www.smesi.gov.zw]

Ministry of Tourism and Hospitality Industry [http://www.tourism.gov.zw]

Ministry of Energy and Power Development [http://www.energy.gov.zw]

Office of the Vice President [http://www.vpmujuruoffice.gov.zw]

Ministry of Public Service [http://www.publicservice.gov.zw]

Government Websites Using Joomla

2011-04-05T09:32:44Z

Nikosdion: /* Greece */

= Multinational Organizations =

== European Union ==

Delegation to the United States [http://eurunion.org]

== United Nations ==

Regional Information Centre [http://unric.org]

UN in Turkmenistan [http://www.untuk.org]

== World Health Organization ==

Regional Office for Africa [http://www.afro.who.int/]

= Afghanistan =

Ministry of Education [http://pashto.moe.gov.af]

= Argentina =

President of Argentina [http://casarosada.gov.ar]

= Australia =

High Court of Australia [http://www.hcourt.gov.au]

National Capital Authority [http://www.nationalcapital.gov.au]

Premier of South Australia [http://www.premier.sa.gov.au]

QRAA Queensland Government [http://www.qraa.qld.gov.au]

= Bangladesh =

Main country website [http://bangladesh.gov.bd/]

= Belgium =

ICT en Zorg, from REB Vlaanderen, an initiative of the Vlaamse Minister van Onderwijs en Vorming [http://www.ictenzorg.be/]

= Brazil =

Ministry of Education [http://portal.mec.gov.br/]

Ministry of Defense [https://www.defesa.gov.br/]

= Canada =

Farm Products Council [http://www.fpcc-cpac.gc.ca/index.php/eng/home]

= Cape Verde =

President of Cape Verde [http://www.primeiroministro.cv/]

= Colombia =

Embassy to the United States [http://www.colombiaemb.org/]

= Chile =

Comunidad Tecnológica [http://www.comunidadtecnologica.gob.cl]

Concace [http://conacedrogas.gov.cl]/portal

Instituto Forestal [http://www.infor.gov.cl]

Instituto de Desarrollo Agropecuario [http://www.indap.gov.cl]

Servicio Nacional de Geología y Minería [http://www.sernageomin.gov.cl]

Dirección de Crédito Prendario [http://www.dicrep.gov.cl]

Instituto de Previsión Social [http://ips.gov.cl]

Servicio Nacional de Pesca [http://www.sernapesca.gov.cl]

= Dubai =

Dubai Civil Defence [http://www.dcd.gov.ae]

= Ecuador =

President of Ecuador [http://elciudadano.gov.ec]

= Ethiopia =

Addis Ababa City [http://Addisababacity.gov.et]

Arra[http://Arra.org.et]

CSA [http://Csa.gov.et]

EIAR [http://Eiar.gov.et]

Election Ethiopia [http://Electionethiopia.org]

EWCA [http://Ewca.gov.et]

HAPCO [http://Hapco.gov.et]

Harar Municipality [http://Hararmunicipality.org]

HOF Ethiopia [http://Hofethiopia.gov.et]

Kolfekernio [http://Kolfekeranio.gov.et]

Modfed [http://Modfed.gov.et]

MOH [http://Moh.gov.et]

MOYS [http://Moys.gov.et]

Ogaden [http://Ogaden.com]

SNNPREB [http://Snnpreb.gov.et]

SRS [http://Srsinfo.gov.et]

= France =

Eiffel Tower [http://www.tour-eiffel.com/]

= Germany=
AStA der RWTH Aachen [http://www.asta.rwth-aachen.de/]

Gemeinde Brüggen [http://www.brueggen.de/]

Stadt Wertingen [http://www.wertingen.de/]

= Greece =

Ministry of Education [http://www.minedu.gov.gr]

www.gss.gov.gr [http://www.gss.gov.gr]

http://chalki.gov.gr [http://chalki.gov.gr]

http://www.halkidiki.gov.gr [http://www.halkidiki.gov.gr]

Portal of Municipality of Nea Smirni [http://www.neasmyrni.gov.gr]

http://www.nom-athinas.gov.gr [http://www.nom-athinas.gov.gr]

Municipality of Nikaia, Attica [http://www.polisnikaia.gr]

= Guayana =

President of Guayana [http://opnew.op.gov.gy/]

Ministry of Foreign Affairs [http://www.minfor.gov.gy/tsite/]

= India =

Government of Kerala [http://www.kerala.gov.in/]

= Indonesia =

Main country website [http://indonesia.go.id/]

State Secretariat [http://www.setneg.go.id/]

National Election Commission [http://kpu.go.id/]

Ministry of Environment [http://www.menlh.go.id/home/]

Ministry of Cooperatives and Small and Medium Enterprise [http://http://www.depkop.go.id/]

Ministry of Empowerment of Women and Child Protection [http://http://www.menegpp.go.id/]

Directorate General of Higher Education [http://dikti.go.id/]

Directorate General of Taxes [http://www.pajak.go.id/]

Media Center, Ministry of Defense [http://http://www.dmc.kemhan.go.id/]

South Kalimantan Province [http://www.kalselprov.go.id]

Gorontalo Province [http://www.gorontaloprov.go.id/]

Serdang Bedagai Regency of North Sumatera Province [http://serdangbedagaikab.go.id/]

Sinjai Regency of South Sulawesi Province [http://sinjai.go.id/sinjai/]

Aceh Syari'ah Court [http://www.mahkamahsyariahaceh.go.id/]

= Iran =

Ayatollah Ali Khamenei [http://arabic.khamenei.ir/]

= Israel =

Civil Aviation Authority [http://en.caa.gov.il]

Ministry of Transport and Road safety [http://en.mot.gov.il]

= Italy =

City of Capoterra [http://www.comune.capoterra.ca.it]

Ministry of Economic Development [http://www.sviluppoeconomico.gov.it]

Directorate-General for Anti-Counterfeiting
Italian Patent and Trademark Office [http://www.uibm.gov.it]

Minister for the Equal Opportunities [http://www.pariopportunita.gov.it]

Unioncamere [http://www.unioncamere.gov.it]

= Laos=

Luang Prabang Province [http://luangprabang.gov.la/]

Ministry of Agriculture [http://www.maf.gov.la/index.php]

Ministry of Education [http://www.moe.gov.la/index.php]

Ministry of Energy and Mines [http://www.mem.gov.la/index.php]

Ministry of Health [http://www.moh.gov.la]

National Authority of Science and Technology [http://nast.gov.la]

National Authority of Post and Telecommunications [http://www.napt.gov.la/]

Statistics Bureau [http://www.nsc.gov.la/]

= Latvia =

Main government website [http://www.li.lv/]

= Lesotho =

Ministry of Education [http://www.education.gov.ls]

= Madagascar =

Ministère des Finances et du Budget [http://www.mfb.gov.mg/]

= Mali =

Primature [http://www.primature.gov.ml/]

Ministère de l'Economie et des Finances [http://www.finances.gov.ml/]

Direction Générale des Marchés Public et des Délegations de Service Public [http://www.dgmp.gov.ml/]

Direction Nationale des Domaines et du Cadastre [http://www.dndc.gov.ml/]

= Mexico =

Bicentenary Celebrations [http://www.bicentenario.gob.mx]

Ministry of Foreign Affairs [http://www.sre.gob.mx]

National Fund for the Promotion of the Crafts [http://www.fonart.gob.mx]

= Mongolia =

200+ Government Websites [http://community.joomla.org/blogs/community/1210-mongolia.html]

= Netherlands =

De Sociale Inlichtingen [http://www.siod.nl/]

e-overheid [http://www.prod.joomla.ictu.asp4all.nl/]

Stichting ICTU [http://www.ictu.nl/]

Patent Office [http://www.octrooicentrum.nl/]

= Samoa =

Ministry of Education [http://www.mesc.gov.ws]

= Singapore =

National Parks Singapore [http://www.nparks.gov.sg/cms/]

= Spain =

Castilla-La Mancha [http://edu.jccm.es]

= Sri Lanka =

University Grants Commission [http://www.ugc.ac.lk/]

= South Africa =

City of Johannesburg [http://joburg.org.za]

= Thailand =

Ministry of Science and Technology [http://www.most.go.th/main]

Mae Hong Son Province [http://www.maehongsorn.go.th]

National Science and Technology Development Agency [http://www.nstda.or.th]

National Electronics and Computer Technology Center [http://www.nectec.or.th]

The National Telecommunications Commission [http://eng.ntc.or.th]

Krabi Prolice [http://www.krabipolice.go.th]

The Secondary Education Service Area 20 [http://www.sesa20.go.th/]

National Research Counil of Thailand [http://www.nrct.go.th]

Department of Medical Sciences [http://www.dmsc.moph.go.th/dmsc2010/]

Chiangmai Provincial Labour Protection and Welfare Office [http://chiangmai.labour.go.th]

= Tonga =

Main government website [https://www.pmo.gov.to/]

Ministry of Commerce [http://mlci.gov.to/]

= Tunisia =

Main country website [http://www.ministeres.tn/]
President of Tunisia [http://www.carthage.tn/en/index.php]]

= Turkey =

Governorship of Kocaeli - EU Projects Coordination Center [http://www.kocaeliab.gov.tr/]

Governorship of Ordu [http://www.ordu.gov.tr/]

= Ukraine =

Lviv City [http://www.city-adm.lviv.ua]

= United Kingdom =

Ministry of Defense [http://www.stabilisationunit.gov.uk]

Serious Organised Crime Agency [http://SOCA.gov.uk]

UK Foreign Office Awards ceremony [http://www.foreignofficeawards.co.uk/]

UK Parliamentary Press Gallery [http://www.pressgallery.org.uk/]

= United States of America =

== Federal Agencies ==

US Air Force AFPIMS Resource Center [http://training.afnews.af.mil]

Interagency Resources Management Conference [http://www.irmco.gov]

NASA Laser Vegetation Imaging Sensor [https://lvis.gsfc.nasa.gov]

NASA Virtual Magnetospheric Observatory [http://vmo.nasa.gov]

Standard Labor Data Collection and Distribution Application [https://www.sldcada.disa.mil]

US Commission on International Religious Freedom [http://www.uscirf.gov]

NOAA Large Marine Ecosystems of the World [http://www.lme.noaa.gov]

US Group on Earth Observations [http://www.usgeo.gov]

US Department of Agriculture - Coastal Commission [http://www.coastalamerica.gov]

US Bankruptcy Court District of Kansas [http://www.ksb.uscourts.gov]

US Army Architecture [http://architecture.army.mil/]

US Army Corp of Engineers, Los Angeles [http://www.spl.usace.army.mil]

US Army Enterprise Solutions Competency Center [http://escc.army.mil]

US Navy Standard Labor Data Collection and Distribution Application [https://www.sldcada.disa.mil]

US Central Command [http://www.centcom.mil]

US Military Leadership Diversity Commission [http://mldc.whs.mil]

US Department of Defense Sexual Assault Prevention and Response Office [http://www.sapr.mil]

== Alaska ==

Denali Commission [http://www.denali.gov]

== California ==

Commission on the Status of Women [http://women.ca.gov/]

Calexico [http://www.calexico.ca.gov]

Port of San Diego [http://www.portofsandiego.org/]

== Colorado ==

City of Boulder [http://www.bouldercolorado.gov/]

== Florida ==

Orange County Comptroller [http://www.occompt.com]

Space Florida [http://www.spaceflorida.gov/]

City of Sebastian [http://www.cityofsebastian.org/]

Sebastian Police Department [http://www.sebastianpd.org/]

City of Sebastian Economic Development [http://sebastianbusiness.org/]

City of Sebastian Municipal Golf Course [http://www.sebastiangolfcourse.org/]

City of Sebastian Municipal Airport [http://www.sebastianairport.org/]

City of Sebastian Retirement Site [http://sebastianretirement.com/]

== Georgia ==

City of Atlanta Geographic Information System (GIS) [http://gis.atlantaga.gov/gishome/]

City of Dalton [http://www.cityofdalton-ga.gov/]

Counsil of State Court Judges [http://www.statecourt.georgiacourts.gov/]

== Guam ==

Department of Labor [http://www.dol.guam.gov]

== Hawaii ==

City and County of Honolulu's Department of Transportation Services (DTS) [http://citytransportationhonolulu.com/]

== Iowa ==

Iowa Department of Education [http://www.iowa.gov/educate]

Iowa Insurance Division - Flood Awareness [http://www.donttestthewatersiowa.gov]

Iowa College Student Aid Commission [http://www.iowacollegeaid.gov]

== Illinois ==

Heyworth [http://www.heyworth-il.gov]

Mattoon [http://mattoon.illinois.gov]

== Indiana ==

City of Richmond [http://richmondindiana.gov]

== Kansas ==

City of Emporia [http://www.emporia-kansas.gov/]

== Kentucky ==

Frankfort Transit [http://transit.frankfort.ky.gov]

== Maryland ==

Baltimore Police [http://www.baltimorepolice.org/]

== Mississippi ==

Bay St. Louis [http://www.baystlouis-ms.gov]

== Native American ==

Burns Paiute Reservation [http://www.burnspaiute-nsn.gov]

Hualapai Tribal Nation [http://www.hualapai-nsn.gov]

== Nevada ==

Department of Health and Human Services [https://dwss.nv.gov/]

Division of Mental Health and Development Services [http://mhds.nv.gov]

== New Hampshire ==

Town of Goffstown [http://www.goffstown.com/]

Town of Milton [http://www.miltonnh-us.com/]

Town of New Castle [http://www.newcastlenh.org/]

Town of Newmarket [http://www.newmarketnh.gov/]

Town of Northwood [http://www.northwoodnh.org/]

Town of Plymouth [http://www.plymouth-nh.org/]

Town of Strafford [http://www.strafford.nh.gov/]

== New York ==

City of Henrietta [http://www.henrietta.org/]

== North Carolina ==

Alleghany County [http://www.alleghanycounty-nc.gov/]

County of Moore [http://www.moorecountync.gov/]

== Ohio ==

Brown County [http://www.browncountyohio.gov/]

City of Bexley [http://bexley.org/]

Jackson Township [http://www.jacksontwp.org/]

== Oklahoma ==

Comanche County [http://comanchecounty.us/]

Oklahoma Department of Commerce [http://www.okcommerce.gov]

== Pennsylvania ==

Borough of Greencastle [http://www.greencastlepa.gov]

== Texas ==

Texas Commission on the Arts [http://www.arts.texas.gov/index.php]

== Tennessee ==

Sevier County [http://www.seviercountytn.gov]

== Utah ==

Department of Human Services News [http://www.news.hs.utah.gov]

Utah GIS Portal [http://gis.utah.gov/]

== Washington ==

Washington State Criminal Justice Training Commission [http://www.cjtc.state.wa.us]

== Washington D.C. ==

Destination DC [http://washington.org]

== West Virginia ==

City of Fairmont [http://www.fairmontwv.gov/]

== Wyoming ==

State of Wyoming Department of Agriculture [http://agriculture.wy.gov/]

== Virginia ==

Madison County [http://www.madisonco.virginia.gov/]

Archived:Adapting a Joomla 1.5 extension to Joomla 2.5

2011-02-24T09:53:08Z

Nikosdion: Adding detailed ACL information

{{incomplete}}

This article is written to help developers upgrade their extensions from Joomla 1.5 to Joomla 1.6. If you have any further tips, feel free to add them onto this wiki article.

== System setup ==
This document assumes that you are running the program eclipse for your development. This will allow you to automate most of the Joomla conversion process. For more instructions on how to setup eclipse, see [[Setting up your workstation for Joomla! development]].

== Background reading ==
[[What's new in Joomla 1.6#Developers]] describes most changes of Joomla 1.6 and how this affect developers. Please note that the API documentation on the joomla wiki is incomplete/inaccurate. Therefore the best way to look at the Joomla 1.6 API is to look directly at the joomla source code.

== Updating your Joomla 1.5 language files to work on Joomla 1.6 ==
Using the native php ini parser for language files has many benefits including much faster performace. Converting your exisiting Joomla 1.5 into the new format is very easy if you use a coding platform like eclipse. Search your file for *.ini in your project of choice. Then use the following search/replace values to automatically, replace exisiting quotes, add quotes to string values and update your comments.

'''''Double quotes are NOT allowed inside the string value''', except when using "_QQ_" to represent them. In case of js use, better use html entities or single quotes.''

#Single quotes are allowed.
#Put a closing double quote at end of line if not empty or a comment. Find ^((?!#).+)\R replace with $1"\R
#Put an opening double quote at start of translated string if not empty or comment. Find ^((?!#).+?\=)(.+)\R replace with $1"$2\R
#Now replace the hash comments with the new semi colon. Find ^# and replace with ;
#Remove any illegal strings that can prevent files loading. Find ^(null|yes|no|true|false|on|off|none)=(.+)\R and replace with nothing.

Enabling Debug System in Global configuration will display the parsing errors per file and lines.

If you do not remove the illegal strings, then your language file will load until one of them is reached. The now "illegal" strings in the language file like NO, are handled by adding a 'J' in-front of them. Just make sure you change these language strings in your XML files as well. You can include in your language file:
<source lang="ini">
;forbidden words
JNULL="Null"
JYES="Yes"
JNO="No"
JTRUE="True"
JFALSE="False"
JON="On"
JOFF="Off"
JNONE="None"
</source>

== Legacy mode removed ==
More information needed....

== New installer XML system ==
Changes have been made to the Joomla 1.6 extension installer XML. More information is required.

== Load language in plugins ==
On the day of release, the way Language files are loaded for Joomla! 1.6 Plugins was changed. As a result, all Plugins must add the following code:

<source lang="php">
public function __construct(& $subject, $config)
{

parent::__construct($subject, $config);

$this->loadLanguage();

}
</source>

== change in BuildRoute logic ==
In Joomla! 1.6, the router BuildRoute logic for each Component was changed to require a Menu Item in order to build the link.

<source lang="php">
// we need a menu item. Either the one specified in the query, or the current active one if none specified
if (empty($query['Itemid'])) {
$menuItem = $menu->getActive();

}

else {

$menuItem = $menu->getItem($query['Itemid']);

}
</source>

There continue to be problems with the router. It is not uncommon to see a URL that bears the existing page URL as the "base" (if you will), followed by it's real URL. Look for these situations and report them on the tracker.

For those who have been around long enough, forcing the Menu Item on the URL was done in 1.0.12 and it turned out poorly.

== Accessing component parameters in front-end ==

Accessing component parameters in frontend for specific menu item, we will use com_content as example : in 1.5 this was done with
<source lang="php">
<?php
$mycom_params = JComponentHelper::getParams('com_content');

echo $mycom_params->get('num_leading_articles');

?>
</source>

above code in joomla 1.6will output the DEFAULT com_content params , not affected with menu item so the new code for 1.6 would be
<source lang="php">
<?php
$app = JFactory::getApplication('site');

mycom_params = & $app->getParams('com_content');

echo $mycom_params->get('num_leading_articles');

?>
</source>

== Plugin parameters ==

In 1.5, you had to use the Plugin Helper to retrieve the Plugin object and then JParameter to retrieve the Parameter Object. Following those steps, you could work with a single parameter.

<source lang="php">
<?php

$plugin = & JPluginHelper::getPlugin('content', 'emailcloak');

$pluginParams = new JParameter($plugin->params);

$mode = $pluginParams->def('mode', 1);

?>
</source>

In 1.6,Joomla makes the parameter object automatically available to you.

<source lang="php">
<?php

$mode = $this->params->def('mode', 1);

?>
</source>

== Changing Javascript function overrides ==
Joomla now has some of its Javascript functions prefixed with "Joomla". This means the functions are always unique and won't clash with other javascript functions on your server/webpage. However, you now need a different method to override the default Joomla Javascript. The Joomla 1.5 method was:
<source lang="javascript">
function submitbutton(pressbutton) {
var form = document.adminForm;
if (pressbutton == 'applyconfig') {
//do something unique
form.action.value = 'apply'
submitform('saveconfig');
return;
}

submitform(pressbutton);
return;
}
</source>
For Joomla 1.6 you need to copy your exisiting function but modify your top line to:
<source lang="javascript">
Joomla.submitbutton = function(pressbutton) {
var form = document.adminForm;
if (pressbutton == 'applyconfig') {
//do something unique
form.action.value = 'apply'
submitform('saveconfig');
return;
}

submitform(pressbutton);
return;
}
</source>

== Changing removed functions ==
Some functions were removed for various reasons. You can find a list of them on [[What's new in Joomla_1.6#Removed_features]].

Note that the ADODB compatibility methods included function like $db->Execute($query) which now need a separate $db->setQuery($query);$db->Query();

== Renamed events ==

A large number of the Joomla 1.5 events have been renamed. Here is the list of renamed events.
*onContentAfterSave
*onContentAfterTitle
*onContentAfterDisplay
*onContentBeforeDisplay
*onContentBeforeSave
*onContentSearch
*onContentSearchAreas
*onUserAuthenticate
*onUserAfterDelete
*onUserAfterSave
*onUserBeforeDelete
*onUserBeforeSave
*onUserLogin
*onUserLogout
*All content events (except for search and search areas) now pass a 'context' as the first argument to alert the plugin as to what type of content is being passed. The plugin event may or may not heed this context.

This means that if you use Joomla events you have two options:<br/>
1) rename the event and your extension can only be used on Joomla 1.6<br/>
2) create your own "legacy layer" and add the new event function name to your plugin. Here is an example of the user plugin:<br/>

<source lang="php">
//joomla 1.6 compatibility code
public function onUserLogin($user, $options){
$result = $this->onLoginUser($user, $options);
return $result;
}
public function onUserLogout($user) {
$result = $this->onLogoutUser($user);
return $result;
}
public function onUserAfterDelete($user, $succes, $msg) {
$result = $this->onAfterDeleteUser($user, $succes, $msg);
return $result;
}
public function onUserBeforeSave($user, $isnew, $new){
$result = $this->onBeforeStoreUser($user, $isnew, $new);
return $result;
}
public function onUserAfterSave($user, $isnew, $success, $msg){
$result = $this->onAfterStoreUser($user, $isnew, $success, $msg);
return $result;
}
</source>

== Changing name="adminForm" to id="adminForm" ==
To create your own admin forms in joomla you now need to use id="adminForm". This is because the use of the tag "name" is not valid HTML strict and has compatibility issues when used in XHTML served as XML.\. Although there is build in compatibility check to look for the old name="adminForm" tag, it is best to add the new id tag. Depending on the features you want to use you may need to include both, name="adminForm" and id="adminForm" because not all core functionality has been updated to use id's. An example of the new form code is:
<source lang="html4strict"><form method="post" action="index.php" name="adminForm" id="adminForm"></form></source>

== Removing references to index2.php and index3.php ==
Joomla 1.0 had different index files to serve admin content in different manners. Joomla 1.6 has now got better way to handle this and you need to search your codebase for "index2.php" and "index3.php" to ensure you don't have any Joomla 1.0 style links. If you need to display your component without any of the other Joomla 1.6 admin content (menus, etc) then add the following to the url: "&tmpl=component"

== Upgrading core table and field name usage ==
Many of the core Joomla tables have been simplified, combined or renamed. This was needed to get rid of some limitation dating back to Joomla 1.0. This means however that if you have code that directly manipulates Joomla tables, that you need to add a function that detects Joomla 1.6 and had different SQL queries based on the joomla version. Plase note that both tables and field names have been renamed or removed. An example is the following function that can find if a plugin is published on both Joomla 1.5 and 1.6:

<source lang="php">
function getPluginStatus($element, $folder) {
//get joomla specs
$db = & JFactory::getDBO();
$version = new JVersion;
$joomla = $version->getShortVersion();
if(substr($joomla,0,3) == '1.6'){
//Joomla 1.6 code
$query = 'SELECT published FROM #__extensions WHERE element=' . $db->Quote($element) . ' AND folder=' . $db->Quote($folder);
} else {
//Joomla 1.0/1.5 code
$query = 'SELECT published FROM #__plugins WHERE element=' . $db->Quote($element) . ' AND folder=' . $db->Quote($folder);
}
$db->setQuery($query);
$result = $db->loadResult();
return $result;
}
</source>

== Changing in the XML installer manifest file ==
Joomla 1.6 now uses a more streamlined approach to the XML file inside the ZIP file that installs Joomla extentions.

== New mootools version ==
Most important is that the Ajax class has been depreciated and replaced by the Request class. That means that if you use ajax calls you need to have a version switcher (below a sample code)

<source lang="php">
$version = new JVersion;
$joomla = $version->getShortVersion();

..... (your code) ....

/* our ajax istance for starting the sync */
<?php if(substr($joomla,0,3) == '1.6'){
echo 'var ajax = new Request.HTML({
url: url,';
} else {
echo 'var ajax = new Ajax(url, {';
}?>

.... your code .....

<?php if(substr($joomla,0,3) == '1.6'){
echo 'var ajaxsync = new Request.HTML({
url: url, ';
} else {
echo 'var ajaxsync = new Ajax(url, {';
}?>

.... your code .....

</source>

Also another common usuage of mootools in Joomla is the popup box. The Joomla 1.5 javascript code to close this box is:
<source lang="javascript">document.getElementById('sbox-window').close();</source>
in Joomla 1.6 you need to use:
<source lang="javascript">window.parent.SqueezeBox.close();</source>

== Converting your JParameters to JForms ==
Joomla 1.6 now uses the JForms class to handle parameters and it has also changed the way parameters are defined in your XML files. To make menu/component/module/plugin parameters work, first you need to update the XML file. Here is an automated way to handle the bulk of the conversion. (added "" to the examples below so you can see spaces in the search query as well). Use eclipse to search and replace parameters in *.xml files

replace "<param " with "<field "<br>
replace "</param>" with </field>"<br>
replace "<params> with "<config><fields name="params"><fieldset name="basic">"<br>
replace "<params*?> with "<config><fields name="params"><fieldset name="basic">"<br>
replace "</params>" with "</fieldset></fields></config>"<br>
replace "<install " with "<extension "<br>
replace "</install>" with "</extension>"

Change the "extension" node to add the following attributes:
* Keep the existing "type" attribute
* version="1.6.0"
* client="site"
* method="upgrade"

Example for a module:
<source lang="xml">
<extension type="module" version="1.6.0" client="site" method="upgrade">
</source>

Now if you want to use your joomla extension on both Joomla 1.5 and 1.6 you will need to go to your "team synchronising" view in eclipse. Double click on your changed xml file, which will open the compare editor. Then simply copy-paste back your old Joomla 1.5 params into your new Joomla 1.6 xml file and save.

If you have custom parameter types, you will need to do some additional work. In Joomla 1.5 you would use the following code:

<source lang="php"><params addpath="/administrator/components/com_yourname/elements"></source>
In joomla 1.6 JParameter classes won't work and you will need to convert your jparameter fields into JForm fields. Create a new directory and copy your "old elements" into them. Then you need to load these new fields with the individual parameter

<source lang="php"><field name="sample" type="sampleField" size="5" default="" label="sampleField" description="sampleField" addfieldpath="/administrator/components/com_yourname/fields"/></source>

Use eclipse to search and replace files in your newly created fields directory.
replace "JElement" with "JFormField"<br>
replace "var $_name =" with "public $type ="<br>
replace "function fetchElement($name, $value, &$node, $control_name)" with "protected function getInput()"<br>

Then you still need to replace the references to $control_name and others in your new JForm field, but at least the bulk of the work has been done automatically

== renamed core component names and login form parameters ==
A login module for Joomla 1.5 will not work without modifications on Joomla 1.6. Here is a part of the logout module that will work on both Joomla 1.5 and Joomla 1.6. You can compare the two to see the difference in input names.

<source lang="php">
$version = new JVersion;
$joomla = $version->getShortVersion();
if(substr($joomla,0,3) == '1.6'){
//joomla 1.6 format
$output .= '<input type="hidden" name="task" value="user.logout" />';
$output .= '<input type="hidden" name="option" value="com_users" />';
} else {
//joomla 1.5 format
$output .= '<input type="hidden" name="task" value="logout" />';
$output .= '<input type="hidden" name="option" value="com_user" />';
}
</source>

here is the code for the login module

<source lang="php">
$version = new JVersion;
$joomla = $version->getShortVersion();
if(substr($joomla,0,3) == '1.6'){
//joomla 1.6 format
$output .= '<input type="hidden" name="task" value="user.login" />';
$output .= '<input type="hidden" name="option" value="com_users" />';
$output .= '<input id="modlgn_passwd" type="password" name="password" class="inputbox" size="18" alt="password" /> ';
} else {
//joomla 1.5 format
$output .= '<input type="hidden" name="task" value="login" />';
$output .= '<input type="hidden" name="option" value="com_user" />';
$output .= '<input id="modlgn_passwd" type="password" name="passwd" class="inputbox" size="18" alt="password" /> ';
}
</source>

These changes might also apply to front-end forms of other Joomla core components (more information needed)

== ACL changes ==
Joomla 1.6 now has an advanced ACL system. It is unknown how this affects people that have previously used the ACL API in their extension.

In order to allow your component's Options page to display the ACL settings editor, you need to create a file named access.xml in your component's administrator directory, e.g. administrator/components/com_example/access.xml. The syntax of the file is fairly easy to understand:
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<access component="com_example">
<section name="component">

<action name="core.admin" title="JACTION_ADMIN" description="JACTION_ADMIN_COMPONENT_DESC" />
<action name="core.manage" title="JACTION_MANAGE" description="JACTION_MANAGE_COMPONENT_DESC" />

<action name="example.something" title="COM_EXAMPLE_ACL_SOMETHING_TITLE" description="COM_EXAMPLE_ACL_SOMETHING_DESC" />
</section>
</access>
</source>

Important things to notice:
* The root tag is called access and you must specify the component="com_yourComponentName" attribute
* The section tag is mandatory
* No ACL privilege will display on the list unless you '''explicitly''' add it. This means that you do have to add the core privileges that concern your component
* You can create custom privileges! You don't have to register them anywhere except your access.xml file. The name format is liberal, but no two components should use the same key for a different purpose (all components' privileges share the same namespace). As a rule of thumb use the convention componentName.privilegeName. You must NEVER use core.* names as they are reserved by Joomla!.

In order to apply ACLs, you have to override your controller's constructor:

<source lang="php">
public function __construct($config = array())
{
parent::__construct($config);
// This conditional lets the ACL check run only on Joomla! 1.6+
if( version_compare( JVERSION, '1.6.0', 'ge' ) ) {
$user = JFactory::getUser();
if (!$user->authorise('example.something', 'com_example')) {
return JError::raiseWarning(403, JText::_('JERROR_ALERTNOAUTHOR'));
}
}
// Place anything else you need in the constructor below this line
}
</source>

The heavy lifting is done by the authorise() method of the JUser class. The first parameter is the privilege name, the second one is the "section", i.e. your component's name. As you can see, this allows for great flexibility. You can check any privilege, for any component, for any user, from anywhere in your code.

== Plugin files now in different locations ==
Joomla 1.6 now creates a different hierarchy structure for plugins. Files are no longer placed where they used to be, so if your other parts of your application (comp, mods, etc.) expects them to be in a certain position, it won't work. The change has been that now plugins are in an additional subdirectory. If you only load your plugins via the 1.5 API you should be fine.
* Joomla 1.5 example location
<source lang="php">JPATH_SITE . DS . 'plugins' . DS . 'authentication' . DS . 'example.php';</source>
* Joomla 1.6 example location
<source lang="php">JPATH_SITE . DS . 'plugins' . DS . 'authentication' . DS . 'example'. DS . 'example.php';</source>

== Changes to view parameters ==
J!1.6 has a strict new way of specifying parameters for views. J!1.5 allowed a bit of freedom where the parameters could be defined at the view.html.php level but now ithas to be at the tmpl level. AE believes the view paramters were removed.

== Installation process - preflight, postflight, etc ==
These are new events that can screw up an existing installlation process. -1 on me for not documenting the process while stepping through xdebug.
They should be totally optional access points to the installation process. But if your 1.5 install process is tricky for some reason, then these can be used to do clean up activities.

== Admin template changes ==
Admin functions that depended on certain functions, naming conventions etc no longer work. Khepri has been removed. Other admin functions/libraries may have changed.

== ACL ==
gid and aid have been removed. Significant changes to ACL archtecture. Bricking refers to totally locking your self and everyone else out - Last chance backdoor involves adding a emergency pw to the config file.

==sys.ini language translation file==
This file has 3 purposes:

1. It is used for installation process translations, when a folder language is included in the pack.

pack/language/en-gb/en-gb.extension.ini

pack/language/en-gb/en-gb.extension.sys.ini

In this case, the <description>COM_MYCOMPONENT_XML_DESCRIPTION</description> used in the sys.ini will display on installing/updating the extension.

When editing the extension in administration, it will be the .ini version of COM_MYCOMPONENT_XML_DESCRIPTION which will display.

2. It is used to replace the former .menu.ini

3. It is used to display the translated extension name in many managers.

== removed include folders ==
Most of the 3rd party libraries (Archive, domit, js, PEAR, etc) in the include folder have been removed in J!1.6.

== Use paths defined in defines.php. ==
(Note they are different for the site and the administration)

[[Category:Joomla! 1.6]]
[[Category:Tutorials]]
[[Category:Development]]
[[Category:Module Development]]
[[Category:Component Development]]
[[Category:Plugin Development]]

Joomla info page/el-GR

2010-08-26T22:16:46Z

Nikosdion: Translated content to Greek (el-GR)

{{RightTOC}}
= Greek / Ελληνικά =

== Τι είναι το Joomla? ==
Το Joomla είναι ένα βραβευμένο Σύστημα Διαχείρισης Περιεχομένων (ΣΔΠ) το οποίο σας επιτρέπει να δημιουργήσετε ιστοχώρους και πανίσχυρες διαδικτυακές εφαρμογές. Πολλές απόψεις του, συμπεριλαμβανομένης της ευχρηστίας του και της επεκτασιμότητάς του, έκανα το Joomla το πιο δημοφιλές λογισμικό δημιουργίας ιστοχώρων που είναι διαθέσιμο. Το καλύτερο είναι ότι το Joomla είναι μια λύση Ανοικτού Κώδικα που είναι ελεύθερα διαθέσιμη στον καθένα. Τα πλεονεκτήματα της χρήσης του Joomla! συμπεριλαμβάνουν:

* Εύκολη εγκατάσταση
* Απλή συντήρηση του ιστοχώρου
* Κορυφαία ασφάλεια και σταθερότητα
* Πανίσχυρες δωρεάν και εμπορικές επεκτάσεις
* Πληθώρα προτύπων ώστε να αλλάξετε με ευκολία την εμφάνιση του ιστοχώρου σας

== Που μπορώ να βρω το Joomla; ==
* Κατεβάστε το Joomla: http://www.joomla.org/download.html
* Κατεβάστε το πακέτο Ελληνικής γλώσσας (el-GR) για το Joomla : http://joomlacode.org/gf/project/jtranslation/frs/?action=FrsReleaseView&release_id=12189

== Που μπορώ να βρω επεκτάσεις; ==
* Κατεβάστε επεκτάσεις: http://extensions.joomla.org/
* Κατεβάστε πακέτα Ελληνικής γλώσσας για δημοφιλείς επεκτάσεις: http://joomlacode.org/gf/project/greek_joomla/frs/?action=FrsReleaseBrowse&frs_package_id=1241

== Που μπορώ να βρω τεκμηρίωση για το Joomla; ==
* Αγγλική τεκμηρίωση: http://docs.joomla.org/

== Που μπορώ να βρω υποστήριξη για το Joomla; ==
* Δωρεάν Αγγλική υποστήριξη: http://forum.joomla.org/
* Δωρεάν Ελληνική υποστήριξη:
** http://forum.joomla.org/viewforum.php?f=50
** http://forum.joomla.gr/
* Εμπορική υποστήριξη: http://resources.joomla.org/ (ιστοχώρος διαθέσιμος μόνο στα Αγγλικά)

== Τοπικές Εκδηλώσεις / Ημερίδες Joomla (Joomladays) ==
Οι τοπικές κοινότητες ανά τον κόσμο οργανώνουν Ημερίδες Joomla. Μια Ημερίδα Joomla είναι μια εκδήλωση που δημιουργείται αποκλειστικά για χρήστες και έργα του Joomla και συνήθως προσελκύει τοπικό ακροατήριο. Για περισσότερες πληροφορίες: http://community.joomla.org/events/joomla-days.html (στα Αγγλικά)

== Ομάδες Χρηστών Joomla (JUG) ==
Οι τοπικές Ομάδες Χρηστών Joomla (JUG) αποτελούν έναν εξαιρετικό τρόπο να συναντήσετε νέους ανθρώπους, να λάβετε βοήθεια για ένα έργο, ή να μοιραστείτε την γνώση σας με άλλους χρήστες του Joomla. Το Joomla είναι παντού γι' αυτό ελέγξτε εάν υπάρχει μια Ομάδα Χρηστών στην περιοχή σας. Εάν όχι, μπορείτε να ξεκινήστε μία.
* Ομάδες Χρηστών Joomla στην Ελλάδα: http://community.joomla.org/user-groups/europe/greece.html
* Συχνές Ερωτήσεις για τις Ομάδες Χρηστών Joomla: http://community.joomla.org/user-groups/jug-faq.html (στα Αγγλικά)

== Πως μπορώ να συνεισφέρω στο Joomla; ==
* Απαντήστε σε ερωτήσεις σε οποιοδήποτε Φόρουμ του Joomla! (link to: Where to get support for Joomla?)
* Γράψτε ή μεταφράστε ένα Παιδαγωγικό Άρθρο ή Τεκμηρίωση (link to: Where to get documentation for Joomla?)
* Αναπτύξτε μια Επέκταση ή ένα Πρότυπο
* Δοκιμάστε ή Σχολιάστε σε μια Αναφορά Σφάλματος
* Γίνετε Μέλος σε μια Ομάδα Εργασίας του Joomla!
* Βοηθείστε σε μια Εκδήλωση του Joomla!
* Συνεισφέρετε με Άλλους Τρόπους, δείτε το http://contribute.joomla.org/ (στα Αγγλικά)