Joomla 1.7 Beginners Guide PDF
Joomla 1.7 Beginners Guide PDF
7
Beginners Guide
Introduction
...............................................................................23
Who am I?
..........................................................................................................25 Who are you?
......................................................................................................26 What is this book about?
.....................................................................................27 Any further questions?
........................................................................................29
Showcase
....................................................................................31
The Eiffel Tower
.................................................................................................31 The Howoldies
....................................................................................................32
! Sunday, 24 July 2011
Page 3
3000+ Government Websites built with Joomla!
................................................32 eCommerce
.........................................................................................................33 Company site
......................................................................................................34 And?
....................................................................................................................36 How to nd Joomla! Sites?
..................................................................................36
joomla.org Google
Check out the website more closely ....................................................................37 Go ahead and ask your friends ...........................................................................37 Any other ideas? ..................................................................................................38
Installation
..................................................................................41
Minimum system requirements:
.........................................................................41 Installation variants
.............................................................................................41 Local Test Environment
......................................................................................42
Windows Operating System Linux Operating System Mac OS X Operating System
Joomla! 1.7 - Beginners Guide Step 3 License Step 4 Database Step 5 - FTP-conguration Step 6 - Conguration Installation of sample data Step 7 Completion
Page 5
Result ..................................................................................................................95
Page 7
Templates
.................................................................................115
Joomla! and templates
.......................................................................................116 Positions
............................................................................................................116 Core Templates
.................................................................................................117 Styles
.................................................................................................................119
Navigation
................................................................................121
Breadcrumbs
.....................................................................................................121
Page 8
Joomla! Menus
..................................................................................................122 First example: a static catalog or book structure
...............................................122
Preparation Step 1: Creating the menu Step 2: Creating the menu items Step 3: Creating and assigning the module
Search
................................................................................................................157
Search Term Analysis User interface Behind the scenes
Modules
....................................................................................163
Similarities of all modules
................................................................................163 Advanced Options
............................................................................................163 Core modules
....................................................................................................163
Plug-Ins
....................................................................................167
Authentication
...................................................................................................167
Joomla! ! Sunday, 24 July 2011
Page 10
Content
.............................................................................................................168
Joomla Loading Modules Email Cloaking Code Highlighter Pagebreak Page Navigation Vote
Editors-xtd
........................................................................................................170
Article Image Pagebreak Readmore
Editors
...............................................................................................................171
CodeMirror None TinyMCE
Extension
...........................................................................................................171
Joomla
Page 11
Joomla! 1.7 - Beginners Guide P3P Policy Cache Debug Log Redirect Remember Me SEF Logout
User
...................................................................................................................173
Prole Contact Creator Joomla!
Joomla! 1.7 - Beginners Guide Separation of Content and Layout The Colour Choice
beez_20: Design Choice
....................................................................................192 Position of the Navigation
................................................................................192 JavaScript and WAI ARIA
................................................................................193 WAI ARIA - Landmark Roles: First Aid for the Orientation
...........................194
Collapsible modules and sidebars Hide Column Show and hide modules Accessible Tabs
Language Filter plugin ......................................................................................206 Language Switcher module ..............................................................................206 Multi-language content items ...........................................................................207 A multi-language website ..................................................................................207
Page 13
Joomla! 1.7 - Beginners Guide Front page A blog An 'About Us' page A contact form Login form
Next, consider the technology ...........................................................................213 Now you're ready to build .................................................................................214
Joomla! 1.7 - Beginners Guide Topic: Administrator help Topic: Compression Topic: Cache handling
Page 15
Three thing you need to be aware of all the way through
................................242
Add a. Your reputation Add b&c. Your roles and tasks
Page 16
Sell and negotiate continuously
.........................................................................247 Dene roles and play them!
..............................................................................248 How do you dene roles?
..................................................................................249
Tactics Revisited
Resources
..................................................................................253
Community
.......................................................................................................253 Documentation
.................................................................................................253 Security Checklist
..............................................................................................253 Joomla! Extensions
............................................................................................253 Joomla! Templates
.............................................................................................253
! Sunday, 24 July 2011
Page 17
Events ................................................................................................................ 254 The Future ........................................................................................................254 Training ............................................................................................................254 Commercial Support ........................................................................................254 Hosting .............................................................................................................. 254 Certicates ........................................................................................................254
Page 18
IT IS FREE OF CHARGE
It is free of charge readable on our website and downloadable as PDF
IT IS SPONSORED
The book is sponsored by companies from 15 different countries and three different continents which are an important part of the Joomla! community. Thank you: 2Value, 5aces, Anything Digital, B01 Consulting, EDVAS, joomla4all, Joomlapolis, JoomlArt, Migur, NetArtS, Open Source Support Desk, redWEB, SKEPSIS Consult, Sigsiu.NET GmbH, SistaSystems, TC4J - Templateclub4Joomla - David & Andreas, tec-promotion GmbH, Techjoomla, Think Network GmbH, Timble, video2brain, Vistamedia
Four additional authors besides me wrote chapters! Angie Radtke - Der Auftritt1 . Chapter: The Beez Template Andreas Klln - TC4J - Templateclub4Joomla2: Chapter: Must have Extensions
1 2
Joomla! 1.7 - Beginners Guide Henk van Cann - 2Value 3. Chapter: Earning respect and money with Joomla Jen Kramer - 4Web Inc 4. Chapter: A Joomla! 1.7 Website from Scratch
IT'S MULTILINGUAL
The book will be available in three more languages.
It is still possible to advertise for your service, book here: Joomla! 1.7 - Gua para Principiantes 5
It is still possible to advertise for your service, book here: Joomla! 1.7 - Poradnik dla pocztkujcych7
3 4 5 6 7
Comment on the chapters in the HTML versions and provide feedback. Get involved in the next project! The next Joomla! Version is around the corner. Join us!
Page 21
Page 22
Chapter 1
Introduction
Welcome to Joomla!. It is a free system for creating websites. It is an open source project, which, like most open source projects, is constantly in motion. It is unpredictable, sometimes indescribable, partially controversial, quite often very sexy, at times a little sleepy and provincial. Nevertheless, or perhaps because of these reasons, it has been extremely successful for ve years nowand is popular with millions of users worldwide. The word Joomla! is a derivative of the word Jumlafrom the African language of Swahili and means "all together. " The Project Joomla! is the result of a heated discussion between the Mambo Foundation, which was founded in August 2005, and its then-development team. Joomla! is a development of the successful system Mambo. Joomla! is used all over the world for simple homepages and for complex corporate websites as well. It is easy to install, easy to manage and very reliable. The Joomla! team has organized and reorganized itselfthroughout the last ve years. From 2005 to 2009, Joomla! 1.0 was further developed up to version 1.0.15 and that development was ofcially laid offin September 2009. From 2005 until now, Joomla 1.5 is still beingdeveloped, wasintroduced as a stable version in January 2008, and will be ofcially laid off in April 2012. From 2008 until 2011, Joomla 1.6 was developed. A stable version has been available since January 2011. The end of life for Joomla! 1.6 will be the release date of Joomla! 1.7 Joomla! 1.7 will be released in July 2011 and it will pave the road for the next Joomla! long term release 1.8 or 2.0 The users of the Joomla! system remained faithful. Many transferred their website from Mambo to Joomla!and theyhave learned a lot over the years. Many users have climbed aboard in the last few years but there are still people in the world who do not know about the system. Joomla!, together with Drupal and Wordpress, is the most used open source web content management system in the world.
Page 23
Page 24
Joomla! 1.7 - Beginners Guide Compared to the world average the situation in e.g. Germany is different (Figure 2). Joomla! has almost twice as large of a search volume as WordPress and WordPress almost four times as much as Drupal. Here are a few statistics from Google Trend (Table 1): Country Germany France Italy Poland Spain Switzerland UK USA China Drupal 1 1 1 1 1 1 1 1 1 Joomla! 6.7 5.5 6.4 8.3 4.05 9.5 2.60 1.55 1.4 Wordpress 3.8 3.45 3.6 3.1 3.85 3.4 3.65 3.25 5
WHO AM I?
My name is Hagen Graf, I'm 46 years old, and I live in Fitou9, France. I am married to the woman of my dreams and have four daughters. My work consists of many different activities such as teaching, advising, listening, testing, programming, understanding structures, developing new applications, questioning, and always trying something new.
w3techs.com/technologies/overview/content_management/all
9 http://goo.gl/maps/3dU6
Page 25
Joomla! 1.7 - Beginners Guide Actually, my work can be donecompletely online but sometimes clients mayhave reservations aboutfully online projects,which is why I amon the road a lot. Being on the road means meeting clients in different countries with different languages and cultures, long car, bus or train rides as well as very short response times to customer inquiries by e-mail, Facebook messages and tweets. This way of working has implications for what Ionce used to call"the ofce". I need to be able to have access from anywhere in the world to my e-mails, pictures, videos, tweets, and documents. My ofce is located where I am.
Page 26
Joomla! 1.7 - Beginners Guide The website designer plays a special role in this list. He usually has to cover all other roles, which constitutes a real challenge. As I am writing this book, I often nd myself thinking about the website designer. A company, an institution, a club, an organization, yes, probably everyone, needs a web presence that is user-friendly and exible. A presence - one that develops over time, can easily be changed via a web browser; a presence that replaces your ling cabinet and leather address book; a presence that can communicate with different devices and can be extended easily. I assume your website is already the place where you explain what you do or what your company does. This is your place where you maintain your customer relations 24 hours per day, seven days a week. Your website probably containsa collection of applications and datasummarizing your activities. Your site should also contain interfacesto allowother applications to use them. Until a few years, the creation of a website was a difcult thing to do.While you did not have to be a renowned specialist, a combination of perseverance and having fun with what you are doing were necessary to produce appealing results. You had to create static HTML pages in an HTML editor and then upload them via le transfer protocol to a server. To create even the simplest interactivity such as a contact form or a forum, you had to learn a programming language. It is more than understandable that many people did not take this hardship on themselves and handed over the creation of a website to a web agency or did not even start the project in the rst place. Thanks to Facebook and kits such as Google Sites, creating simple web pages has become relatively easy but if you want something unique, you should become familiar with a content management system. Joomla! offers everythingyou need tocreate your own, individual website.
Joomla! is a tool with lots of possibilities and you can use the system in a huge variety of congurations, depending on your ideas and wishes. In order to allow comfortable access, I have structured the book as follows: 1. This Introduction 2. Showcase 3. Installation 4. Structures and Terms 5. What's New in Joomla! 1.7? 6. Managing Content
Page 27
Joomla! 1.7 - Beginners Guide 7. How to Create an 'About Us' Page 8. A Typical Article 9. Media Manager 10. Contact Form 11. Status, Trash and Check Ins 12. Structure Your Content with Categories 13. Website and Content Conguration 14. Templates 15. Navigation 16. Users and Permissions 17. Extension Management 18. Core Extensions 1. Banners 2. Contacts 3. Messages 4. Newsfeeds 5. Redirect 6. Search 7. Weblinks 8. Mass Mail Users 19. Modules 20. Plug-Ins 21. Working with Templates 1. Create Your Own Style 2. Customizing Existing Templates 3. Overrides 4. Create a New Template using Atomic 22. The Beez Template (Angie Radtke) 23. Search Engine Optimization 24. Multi-Language Websites ! Sunday, 24 July 2011 Page 28
Joomla! 1.7 - Beginners Guide 25. Must have extensions (Andreas Klln) 26. Upgrade from Older Versions 27. A Joomla! Website from Scratch (Jen Kramer) 28. Earning respect and Money with Joomla! (Henk van Cann) 29. Resources? Although you are a beginner, you will be able to manage your own Joomla! website via a web browser. If you are somehow familiar with HTML, CSS and image editing, you will be able to customize a template for your website.
Don't hesitate! Of course, I can't deliver technical support. The Joomla! forums provide a wealth of knowledge and you will denitely nd answers to your questions there. If you have comments or questions about the book, however, please feel free to leave them.
Page 29
Page 30
Chapter 2
Showcase
What do websites look like when they were created with Joomla? This question can't be answered easily as most websites are based on the Joomla! software, but the design of the website is created by an agency and then "transformed" into a Joomla! template. Therefore, the exterior of a website can be deceiving. Nevertheless, here are some screenshots to give you an idea.
Page 31
THE HOWOLDIES
Launching soon, hopefully end of July 2011! Somuga, a Basque animation company, constructed this site with their original characters to demonstrate animation in a completely open source environment (Figure 2).
Figure 2: THE HOWOLDIES Built with Joomla 1.6, HTML5, and in three languages (Basque, Spanish, and English) This site demonstrates some of the latest technologies integrated with Joomla! Website: coming soon Creator: http://www.4webinc.com/
JoomlaGov is a showcase for Government sites powered by Joomla! around the world. More than 200 countries are represented and, one month after its launch at 'J and Beyond' 2011, it contains more than 3,000 sites.
Page 32
Joomla! 1.7 - Beginners Guide This site is a great example of how the Joomla! community 10 can collaborate, to highlight the qualities of the Joomla! CMS. For instance, the website of the Estonian Presidency 11 is well worth a look (Figure 3).
Figure 3: JoomlaGov Website built using Joomla!, K2 & Google Maps (API version 3) Website: http://www.joomlagov.info Creator: http://raramuridesign & http://piezoworks.be
ECOMMERCE
A danish online shop based on Joomla! and the RedShop component (Figure 4).
10 11
Figure 4: Trend Bazaar Website built using Joomla!, K2 & Google Maps (API version 3) Website: http://www.trendbazaar.dk Creator: http://redweb.dk
COMPANY SITE
This website is a 'typical' company site. Joomla! is perfect for these kind of websites (Figure 5).
Page 34
Figure 3: Vanerumgroup All sites of Vanerumgroup have been made with Joomla! 1.5. Challenges were the multiple language support, the synchronisation of products between the different site (still is) and the different content by region (solved by metamod) Website: http://www.vanerumgroup.com Creator: http://5aces.be
Page 35
AND?
These websites look how websites are suppposed to look. :-) If I had not told you that they were created with Joomla!, you probably would not have noticed it consciously.
Just have a look at the project site! I found the sites featured above in the Joomla! Showcase 12. You will nd 2,000 websites sorted by category. There is a site of the month, an overview with top-rated sites, and much more (Figure 4).
12 http://community.joomla.org/showcase/
Page 36
Joomla! 1.7 - Beginners Guide You can search for the term com_content13. The component "content" uses this term in the URL of the page. Nowadays, this kind of searching is not really effective because of the various search engine optimized URLs' but the result is still impressive.
If you are on a website and want to know whether it was created with Joomla!, have a look at the source code. In the header section, you should nd this line: <meta name="generator" content="Joomla! - Open Source Content Management" /> You can also just type the URL of the link to the administration area: http://example.com/administrator Here the example of the Eiffel tower site: 14:
tweeted 15
I want YOUR site :) Looking for 5+ great Joomla! site examples for the showcase chapter cocoate.com/j17/showcase plz reply a link+RT
13 http://www.google.de/search?q=com_content 14 http://www.tour-eiffel.fr/administrator/ 15 http://twitter.com//hagengraf/status/83149809338417152
Page 37
Joomla! 1.7 - Beginners Guide and promand promptly received the links for the sites you can see above!
Do you know any other ways to of detecting Joomla! sites? Feel free to leave comments 16.
16 http://cocoate.com/node/8525
Page 38
Page 39
Page 40
Chapter 3
Installation
Thanks to the web installer, Joomla! can be installed in only a few minutes. In order to install Joomla! on your local PC, it is necessary to set up your "own internet", for which you'll need a consisting supported browser, a web server, a PHP environment and as well a Joomla" supported database system. We call this a LAMP stack17 (or XAMP) and a client server system. The Joomla! les will be copied to this system and congured with the Joomla! web installer.
INSTALLATION VARIANTS
You need all the components mentioned above to install a Joomla! system for yourself. PC, browser, and Internet connection are usually available. There are a number of options for web server, PHP interpreter, and database. You can: set the system up locally on your PC set the system up on a server in a company's Intranet rent a virtual server from a provider rent or purchase a server from a provider (with root access) You can also have the web server and database located on computers that are physically separated from each other. You can also, of course, use different: brands of web servers Versions of PHP interpreters Versions of MySQL databases
17 http://en.wikipedia.org/wiki/LAMP_%28software_bundle%29
Page 41
Joomla! 1.7 - Beginners Guide And on top of that, you can install and operate all these components on various operating systems. This freedom in choice of resources can sometimes confuse a layman. Therefore, we will discuss a few typical scenarios.
For a Windows operating system you can use either of two web servers:.
You take a pre-congured package (XAMPP), unpack it on your computer, and everything you need is there (http://apachefriends.org).
PRODUCTION ENVIRONMENT
You have several options here as well.
You rent a web-space package with database, PHP support, and often also your domain name from a provider. In this case you have a functional environment and you can install your Joomla! into it. Consult your provider as to the version choices (PHP, MySQL). Sometimes providers offer Joomla! pre-installed with various templates. IIf this is the case, all you have to do is activate Joomla! with a click of the mouse and it is ready for you.
You rent a server from a provider and install the operating system of your choice. You are the administrator of the system and you can work on it, just like on your PC at home.
Page 42
Joomla! 1.7 - Beginners Guide Before you venture into the wilderness of the Internet, you should rst practice on your local computer. This has the advantage that there are no connection fees, it is very fast, and you can practice at a leisurely pace. You may even have a small local network at home where you can install Joomla! on one computer and access it from another. Remember that there are probably more current versions on the respective project sites on the Internet.
STUMBLING STONES
This topic is very complex because there is a vast number of providers and an even greater number of installed web server, PHP, MySQL versions and web space management tools. Crunchpoints during the installation often consist of: an activated PHP Safe Mode, preventing you to upload les, 'forbidden' rewrite paths with the Apache web server because the so-called Apache Rewrite Engine (mod_rewrite) is not activated, the directory permissions on Linux and OSX, which are set differently than in Windows. Basically, the easiest way that almost always works, is the following: Download the current le package from joomla.org to your home PC and unzip everything into a temporary directory. Load the unpacked les via FTP onto your rented server or to the directory of your local installation. The les must be installed in the public directory. These directories are usually called htdocs, public_html or html. If there already are other installations in that directory, you can specify a sub directory in which your Joomla! les should be installed. Many web hosts allows you to link your rented domain name to a directory. You have to nd out the name of your database. In most cases, one or more databases are included in your web hosting package. Sometimes, the names of the user, database and password are already given; sometimes you have to set them up rst. Usually you can do this in a browser-based conguration interface. You will need the database access information for Joomla!'s web installer.
Joomla! 1.7 - Beginners Guide The web installer appears with a selection of languages. Choosing the language is the rst of seven installation steps. Set the desired language, and click the Next button (Figure 1).
Joomla! 1.7 - Beginners Guide conguration.php. This le will be generated at the end of the installation with your personal values. If the installer can not write in the folder, Joomla! can not create the le and the installation will fail. In this case, try to congure the rights and then click the button repeat check. Then, click the Next button and you will get to the step license.
Step 3 License
Each software product is somehow licensed. Joomla! is licensed according to the GNU General Public License, version 2.0 (Figure 3).
Step 4 Database
In the fourth step database conguration, your data base parameters will be requested (Figure 4). You can create any number of databases in your local server environment. You have a MySQL user with the name root. The user root is the MySQL administrator and can, therefore, do everything in your MySQL system. The password depends on your server environment (no password is needed with XAMPP, with MAMP the password is root).
Page 45
Step 5 - FTP-conguration
! Sunday, 24 July 2011
Page 46
Joomla! 1.7 - Beginners Guide In order to avoid problems with access rights and possibly turned on PHP Safe Mode, you have the possibility to use the FTP functions of PHP for the upload and le handling. This is not necessary in a local installation. If you have installed Joomla! on a virtual server with your provider, you can enter the FTP data provided by your ISP. If your provider allows this function, it is advisable for security reasons, to create different FTP accounts for users and for the Joomla! installation. Activate the FTP account just for that Joomla! directory (Figure 5).
Step 6 - Conguration
In the rst part of the conguration the name of your site is requested. This name will appear in the title bar of the browser window when someone accesses your site. The name is also used at various other places, such as in conrmation emails to registered users. For our example page, I'll use the name Joomla! (Figure 6). In the second part, the name, e-mail address and administrator password are requested. Writing down the password on a piece of paper is probably best (but do not stick it on the screen or under the keyboard :-)). In the third part, you specify the type of data your Joomla! installation should contain.
The data is the most important thing in your installation. Joomla! allows (and strongly recommends for beginners) the installation of sample data. You will be provided with a small manual about Joomla! and many examples to experiment safely. Click the button install sample data. The installer will load the data into your database and change the display (Figure 6). This process is somewhat unimpressive but necessary for installing sample data. The button will disappear and a small text box will be visible. ! Sunday, 24 July 2011 Page 47
Step 7 Completion
In the seventh and nal step you will be congratulated on having successfully installed Joomla! (Figure 7). Congratulations from me as well! You will now see an advisory in bold letters appearing in the display, prompting you to delete the directory called 'Installation'. You should follow this advisory because your Joomla! website will otherwise not run properly.
Page 48
Page 49
Page 50
Joomla! 1.7 - Beginners Guide Install a fresh Joomla! 1.6 without example data: Create a new folder in your local web directory (/htdocs) and install the new Joomla!. Now you have two complete Joomla! installations. This approach is very helpful for training purposes. Delete the example data in your administration area. Unpublish the example data. Please watch the video attached, in which I am going to show you how to do that. If you decide to follow step 2 or 3, you will need to login in the administration area. There you can delete and/or unpublish the example data and menu items.
Menu manager
Go to the Menu Manager in the Top Menu (Menus -> Top), click the check boxes on the left side above the menu items to choose all of them, and then click the icon Unpublish. After you have done this, you will see a red icon on each menu item (Figure 10). If you now go back to your website (refresh it), you will notice that the top menu is no longer visible. Repeat the same procedure with the Main Menu and the About Joomla! menu. Make sure you choose all menu items, except the Home/Frontpage item. This menu item cannot be deleted because you need a frontpage. In the lower area, you may change the number of displayed menu items (Figure 11).
Page 51
Article manager
Use the same procedure as described above. Open the article manager and choose all content items to unpublish or delete them.
Cache
To make sure that all data will disappear from you site, you have to clear the entire cache (Site Maintenance -> Clear Cache). Again, choose all content and delete it.
Empty Website
Page 52
Page 53
Page 54
Chapter 4
FRONTEND
With the frontend we mean the areas of the website as visitors or registered users see it. A registered user normally works only in the frontend. It is like in a store, where the goods are displayed in shop windows and on shelves. Here you can have a look around.
BACKEND
This is your administration area, therefore, we call it just administration. You can give registered users the right to work in your backend. This privilege is mostly limited to several employees, who should administer some tasks on the website. You can access the administration login via /administrator. http://localhost/administrator There you can register with your login details and choose your preferred language. (Figure 1).
Page 55
Figure 2: Administration
You may access each function either by using the combined menu tab system or by simply clicking an icon on the start screen.
FILES
Joomla! consists of hundreds of les. Images, PHP scripts, CSS les, JavaScript les and a many more. You probably already noticed this when you unpacked the compressed package and copied it into the htdocs folder. Basically, you have already installed two Joomla! packages: one for the frontend and one for the backend. The 'Backend Joomla!' is located in the administrator folder (Figure 3). This folder is addressed when you call /administrator in the browser. Inside that folder are other folders like cache, components, language, modules and templates. The specic backend les are stored in these directories. You will nd the same folder names again outside the administrator folder. These folders contain the frontend les. These are not really two Joomla! packages, but there is a clear separation between backend and frontend les. For example, all les uploaded with the Media Manager will be saved in the /media folder. All les have to be saved with a backup.
Page 56
DATABASE
Additionally to les (graphics, documents, system les, etc.) Joomla! also needs a database. During the installation procedure, the Joomla! web installer creates 33 tables in your specied database (Figure 4). In these tables, all content will be managed.
Page 57
ELEMENTS OF JOOMLA!
The structure of Joomla! is simple, sophisticated and efcient. Joomla! assumes that you want to write an article. An article usually consists of a title, text and some conguration settings.
Article
Articles can be displayed in single or list view. On the frontpage of your your recently installed Joomla! website you will see these four articles (Figure 5).
Page 58
Page 59
Categories
In order to display articles clearly, you may create categories, and then assign an article to them. Each article can be assigned to exactly one category (Figure 7). The categories can be nested to any depth. Articles from one or multiple categories can be assigned to one menu item and displayed in various ways. By clicking on the menu item, all articles from different categories will be shown. This principle is used by online newspapers, for example. You click on Sports and get all categorized articles for this topic. If the newspaper discerns between different forms of sports, they will use nested category trees: Sports Football Handball Politics Domestic Europe World ! Sunday, 24 July 2011
Page 60
User
Users are needed to produce content. At least one user is registered on each Joomla! site, namely the one you created during the installation, with the rights to congure everything on your site. Depending on the user's rights, he can work in frontend and/or backend to write an article. Each user requires a username, an email address and a password. Every user can be assigned to any user group as well as to any access level. This enables the user to create articles that are only visible to certain user groups.
Navigation
To nd your way around the website, you will need navigation with corresponding links. In Joomla! we call this a menu. You may create as many menus as desired and nest them into as many different ways as you wish. Each menu is a module which can be positioned on a provided area in the template.
Module
A module is something that you can position next to an article. A menu, for example, is a module. The small registration block on the left side is also a module. You can create as many modules with smart functions as you need and position them on the predened area in the template.
Templates
! Sunday, 24 July 2011
Page 61
Joomla! 1.7 - Beginners Guide A template is the graphical pattern for your website. It mostly consists of HTML and CSS les. Joomla! delivers several templates for you to choose from. Templates are congurable, which allows you to upload a different logo, change the background color, etc. Each template provides areas where modules can be positioned (Figure 8).
Plug-ins
A plug-in provides practical services but is usually invisible to the visitors of the site. A wysiwyg editor, for example, is a plug-in. Plug-ins are extensions, which can be installed unlimited amount of times. The core package already consists of numerous useful plug-ins.
Components
Components are the little surprise packages that help you create nearly anything on your site. You want to have a booking system for workshops? A platform for properties? A forum? An ! Sunday, 24 July 2011
Page 62
Joomla! 1.7 - Beginners Guide image gallery? You just have to install the right component! The Joomla! core package already comes with some components, e.g., the contact component, which enables you to integrate contact forms into your site. There are thousands of components to enhance your Joomla! 1.6 system.
Options
You will need individual conguration settings for your website; we call them options. These options are applied to the whole website, for users, categories, modules, components. You will always nd an icon named Options like, e.g., that one (Figure 9), which provides you with the possibility to see the position of modules (Figure 8) by inserting http://localhost/index.php?tp=1 The initial tp stands for template position.
Figure 9: Options
Other structures
Other structures for user interfaces, templates and technical relations are also available. For the time being, you are well equipped by remembering the described structures above.
Page 63
Page 64
Chapter 5
What's New?
On July 19th, Joomla 1.7 will be released and this version is something special because of various reasons. Before I go into details, I want to mention a few user groups.
There are so many people in the world using Joomla! for their own purpose. Joomla! now powers 2.7% of all existing websites in the world. Ill just mention a few of them here. If you need a website and you are new to Joomla!, you can download and install it and you can build your website in a very easy way. Even when you are only using the core package, and even if you are just a beginner in this eld. If you need help getting started, here is a link: http:// cocoate.com/j17 Have fun!
A site builder usually has existing websites which are based on various Joomla! versions. So the interest is more in questions like: Are there any new features for my clients? Is there something inside that helps me to be more productive? Is there an easy upgrade path?
Developers
They know the programming languages PHP and JavaScript and like to use them. They create additional extensions to the Joomla! core for free, or for prot as a business. Developers are always thinking of new features and productivity.
They run a business and provide services like hosting, training, and extension and theme development. They are thinking about security, speed and code quality. They are leading the project in some way and should communicate a clear vision
All the groups mentioned above are, or could be, members of the Joomla! community. Ask yourself What do I expect from a new major release? Most of these group members are asking themselves Is Joomla! the right solution for my needs? Can I make money with it? For people who look at the user interface or to any visible features I have a short answer. In the user interface of the alpha version I examined, only one single checkbox is added in the mass mail component. It is now possible to include or exclude blocked users in a mass mail. This is a nice feature but it will not blow your mind.
Page 66
Support
How does support work with this new release cycle? Long term releases
If you look at the existing Joomla! 1.5 as a long term release, it will be supported three months after the next long term release. This means that you dont have to upgrade your existing Joomla! 1.5 site to the upcoming Joomla! 1.7. But, in January 2012, when the next long term release comes out you have to think about updating and in April 2012 you should. Short term releases The support for a short term release ends with the release of the next short term release.
Update/Upgrade
If you use the newest version of Joomla! which currently is Joomla! 1.6.4, the update process is as easy as one-click in the backend. If you are using an earlier version of Joomla! you can upgrade with the help of the jUpgrade component written by Matias Aguirre. Keep in mind that it is not necessary to upgrade an existing Joomla! 1.5 site to Joomla! 1.7, but it would make your life easier to update once Joomla! 1.8 is released!
Page 68
Numbering
What confuses me most when I tried this version was the numbering. But, I found a very simple answer to that. The version 11.1 is the actual Joomla! Platform version and the rst 'major release' will be 11.2. The numbering scheme for the platform consists of the year number followed by a sequence number, so 11.1 was the rst release in 2011. The next release on July 4th will be 11.2. The rst release in 2012 will be numbered 12.1.
Release cycle
Every three months a new version of the Joomla! platform will be released. Package content
Page 69
Joomla! 1.7 - Beginners Guide The platform package consists of the les stored in the folder /libraries and /media. The platform has no user interface. The platform source code is stored in the Git version control system GitHub. code: https://github.com/joomla/joomla-platform members:https://github.com/joomla/joomla-platform/network/members
1. It allows developers to use the Joomla Platform independently of the CMS. This means that youll have the choice between different CMSs on top of the Joomla! platform in the future. This is really revolutionary! Joomla! is the only system in the world which provides that. There is still one core CMS provided by the Joomla! project but other projects like Molajo could use the Joomla! platform as a base, too. 2. It allows developers to contribute / add features more quickly In the past it was very frustrating to experience that good code wasnt always included into Joomla! core. With the Joomla! platform stored on GitHub it is very easy to fork it for your own purpose and it is easy too to integrate your code in the main branch. 3. 3-month release cycle With this short release cycle it is possible to add features into the platform much quicker than into the CMS. This is useful for extension developers to add core features which are necessary for their extension. 4. It encourages recruitment of more developers, including larger corporations, who may have not otherwise contributed This point is crucial and it will work when the responsible team for the platform starts embracing these new faces!
Conclusion
The release of Joomla 1.7 and the Joomla! platform 11.2 will not introduce anything that is technically new, but it is the beginning of a new phase of the Joomla! project. To come back to the headline. In my point of view the Joomla! Platform is the heart beat of the project. It's easy to write a CMS but it's hard to envision, construct, and maintain a long term platform. Maybe it is the real, true beginning of the Joomla! project. Get involved!!
Page 70
Page 71
Page 72
Chapter 6
Managing Content
A content management system is made for managing content - who would have thought?! So the next question is: What is content? In media production and publishing, content is information and experiences that may provide value for an end-user/audience in specic contexts (Wikipedia 19). Ok, I see, but what is it that provides value? This question is indeed very hard to answer and quite individual but I think you now get the idea of content and a content management system like Joomla!. A content management system is useful for managing information that provides value for your audience (Hagen Graf :-) ).
TYPES OF CONTENT
In core Joomla! you have articles, categories, web links, banners, contacts and feeds. I am not sure whether creating value with banners is possible but banners are also a kind of content. Modules can be used for content creation as well. Often you may want to enrich your content with les like photos and other media types. For this Joomla! has its Media manager. This is what Joomla! core provides as your toolbox to manage all these bits and pieces to create value to your audience. I am going to cover these tools in the next chapters. If this isn't enough for you, you can enhance Joomla! with so-called content construction like K221, FlexiContent22 or CCK jSeblod 23 and many other extensions, but that's another book entirely. :-) kits 20
Page 73
To give you a rst real challenge, let's create a rst page on your new website. It will be an about us page on which you can write about your company, your project, or yourself. Most of the time, a page like this contains a title, text and perhaps a few images.
The plan
The 'about us' page should consist of the following components: a title, a text, an image. The page should not appear on the front page. We want a link to the page in the top horizontal menu (top). This may sound simple at rst :-). Go ahead and log into the administration interface!
Page 74
As a rst example we are going to use an already existing image on the web. For example, this one: http://farm2.static.ickr.com/1198/898250237_78a0e75cba_m.jpg (Figure 3)
Joomla! 1.7 - Beginners Guide The image will appear in your editor window. Click Save and your item is stored. There are several ways to save it: Save - Item is saved. Form is not closed. Used for saving when you still want to continue working. Save & Close - Item is saved and form will be closed. Save & New - Item is saved, form will be closed and a new empty article form is called. Exit the form.
Page 77
Page 79
Page 80
A TYPICAL ARTICLE
The following items usually have to be taken into consideration when it comes to creating an article on your website: a text with one or more images a teaser text for list views with a read more link pointing to the full article page the article should appear on the front page and needs no menu link nice to have: a scheduled publication date nice to have: a printer-friendly version for visitors who would like to print the article nice to have: an option to forward the article by email
Start
The article should appear on the front page of your website. If you deleted, did not install or change your sample data, your Joomla! front page will look like the one in Figure 1. It is, of course, not a bad thing if posts should appear. :-)
Article form
You are now in the article form, in which you will probably write all articles you will ever write in Joomla!. A very important place! The form is structured as in Figure 3.
Page 82
Joomla! 1.7 - Beginners Guide The minimum requirement for an article is a title (1), a category (2), and a text (3). If you look at the form more closely, you will notice the help texts that appear when you move the mouse across the description of a eld. I have marked the areas in the form in Figure 3 with six digits.
Title
The most important part is the title or headline. The title appears as a headline on the website (usually in the biggest size of the HTML headline tags <h1>) and in the browser bar at the top (you can enable or disable this behavior). The title is the foundation for the alias eld below. The alias is automatically generated by Joomla! when you save the article and the way it looks is congurable as well. Basically, the purpose of an alias is to have a simple, short and legible URL in the browser address bar, which can easily be used in e-mails or chats as well. In the example of http://example.com/rst-article - rst-article is the alias.
Category
This is about the classication or categorization of the article. Every item MUST be assigned to a category. If you explicitly do not want to categorize the article, you can assign the category uncategorized. This is especially useful for more static content pages like legal notices and the About Us page. In this area, other important attributes can be congured, including State (published or not), who has Access (Access, Permission depends on various settings), Language and Featured. Featured replaces the former attribute frontpage and ensures that the items are in a predened blog layout for your website frontpage. The article ID is created after saving and consists of a serial number.
Text
In this section you can write your text, which should be of value to your audience . Sounds really easy, doesn't it?! :-) Technically, you are dealing with a WYSIWYG editor (What You See Is What You Get) here. The editor converts your written text into HTML text format. Joomla! uses the TinyMCE24 editor as default conguration. TinyMCE is an independent open source project, which has so many functions that you could write a separate book about it. (May not be a bad idea.) It basically works like any other word processor: write text, highlight text, then click on a toolbar icon and the function is applied or a dialog box opens. The buttons below the input area are unusual and can be confusing at times. These buttons are Joomla! specic and only have an indirect relationship with the editor. The Joomla! core comes with ve of these very practical additional buttons. You can add more buttons by adding Joomla! extensions: 1. Article: allows you to link to other existing Joomla! articles 2. Image: You can insert an existing image or photo from the Media Manager or upload a new image. 3. Pagebreak: inserts a pagebreak in your article
24 http://tinymce.moxiecode.com/
Page 83
Joomla! 1.7 - Beginners Guide 4. Read More: allows you to stipulate where to place the read more link 5. Toggle Editor: switches the editor on and off. If it is off, you will see the HTML code of your article.
Options
What was called Parameter in Joomla! 1.5, is now called Options in Joomla! 1.6, like, for example, the Publishing Options. Here you can specify who wrote the article (Created by). The user who created the article is usually allowed and responsible for making changes to the article later. Which name is really shown below the title at the webpage is congured in Created by Alias. The three elds below allow you to schedule the publishing. Simply enter the appropriate dates and Joomla! takes care of the rest.
More Options
In this section you can congure many options by switching them on and off. You can change the article layout to suit the reader's and search engine's needs. Just start experimenting - it's the best way to learn. 30. The sixth and nal area concerns the permissions for this article. This selection will help us in many places in Joomla! 1.6 and I will cover this in chapter Users and Permissions.
SAMPLE ARTICLE
Let's create the article outlined above together: A text with one or more images Just write your text. To add an image or images, there are numerous possibilities: 1. The image is already available online, for example, on Flickr 25. In this case, click the image icon in the editor toolbar and copy the image URL to the dialog box. 2. The image is already in the Joomla! Media Manager. In this case, click the image button below to select the image and insert it into your text (Figure 4).
25
Joomla! 1.7 - Beginners Guide The article should appear on the frontpage and needs no menu link Select Yes in the eld Featured in Area 2. A scheduled publication would be nice Avoid this at rst, so you don't have to wait for the article to appear on your website :-). If you would like to try it later with a different article, simply ll the elds Start Publishing and Finish Publishing with the appropriate information or select the dates by clicking the calendar icon. A printer-friendly version of the article If you do not know at this point where the global settings are located, have a look at the chapter Website and Content Conguration and verify the current settings. In area 5, you may switch the Show Printer icon to 'show'. Forwarding of the article by e-mail Simply set the options in area 5, switch the Show Email Icon to show.
RESULT
After saving you can reload your site and will see your article on the frontpage as in Figure 5.
Page 86
MEDIA MANAGER
The media manager is Joomla!'s little Digital Asset Management System (DAM)26. If you are managing content, you will need a place to store the les. Files are all the images, PDFs and whatever you decide to mention in your content. Usually these digital assets consist of the le and additional meta data. In this case, we need an easy-to-use tool to manage our les. Let's have a look at what is possible with the Joomla! core media manager.
How it works
To me it looks more like a le manager. Everyone knows the Windows explorer or the OSX nder. In Joomla! they call it "media manager". It has a base directory where all the les are stored. You can look at your les in two different ways using your browser: via a Thumbnail View (Figure 1) and a Detailed View (Figure 2). It is possible to navigate through the folders by clicking on them.
26
Page 88
Joomla! 1.7 - Beginners Guide next options you see are MIME27 types, nowadays often called Internet Media Type. If you are a Windows user, you usually only distinguish different le types by their extension. Internet Media Type is another way to recognize the type of a le even without a le extension. You can permit or forbid as many le types as desired. The Flash Uploader is one of the most sophisticated features that is often forgotten about. In Joomla! 1.5 it didn't always work properly but the version coming with Joomla! 1.7 is excellent for uploading more than one le at a time. The Flash Uploader simply works and is easy to use! Try it! (Figure 5).
27 28 29
There are other places where the media manager plays a role, like in categories. It is possible to link an image to a category (Figure 7).
Page 90
CONTACT FORM
With a contact form the following question arises: "Is this content?". I think it is and have, therefore, written it as a sub chapter of the Managing Content chapter. On a contact form it rst becomes obvious that something like a CMS is being used. Manually created HTML pages cannot send emails as this requires a script language like PHP, for example, and a congured server. PHP scripts can be embedded as contact forms into HTML pages, but then that part of the website will often look different from the rest of the site. In Joomla! the contact form is already integrated and you "only" have to congure it. Ususally, if your Joomla! is running on a web server at your provider, you won't have problems with sending emails. Locally, it's a bit more difcult because you would have to set up a mail server rst. Generally, this is not a problem but it isn't really necessary. ;-) Joomla! sends emails in different ways. You will see an overview of this in Global Conguration Server (Figure 1). Naturally, you would use the standard activated PHP Mail function (read more: Website and Content Conguration).
Creating a contact
In order to include a contact on your site you need at least: a contact category a contact a link in a menu
Page 91
Joomla! 1.7 - Beginners Guide Maybe you still have a category from the example data (Sample-data contact). If not, go ahead and create one. In the next step you will create a new contact. To do so, open Components Contacts in your administration area and click on the icon New. Then ll in the appearing form (Figure 2). I have labeled some areas in the screenshot for better orientation.
Page 92
Joomla! 1.7 - Beginners Guide 6. In the eld Contact Redirect, you can enter another email adress to which the contents of the form should be sent. 7. The Metadata Options are, like the Publishing Options, available on each single page (Read more: Search engine optimization).
Page 93
Page 94
Page 95
Page 96
Chapter 7
30
Joomla! 1.7 - Beginners Guide two levels. With Joomla! 1. you can have as many levels as you want. Joomla! no longer has sections - only categories. In the Category Manager (Administration Content Category Manager), you can manage your category tree and lter up to 10 levels (Figure 2).
Page 98
Joomla! 1.7 - Beginners Guide When you access your Joomla! website you can see exactly these categories in the example data. The navigation uses links to the categories to show all the articles and sub categories (Figure 4). Even the breadcrumb navigation reects this structure.
Joomla! 1.7 - Beginners Guide a blog layout (like on the frontpage) a category list Depending on the layout you have plenty of options to congure the appearance and behavior of sub categories and articles.
This layout lists all the sub categories from one chosen category (Figure 7).
Joomla! 1.7 - Beginners Guide In this case the category description from the top level category Extensions is shown. One level of sub categories with their descriptions is also shown on the page, even empty categories. The articles in the top level category are hidden. Example: Administration Menus About Joomla! Using Extensions Edit.
The blog layout lists all the articles from one chosen category (Figure 8).
Page 101
A category list
The category list layout lists all the articles from one chosen category in a table structure (Figure 10).
Conclusion
! Sunday, 24 July 2011
Page 102
Joomla! 1.7 - Beginners Guide The category system in Joomla! 1.6 is very powerful and easy to use. You can easily structure your entire website by using a set of nested categories in a very user-friendly way. One article can be assigned to one category.
Page 103
Page 104
Chapter 8
1. unpublished until you are nished with editing and reviewing 2. published or scheduled (and possibly featured on the frontpage) 3. still published but may be removed from the frontpage 4. archived Sometimes it is necessary to unpublish content and sometimes you may put it into the trash. The content itself will, of course, continue to exist. It has not been deleted. You can lter most of the tables in the administration interface by the desired statuses and assign different statuses to your content as often as you would like.
No website visitor is able to see the content. It is the phase in which you edit and review your content. It depends on the users and visitors permissions whether they will be able to view the content but generally the content on your website should be visible because it has been published! The featured 'feature' is a switch you can use for your most important and latest content and is usually shown at the frontpage. It is an additional status because it is only relevant to articles. This is why it is possible for an article to be unpublished and featured.
Archived
There will come a time when you'll start thinking about an archive for your articles. Just set the status to archived and you've almost created an archive. Joomla! knows the creation date of your articles and offers an archive module to be shown on your site. The archive module is included in the example data. If it is not available, just create one in Modules New Archived Articles. Your articles will then be shown like in Figure 1. Read more in chapter Modules.
Page 105
Trash
The second last status is trash. If a content item ends up here it still exists and can be retrieved. You can place modules, menu items, categories, articles, contacts, and even more content in your trash. You can see the contents of your trash can by ltering it (Figure 2).
Figure 2: Trash
In the ltered view the Trash icon changes to Empty trash. This is your opportunity to delete content.
Page 106
Check In
The Check In icon in Joomla! may not be the kind you know from Foursquare31 or other location-based services. It is a security feature for editing your content. As soon as a user starts editing content, Joomla! locks this content for all other users. The advantage of this behavior is that changes by another user cannot be overwritten. That's a very convient feature. One big problem, however, appears when the user editing the content accidentally closes the browser window, allows the session to expire or the power plant shuts off the power or ... you get my point :-). Then the content is locked and no one else can edit it! No one else (except a user with proper permission, e.g. you as the administrator) can check in the content again to allow others to edit it. Unfortunately, you will only notice unchecked content by a small lock being displayed near the title (Figure 2) or by a cry for help from one of your users :-).
Figure 3: Check In
31 http://en.wikipedia.org/wiki/Foursquare_%28social_network%29
Page 107
Page 108
Chapter 9
GLOBAL CONFIGURATION
In the Global Conguration section you can dene all the settings that are valid for the entire website. Most values of the variables are saved in the conguration.php le. Vital information like user name, database name and password for the database server, for instance, and 'lesser' parameters such as the pre-determined length of displayed lists are stored in this le. The work area is divided into four tabs: Site Settings System Settings Server Settings Permissions The work area of every tab consists of dozens of elds, check boxes, switches and text areas. The easiest way to get a glimpse is to move your mouse across the labels to read the help text, which appears in a small yellow tooltip (Figure 1).
Page 109
Figure 1: Tooltips
Most of the options are self-explanatory. I'll mention a few settings that are new in Joomla! 1.6 with greater detail.
Site Settings
The Site settings have a new eld for setting the default access level for new users. Congurable access levels are a new feature (Read more: Users and Permissions). The Metadata settings now contain the option to add Content Right data. Joomla! will add your data to the meta declaration rights in your HTML code. Depending on your search engine optimization (SEO) 'religion', it is good or bad to have this declaration in your meta prole. Now Joomla! serves both :-)
<meta name="rights" content=" 2011 cocoate.com EURL, France" />
Page 110
System Settings
The user and media settings are no longer in this area. You will now find them in the User and Media
Manager. The cache settings are different because the underlying cache system was rewritten and now provides more possibilities. In general, a cache makes your sites faster by storing parts of the HTML in les. The web server can deliver these les extremly fast. It is possible to cache pages, component views and modules. You can purge and clear the cache in Site Maintenance.
Server Settings
All the server settings are the same as in Joomla! 1.5. Nevertheless, I'll mention the option Force SSL. This option is getting more and more attention. You can offer your users a completely secured trafc. It is necessary to have SSL congured in your web server and you need a SSL certicate.
Permissions
! Sunday, 24 July 2011
Page 111
Joomla! 1.7 - Beginners Guide Here is the place to set your global permissions for your user groups. Fortunately, it is not always necessary to change the default settings. If you change the setting for a group, it will apply to this and all sub groups, components and content. Basically you allow, deny and inherit the permissions Site Login, Admin Login, Super Admin, Access Component, Create, Delete, Edit, Edit State and Edit Own. Every group has their own set of permissions (Figure 4).
In every manager, you'll nd an Options icon where you can launch a conguration form. In some cases the options window has an additional permissions tab, e.g. the Category and the Article Manager. In this permissions tab, you can use your global permissions for the whole website or you can change them depending on your needs for all categories and articles. In both cases you'll also nd a Text Filter tab (Figure 5). The text lter is a concept, which allows you to search contributed text for patterns like HTML tags and lter them. It's possible to set different lters for different groups. Let's say a registered user is allowed to post text with HTML tags inside but without an iframe. Only your individual group 'iframers' has the right to post iframes!
Page 112
Page 113
Page 114
Chapter 10
Templates
The template is one of the most important pieces of a website. It provides the appearance, the design. It motivates new visitors to stay on your site and explore. Regular visitors and users appreciate being on a site with a beautiful and useful design. Think of other products, for instance. A car needs a good engine and tires but one of the most important reasons for buying one is often the design. Even if the design is not the main reason, it is often a trigger to contemplate the idea of purchasing and may cause a buyer to consider more tangible reasons. If the design is well-made, people expect the rest to be well-made, too. (Figure 1, Figure 2)!
32 33
Joomla! 1.7 - Beginners Guide Both of these cars are made for different target groups. They are an example of different approaches in design. Web design is somewhat like a handcraft. Possessing skills in techniques like HTML, CSS, JavaScript, PHP, image editing and many others is imperative. Joomla! is only one more tool in your toolbox. A good template is not only about colors and graphics. The shape and positioning of the content is just as important. The website has to be user-friendly and reliable. Exactly this challenge reminds me of the two cars again. Web design is still a young profession. A web designer often has to deal with low bandwith, incompatible browsers, inexperienced content editors and other people involved in the process of creating a 'good' website. The creation of a Joomla! website is often a process, in which everyone involved learns a lot. Good web design is hard work. :-)
POSITIONS
! Sunday, 24 July 2011
Page 116
Joomla! 1.7 - Beginners Guide You must know, of course, at which point you can assign modules at all. For this purpose, each template provides so-called positions. In order to see these positions you have to enable the Preview Module Positions switch (Extension - Template Manager - Options). After that, you can access your website by using the parameter tp=1 (http://localhost/index.php?tp=1). You'll see the emphasized module positions and their names (Figure 4). In Extensions - Module Manager you can assign one of these positions to a module. If you need the module at different positions, you may also copy it.
CORE TEMPLATES
Joomla! core comes with three site templates and two administrator templates. You can see a preview in Extensions Template Manager Tab Templates (Figure 5).
Page 117
STYLES
Styles are a new feature in Joomla! 1.6. They offer the possibility to create and use different versions of one template. A template has a minimum of one style. In this style, congurations can be made depending on the template, such as changing the colors or uploading the header logo. You may set the default style for your site in Extensions Template Manager Styles. You can lter between Site and Administrator Styles by choosing the location lter. The default template Beez2 comes with two predened styles: default and Parks Site. You can create additional styles by copying them. Each style can be assigned to a menu item. If you would like a green background on your site when people click on menu item A, for example, and a blue background when they click on menu item B, you can assign the corresponding styles (Figure 7).
Page 119
Page 120
Chapter 11
Navigation
Every site needs an easy to understand navigation, otherwise it will not be possible for a user to nd what he is looking for. This may sound simple but is not easily done. In a perfect world it should be possible to access any page on a website with two or three clicks. Another fact is, that often, if not always, your visitors will come from a search engine or social media site and will land anywhere on your site but your frontpage. This is a reason to think about a "Home" button on every page! A website often has a primary and a secondary navigation. The primary navigation is usually at the top or on the left or right side. Secondary navigation is at the bottom or at the top, but mostly a bit smaller than the primary navigation. It contains links like contact, about us and legal notices. The idea behind this is to have these links at the site but not at a very important position. As a general rule, do not put more than four to eight links in a navigation level.
BREADCRUMBS
A 'breadcrumb trail' is a navigation aid. The term comes from the trail of breadcrumbs left by Hansel and Gretel34 in the Brothers Grimm fairytale. Usually breadcrumbs are positioned horizontally on the top of a web page. Two structures are used: showing links back to each previous page the user clicked through to get to the current page showing the parent pages of the current one Breadcrumbs are a way to prevent visitors from feeling lost on your site. Ideally visitors should always know where they are on the site and how to go back. Joomla! provides a breadcrumb module for this task and most templates have a breadcrumb position reserved for it (Figure 1).
34
Figure 1: Breadcrumbs
JOOMLA! MENUS
Joomla navigations are created by so-called menus. You can create as many menus as you need for your website. Each menu may contain any number of nested menu items and you can even lter the level. A menu item is assigned to a component or an external URL. Modules and template styles can be assigned to menu items. In the example data, a few menus are shown that have already been created. Let's have a look at two examples of primary navigation with static pages and dynamic categories.
Preparation
! Sunday, 24 July 2011
Page 122
Joomla! 1.7 - Beginners Guide Create a book structure with a few chapters. The Joomla book Introduction Content How to use A How to use B Templates Before creating menu items, you have to create individual articles (pages) rst. Go to Content Article Manager Add new article (Figure 3). You may assign the uncategorized category to these articles or you can create a book category in advance and assign it to the chapters.
You can use an already existing menu as your primary links or you can create a new one by accessing Menus Menu Manager Add new Menu and lling out the form (Figure 4).
Joomla! 1.7 - Beginners Guide Go to Menus Primary links and add the six articles as links. Choose Single Article as Menu Item Type. Select the article and enter a Menu Title (Figure 5). If you have forgotten how to do that, have a look at the chapter How to create an 'About Us' Page.
Page 124
Preparations
We'll need a few categories with articles: Categories: News World Africa Europe Technology Internet Cars Create them or use existing categories (Read more: Structure Your Content with Categories).
Category News = all news should come up Category News World = we want world news only and so on (Figure 8).
Page 125
Page 126
Some tweaking
As you have seen, there are nearly innite possibilities of setting options. Many things are possible and there is usually a way to achieve your goals. Concerning the navigation design, it is possible to lter the level of the menu items in the module. It is possible, for example, to put the rst level of our News menu at the top position and the second and third level in the the left or right sidebar the whole menu on top and use drop down menus (depending on the capabilities of the template) If you play around a bit, you will nd a solution for nearly every case. The Joomla! navigation system may be a bit complex on one hand but is very powerful on the other.
Page 127
JOOMLAPOLIS!
Build your own community Personalize user profiles Share photos & videos Create unlimited user lists Scalable, reliable, robust Hundreds of plugins available Its free & open source
www.joomlapolis.com
Add subscriptions to your site Create your subscription plans Subscribers pay you Sell products and services Collect donations Control access to content Many powerful plugins included Nothing else even comes close
All 15 CB Teams Addons GroupJive 2.3 180+ page CB Reference Guide CB Content Module Guide CB P.M. Integration Guide CB Gallery Guide Free Updates for 12 months Priority Forum Support!
All 23 Incubator Addons All 15 CB Team Addons CB GroupJive plugin Access to CB Release Candidates 180+ page CB Reference Guide Free Updates for 12 months SLA Priority Forum Support! Optional Private Ticket Support
Works with CB 1.4 and J1.6! Add groups to your site Let users create their groups Users can join by invitation Communicate with Wall posts Have Photo albums and Videos Group events Dedicated forum area
The fastest Joomla! templates W3C Compliant Clean, professional look Native Joomla! 1.6, 1.5 Great for CB Fast and easy implementation Installation manual included
JOOMLABOOK17
Page 128
Chapter 12
35
User options
The form has three tabs Component In this area you are able to congure whether a registration is possible or not. One of the new features since Joomla! 1.6 is the possibility to congure in which user group the guests are in and in which user group the registered users are in by default. Mass mail It is possible to send a mass mail to your users. In this tab you can congure the static email settings. Permissions In this tab you can manage the permission settings for every user group.
Log in
Visitors can register on the website. Joomla!, therefore, offers a login module, which can be positioned at the site (Figure 2).
Page 130
Joomla! 1.7 - Beginners Guide activate and congure the plug-in (See also Contact component) The module provides several additional elds, even a Terms of service option, which user have to check during the registration process to accept the terms of service (Figure 5).
USER GROUPS
The idea of a user group is to create sets of permissions. "If you want to be an author on our site, you'll need the following permissions." Instead of assigning these permissions to every user they are assigned to a group. The user can be assigned to one or more groups. Imagine you have 10.000 users in four different groups. It's easy for the administrator to manage the permissions for the groups. Without groups you have to change every user account manually. If you use groups you only have to change permissions once! In Joomla! 1.7 it's up to you to congure any number of user groups. In User Manager - Groups, you have an overview of all the groups, which are in core Joomla! (Figure 6).
36
Page 133
Joomla! 1.7 - Beginners Guide Work on the menu item Site | Global Conguration Send a mass mailing to all users Change and/or install templates and language les Administrator An administrator is not allowed to: Upgrade a user to super administrator or modify a super administrator Work on the menu item Site | Global Conguration Send a mass mailing to all users Change and/or install templates and language les Super Administrator or Super user This user is allowed to execute all functions in Joomla! administration. Only a super administrator can add other super administrators.
ACCESS LEVELS
User groups can be assigned to access levels. So we have a user, connected to a group, connected to an access level (Figure 7, Figure 8)
Page 134
As we have seen, access levels are a bundle of groups. With the combination of group permissions and access levels it is possible to solve every use case. In an article e.g. you can limit the accessibility to an access level (Figure 9).
Page 135
Joomla! 1.7 - Beginners Guide Such functionality is needed in order to limit access to content and functions in large organizations or to support e-commerce and subscriptions based services use cases on Joomla websites. The Joomla ACL system is not only available for Joomla content and core functions, but also available for use in Joomla extensions. For instance Community Builder and other memberships management solutions can take advantage of this enhanced ACL functionality. Now everything is possible in the eld of permissions!
Page 136
Page 137
Page 138
Chapter 13
Extension Management
There is a lot in the core package of Joomla!. Words like components, modules, plug-ins, templates and languages you have already heard before. Besides these well known parts, Joomla! also consists of lesser known parts like libraries and packages. Additional components, modules, plugins and languages are listet in the Joomla! extension directory 37. The Joomla! project has no central place for templates und libraries. The reason for this is simple. Libraries are developed outside of the Joomla project and many were also used by other open source projects. Templates are something very individual and are, therefore, available on the websites of their designers. A central directory especially for templates would be helpful in the future. With the extension manager in Joomla! 1.7 you can install, update, discover und manage extensions directly from your Joomla! administration.
MANAGING EXTENSIONS
Let's have a look at all your installed 110 extensions in Extensions Extension Manager Manager. You can lter this list by various parameters. Some extensions are protected. Your Joomla! installation would no longer work if you uninstalled these protected extensions (Figure 1).
37
Joomla! 1.7 - Beginners Guide whether these tables will be deleted or not during de-installation. Check the manual or readme le in advance to avoid suprises. The last icon in the toolbar is the cache icon. Every extension is able to cache data. You can clear this cache separately for every extension. If your Joomla! site attracts lots of visitors and you don't want to clear the whole cache for performance reasons, you may need this function. If you lter the list for libraries, you will nd these four articles with the corresponding version number: Joomla! Application Famework, which is the real 'core' of the Joomla! 1.7 CMS. All the other extensions are built upon this framework. PHPMailer 38 is a class, written in PHP for sending emails. This is used in the mail to component. SimplePie 39 is a class, written in PHP for managing RSS ans Atom feeds. This is used in the newsfeeds component. phputf840 is a UTF-841 -capable library of functions mirroring PHP's own string functions. You can get an idea what this library does by reading UTF-8 and PHP42. If you lter the list for packages, you will nd nothing in Joomla! core. If you installed a language other than English, you will nd that language package there.
UPDATING EXTENSIONS
In this area, third-party extensions and the version of Joomla! core itself are listed. Here you can check for available extension updates available by clicking the Find Updates icon. If Joomla! nds an extension update and you want to update automatically, you have to ll in the FTP setttings form in Global Conguration Server FTP settings. Then select the extension you wish to update and click the Update icon. The process is fully automatic and you are going to receive messages and hints, depending on the extension, while updating.
INSTALLING EXTENSIONS
You can install extensions in three different ways (Figure 2):
38 39 40 41 42
http://phpmailer.worxware.com http://simplepie.org/ http://sourceforge.net/projects/phputf8/ http://en.wikipedia.org/wiki/UTF-8 http://www.phpwact.org/php/i18n/utf-8 Sunday, 24 July 2011 Page 140
FINDING EXTENSIONS
Sometimes things are go wrong during the installation process, like les being too big, permissions not being set correctly or for other strange reasons. In this area, Joomla! tries to nd extensions, which are not installed but nevertheless exist in the le directory. If one or more extensions are discovered, you can install them by using the FTP feature. Don't forget the correct FTP credentials in Global Conguration Server FTP settings. By using the discover operation, you can install multiple extensions at the same time!
WARNINGS
Error messages related to installations and updates will appear in this area. If you can't solve the problem by yourself, google the message text, you'll usually nd a solution or at least some advice.
Page 141
Page 142
Chapter 14
Core Extensions
As we have already seen in the extension manager, the Joomla! 1.7 package consists of many built-in extensions. We have already come in touch with a few of them. As a website user, you probably don't care much about the extension you are using as long as you nd that it is working. As an administrator, however, you have to know exactly what is going on. We have already looked at several Joomla! extensions like the content extension, which allows you to write and manage articles as well as publish them in different ways on the website. The user extension relates to users, the category extension to categories and so on. In the following chapters, I am going to cover the functionality of additional extensions that are part of the Joomla! core. In the Components menu, you will see Banners, Contacts, Messaging, Newsfeeds, Redirects, Search and Weblinks. We will have a look at these components including related modules and plugins, and last but not least, the Mass Mail Users feature of the User component, which allows you to send mass mails to all users.
Page 143
BANNERS
The banner component provides the option to display advertising banners on your site. A banner can consist of graphics or custom HTML code. Every time your site is accessed, a different banner will be displayed from your banner administration. You can click on these banners and they are linked to the client's site. The banner component offers client, category, and banner administration as well as detailed analyses. I will guide you through a complete real life example in this chapter. If you would like to sell advertisements on your website, there are three things you will need: clients, banners and pages on your website to display the banners. Oh, I forgot one. You also need trafc on your site. The more trafc, the better. Depending on the contract terms you have with your clients, you may also need a tracking overview with all the impressions and clicks. Let's begin with the client. I live in a tourist area and local businesses want to advertise their services. Joomla! offers yearly, monthly, weekly, daily and unlimited subscriptions. You can congure the default subscription type in Components - Banner Options. My client would like to pay a monthly fee to appear on all pages with three different rotating banners. I add the client in Components - Banner - Clients - New and ll in the form (Figure 1).
Page 144
43
Page 146
Page 147
Page 148
CONTACTS
Every website needs a contact form. Depending on the provider of the website sometimes you may need only one, sometimes more of these forms. If it is a website for a company with more than one department, they may want to have a contact form for every department. Perhaps you would like to display a contact form for every employee or every user account. All of this can be done by using the Joomla! contact component. As we have already seen (Read more in chapter: Contact Form), it's quite easy to set up a simple contact form. Simply create a contact, assign it to a category and create a menu item.
EXAMPLE
If several contact forms are needed, you should think about the underlying structure. Similar to article categories, it is possible to assign contact categories to menu items. As a result, you will see a list of contacts assigned to that category. If you click on the name or the title of these contacts, you will see more details and the form itself. I have tried different scenarios with the contact component and the possibilities are amazing! As everywhere in Joomla! 1.7 you have the option to create nested categories and different menu item types. In options (Components - Contact - Options), you can, for example, congure the appearance of the contact form (Slider, Tab, no formatting) and set an impressive number of other parameters. As an example I have created a contact area for our company with three contact forms for different kinds of inquiries and a contact form for each team member. By clicking on the links, the contact form and additional details will appear (Figure 1).
Page 149
Joomla! 1.7 - Beginners Guide For this example, I have created two categories: cocoate and team. The team category is a sub category of cocoate. It would have been possible to add an image and a description but I have decided to ll the title eld only (Figure 2).
Figure 3: Contacts
If any of the data changes, such as a phone number, for example, it would be nice for related users to be able to make these changes directly from their user prole on the website without having to access the administrator area. For this task Joomla! provides the User-Prole plug-in. You just have to activate it in Extensions - Plug-ins. In the user prole, a new area is displayed for the prole elds, which is connected to the contact component.
Page 150
MESSAGING
Messages is a core component of Joomla and a built-in private messaging system for backend users. It allows you to send and receive messages to other users with permission to access the administrator area. The messaging component is very easy to use; however, users often forget the possibility to congure the component in Components - Messages - My Settings. You can have the system email you every new message, delete them after an x amount of days, and you can also lock your inbox.
Page 151
NEWSFEEDS
Feeds are very handy. It is possible to subscribe to different kind of news and information. Unfortunately even today, often people don't use them for some inexplicable reasons. Thirty years ago you had to buy and read a newspaper to get to know the 'News'. Fifteen years ago you opened your browser and visited one website after another to get to know the "News". Today, you can still do both but it's also possible to use a feed aggregator. Google's reader44 and the dynamic bookmark toolbar of your browser (e.g. Firefox) are quite popular. The Joomla! 1.6 Newsfeeds component is an aggregator as well. Not as sophisticated like Google's reader, but also quite useful. The news feed component allows you to collect feeds from other sites and publish it on your site. In today's world of social media everyone probably has dozens of user accounts. Often videos and images are stored on youtube.com and ickr.com. In a company, the situation is even more complex. Imagine how much information is available as newsfeeds about a project like Joomla! or about your company.
44
Joomla! 1.7 - Beginners Guide articles or if you use the Feed Display module. You can create one in Extensions - Modules - New. Here is e.g. the New York Times feed (http://feeds.nytimes.com/nyt/rss/HomePage). Congure the module at position-4 and congure the Basic Options (Figure 3).
Page 154
Redirects
The redirect manager is a wonderful idea. It redirects a visitor to a valid page when he enters a path on your website that doesn't exist. It is possible that it existed before and was added to the search index of a search engine, or someone stored it at another website. This problem usually occurs after relaunching a website. The redirect component is very convenient. If someone tries to access a path that doesn't exist, Joomla! will show the 404 - not found page and simultaneously create a new entry in the redirect manager. When accessing Components - Redirects, you'll see these links (Figure 1). The System - redirect plugin has to be activated in Extensions Plug-ins.
Joomla! 1.7 - Beginners Guide When using Apache, go to Global Conguration Site SEO Settings Use Apache mod_rewrite and switch it to Yes. Afterwards, rename the le htaccess.txt to .htaccess. In some cases renaming the le may not be possible because the le starts with a dot. I use my ftp client or the shell for renaming the le (Figure 3).
Figure 3: .htaccess
Page 156
SEARCH
Joomla! uses full text search. Full text means that Joomla! searches for all keywords you enter in the search box directly in the database. This may sound obvious to most people, but it isn't. Many search engines rst create a search index consisting of words used on your website. During the actual search, the search index is browsed for matches. These matches are linked to the actual content. The search result page is based on these matches and links. Index-based search is faster than full text search but the index has to be updated with every website change; otherwise the new content cannot be found. In order to compensate for the performance advantage of the index-based search function, Joomla! is highly congurable.
To get a a rst glimpse of what visitors are searching for on your site, you have to switch on the statistics feature (Components Search Options: Gather Search Statistics - Yes). Then all the terms will be recorded and listet in Components - Search. Don't forget to also switch on Show Search results (Figure 1).
User interface
You can choose between a search box appearing on various pages of your website or a link to a seach form. The search extension provides a search module for the single box and a search layout for menu items. The search module is activated by default and most templates provide a special search position for it. It offers numerous options, including text conguration of the buttons as well as setting the box width (Figure 2).
Page 157
Page 158
Page 159
WEBLINKS
With the web links component, you can create a link list or a download section that you can integrate into your website. To do so, Joomla! provides the nested categories system and counts the individual hits on the links. This component is useful for link catalogs. Add as many web link categories as you need, create as many web links as you have, then connect both by assigning categories. Add a menu link, choose a layout and congure the options. The web links component provides three menu item type layouts: List All Web Link Categories, List Web Links in a Category and Submit a Web Link. We have already seen the rst two layouts in articles and categories. By using the third one, you can involve your users in the creation of a joint catalog. Create a menu item 'Submit a Web Link' in the user menu and set the permissions in Components Web Links Options to allow registered users to create links. The Options area provides six tabs full of congurable details. The example data includes a link catalog (Figure 1).
Page 160
Sometimes you want to send a message via email to all of your users. Sometimes you want to send that message only to a group of users or only to those having access to the backend. Sending emails is always a bit delicate. Nobody wants to be a SPAMMER and nobody wants to receive SPAM, so be careful! In order to use the mass mail user component, you have to congure Joomla! for sending emails in Global Conguration Server Mail settings. You may then congure the Subject Prex and the Mailbody Sufx in Users Mass Mail Users: Options - Mass Mail. The user interface of the Mass Mail Users component is easy to understand. You can choose the user group of those users who should receive the email. You can determine whether the sub user groups should also receive emails, whether the email is in html format or plain text, and whether all recipients are listed in the email or marked as BCC (Blind Carbon Copy). The message has a subject line and a mail body. You can use html but no wysiwyg editor is provided (Figure 1).
Page 161
Page 162
Chapter 15
Modules
A module is a content element that can be positioned next to an article. A menu, for example, is a module. The small registration block on the left side is also a module. You can create as many modules with smart functions as you need and position them on the predened area in the template. Modules are design elements in every template. Most of the time the search and the breadcrumb module have predened positions in a template. This is also true for the navigation module in the header area, often called "top" position.
ADVANCED OPTIONS
In Advanced
choose from different template layouts if the template offers this feature. add a module class sufx, which adds a text to the CSS class of the module. This is useful for individual styling. use the cache system by switching it on or off and set a time before the module is re-cached
CORE MODULES
The Joomla! 1.6 package contains 23 different module types. I will list and shortly describe them in alphabetical order. (The descriptions are partly taken from the Joomla! help). ! Sunday, 24 July 2011
Page 163
Joomla! 1.7 - Beginners Guide We already used the Archived Articles module in the chapter Statuses, Trash and Check-Ins, which offers a list of months and is linked to the archived articles. Articles Categories displays a list of categories from one parent category. Articles Category displays a list of articles from one or more categories. Articles - Newsash will display a xed number of articles from a specic category or a set of categories. You can congure ordering, number of articles, read more link and many more The Articles - Related Articles module displays other articles that are related to the one currently being viewed. These relations are established by the Meta Keywords. All the keywords of the current article are compared with all the keywords of all other published articles. For example, you may have an article on "Breeding Parrots" and another on "Hand Raising Black Cockatoos". If you include the keyword "parrot" in both articles, then the Related Items Module will list the "Breeding Parrots" article when viewing "Hand Raising Black Cockatoos" and vice versa. The Banners module displays the active banner, which we already used in chapter Banners The Breadcrumbs module display the navigation breadcrumbs, which were used in chapter Navigation. The Custom HTML module allows you to write your own HTML code and displays it in an appropriate module position. In Basic Options this module, has the usefull Prepare Content feature. Joomla! offers the possibility to apply additional functions to article content, like email cloaking, via the plug-in mechanism (Read more: Plug-Ins). If you turn on the Prepare Content, the HTML content you added to the module will be treated as any article content. The Feed display module enables the display of a syndicated feed. We used it in chapter Newsfeeds. The Footer module shows the Joomla! copyright information. You are allowed to deactivate it but your are also invited to keep at on your website! The Language Switcher module is new in Joomla! 1.6 - It displays a list of available content languages for switching between them. Read more about this feature in the chapter MultiLanguage Websites. The Latest News module shows a list of the most recently published articles. Filtering options are: by category, author and featured articles. The Latest Users module displays the latest registered users. You can link to the user prole, limit the amount of users and you may choose between different types of user information to be shown. The Login module displays a username and password login form. It also displays a link to retrieve a forgotten password. If user registration is enabled (User Manager Options), another link will be shown to enable self-registration for users. It is possible, for example, to add Sunday, 24 July 2011 Page 164
Joomla! 1.7 - Beginners Guide additional text to the form, to redirect your user after login and logout, and to encrypt the login form using SSL, which has to be provided by the web server. The Menu module is a container, which displays menu items of an existing menu. A menu can consist of nested menu items. You can lter these items by the start and end level, e.g., all the links from the second and third level. It is also possible to decide whether the sub menu item should be shown or not. The Most Read Content module shows a list of the currently published articles, which have the highest number of page views. You can lter by category and limit the number of articles. The Random Image module displays a random image from your chosen directory. Usually, you will use the media manager to stores these images. You can congure the le type of the image, a URL to redirect to if the image is clicked upon and you can adjust the width and the height of the images. However, be careful with the last option. Joomla! does not resize the original image; it only sets attributes in the img tag. The Search module displays a search box. You may congure the design of the box, the position and the text of the button. We already covered the search module in chapter Search. The Statistics module shows information about your server installation together with statistics on the website users, number of articles in your database and the number of web links you provide. The Syndication Feeds module creates a syndicated feed for the page where the module is displayed. It displays the an icon. You can enter a text to be displayed near the icon and choose the feed format (RSS 2.0, Atom 1.0). The Weblinks module displays weblinks from a category dened in the Weblinks component (Read more in chapter Weblinks). The Who's Online module displays the number of anonymous users (e.g. guests) and registered users (ones logged in) that are currently accessing the website. The Wrapper module shows an iFrame window at a specied location. You congure the URL where the external website is located, switch scroll bars on and off, dene the width and the height and give the iFrame a target name.
Page 165
JOOMLAPOLIS!
CBSubs: THE Member Subscription Solution for Joomla!
Sell your Joomla content Paid subscription levels Sell products and services Collect donations Promotional coupons Many powerful plugins included
www.joomlapolis.com
Build your business quick and easy with the best subscriptions membership management solution available for Joomla. Add value to your Joomla website by providing subscriber-only content and charging for access. CBSubs integrates with Joomla's ACL and with most popular Joomla extensions. Sit back and collect money with automated recurring billing. CBSubs supports almost any imaginable scenario: Membership subscriptions, Donations, Product selling and powerful promotions/coupons are included and can be combined into single checkout. Make money with CBSubs fast and simple!
...Quite simply, CBSubs has set the standard for flexible and powerful subscription websites for Joomla. Nothing else even comes close...
We love the power and flexibility that CBSubs gives us for managing users' profiles. The learning curve on our first project was time well spent as we are now doing things with Joomla that we didn't think were possible. That's why we are now working on our 10th CBSubs project!
Joe Palmer
YS
MONE
Y
B
AC
ISFACTIO SATARANTEE N D GU
JOOMLABOOK17
VALID UNTIL JAN 2012
30
Page 166
Chapter 16
Plug-Ins
A plug-in adds specic capabilities to a component. The term plug-in is also used in other places. For example, plug-ins are commonly used in web browsers to play videos. A well-known plug-in example is Adobe's Flash Player. A good example for the use of plug-ins in Joomla! is the Search component. Five search plug-ins work together to nd content from different Joomla! components. Joomla! has eight plug-in types: authentication, content, editors-xtd, editors, extension, search, system and user. These are also the names of the website sub directories where the plug-in les are located. For example, plug-ins with a type of authentication are located in the website directory plugins/ authentication. It is not possible and not necessary to create a plug-in in the adminstrator area like we have seen in the modules chapter. A plug-in has to be installed via the Extension Management.
AUTHENTICATION
Authentication in Joomla! is the process of verifyingwhether a user should bepermitted to do something on the site. Authorization, which is always the process that follows authentication, veries that an authenticated user has permission to do something. You authenticate with your username and password, and you are authorized by being a member of a permission group. (read more: Users and Permissions). Joomla! offers three possibilities for authentication (Figure 1). Be careful with deactivating plug-ins. You must have at least one authentication plug-in enabled or you will lose all access to your site.
Joomla!
The plug-in provides the standard behavior for Joomla!. You ll in the login form with your username and password and your login information is then veried.
GMail
! Sunday, 24 July 2011
Page 167
Joomla! 1.7 - Beginners Guide If you activate the GMail plug-in, userswill beable to log onto your siteby using their GMail address and password. Prior registration is not necessary. With the rst login, the System plug-in Joomla! will create a user account in its database. The GMail password is stored encrypted in the database, so your users GMail accounts cannot be hacked. This plug-in facilitates the login process for your users. Unfortunately, there is no advisory in the login form that loging inwithGMail is possible. You'll have to add additional text or nd another creative solution.
LDAP
The Lightweight Directory Access Protocol (LDAP) 45 is an application protocol for reading and editing data from directory service. It is used in companiesfor managing department afliation as well as employee phone numbers.
dn: cn=John Doe,dc=example,dc=com cn: John Doe givenName: John sn: Doe telephoneNumber: +1 888 555 6789 telephoneNumber: +1 888 555 1232 mail: [email protected] manager: cn=Barbara Doe,dc=example,dc=com objectClass: inetOrgPerson objectClass: organizationalPerson objectClass: person objectClass: top
In order to use this plug-in for authentication, you will need an LDAP Server (OpenLDAP) and you have to congure the LDAP plug-in with the server specic data. You will nd a good tutorial at joomla.org: LDAP from Scratch46 .
CONTENT
Besides the Joomla! content plug-in, all other content plug-ins are related to the text you insert into an article. The Custom HTML can use the content plug-ins as well (Figure 2).(Read more: Modules)
45 http://en.wikipedia.org/wiki/Ldap 46 http://community.joomla.org/component/zine/article/507-developer-ldap-from-scratch-sam-moffatt.html
Page 168
Joomla
1. When you attempt to delete a category, it veries whether the category is 'empty'. Empty means, no article or sub category is assigned to it. You can turn this feature off in Basic Settings. 2. If a new article is submitted via the frontend, the plug-in will send an email to all those users for whom Send Email is turned on (User Manager - Edit User). This feature can be turned off in Basic Settings.
Loading Modules
This plug-in loads the HTML output of all modules assigned to a template module position into an article.All you have to do iswrite {loadposition position-14} in the spacewhere the modules should displayed. This feature is especially useful for putting banner ads into the content.
Email Cloaking
This plug-in transforms an email address entered into the content in the form of [email protected] into a link, and cloaks the email address by means of JavaScript. The advantage of this is that email address collection programs can't read your email address very easily.
Code Highlighter
The GeSHi plug-inmakes Syntax Highlighting possibleand creates an impressive listing on your website if you embed the code to be formatted within <pre> </pre> HTML tags:
<pre> if ($number > 0) { echo $number; } else{ $number++;
Page 169
Pagebreak
The Pagebreak plug-in takes care of pagebreaks in articles. Just like the Image plug-in, it is easy to integrate into the content. Besides a simple pagebreak, various headers and page titles can also be dened. You can set pagebreaks using the pagebreak dialog. The page break will be displayed in the text window as a simple horizontal line. In the HTML code, the pagebreak looks like this:
<hr title="Page Title" alt="Table of Contents Alias" class="systempagebreak" />
This plug-in integrates the Next and Previous functions under the articles.
Page Navigation
This plug-in integrates the Next and Previous functions under the articles.
Vote
This plug-in adds voting functionality to articles. The four editors-xtd plug-ins generate the buttons below the editor window (Figure 3).
EDITORS-XTD
Article
Displays a button for linking the actual article to other existing articles. After clicking the button, a pop-up will be displayed allowing you to choose the article to link to.
Image
This plug-in displays a buttonfor inserting images into an article. After clicking the button, a pop-up will open allowing you to choose an image from the media directory or upload new les and congure its properties.
Pagebreak
! Sunday, 24 July 2011
Page 170
Joomla! 1.7 - Beginners Guide Provides a button to enable a pagebreak to be inserted into an article. A pop-up allows you to congure the settings to be used. The plug-in has to be activated together with the Content Pagebreak plug-in.
Readmore
Enables a button which allows you to easily insert the Read more link into an article.
EDITORS
Joomla! core comes with two editors (Figure 4). In Global Conguration - Site you can set the default editor for your website. Additionally, you can assign a different editor to every user account (User - Manager).
CodeMirror
CodeMirror47 is a JavaScript library that can be used to create a relatively pleasant editor interface for code-like content computer programs, HTML markup, and the like. This plug-in has to be activated if you want to offer textarea elds with the CodeMirror editor. You can congure the behavior of the editor in Basic Settings.
None
This plug-in has to be activated if you want to offer textarea elds without an editor.
TinyMCE
TinyMCE48 is a platform-independent web-based Javascript HTML WYSIWYG editor control. It is the default editor in Joomla!.
EXTENSION Joomla
The extension plug-in type is related to tasks concerning the managing of Joomla! extensions. This plug-in manages the update sites for extensions.
47 http://codemirror.net/ 48 http://tinymce.moxiecode.com/
Page 171
SEARCH
The Search plug-ins for Contents, Weblinks, Contacts, Categories, and Newsfeeds can be activated when needed. They implement the search function of the Search component (Read more in chapter Search). These plug-ins have to be activated if you are trying to obtain search results from the respective sections. If you want to search additional components, the respective plug-ins for those have to be available as well (Figure 5).
SYSTEM
System plug-ins are deeply integrated in the Joomla! framework, and they usually affect the behavior of theentire website (Figure 6).
This plug-in lters the displayed content depending on the language desired. It has to be enabled only when the Language Switcher module is published (read more in chapter: Modules)
Page 172
Joomla! 1.7 - Beginners Guide The Platform for Privacy Preferences Project (P3P)49, is a protocol allowing websites to declare their intended use of information they collect about browsing users. The system P3P policy plug-in allows Joomla! to send a customized string of P3P policy tags in the HTTP header. This is needed for the sessions to work properlywith certain browsers, i.e. Internet Explorer 6 and 7.
Cache
This module provides page caching. You can congure whether you would like to use the client's browser for caching pages.
Debug Log
This makes the debug function available, which is very important to programmers. You can congure the parameters to determine which information to display. This plug-in makes the system log les available. You can determine the location of the log le in Global Conguration - System - System Settings. This is an example of such a log le (/logs/error.php):
#Version: 1.0 #Date: 2011-07-06 12:39:38 #Fields: date time level c-ip status comment #Software: Joomla! 1.7.0 RC1 [ Ember ] 28-Jun-2011 23:00 GMT 2011-07-06 12:39:38 - 92.143.161.32 Joomla FAILURE: Empty password not allowed
Redirect
Provides the redirect feature in conjunction with the Redirects component.
Remember Me
This is a method for saving access data locally in a cookie in the client browser. Once a user visits your website again, the datais already in the form. This storage is only enabled by explicitly marking a checkbox below the login form.
SEF
SEF is the acronym for Search Engine Friendly. This plug-in creates search engine friendly URLs for content elements, which can be congured in Global Conguration - SEO Settings.
Logout USER
The system logout plug-in enables Joomla! to redirect the user to the home page if he chooses to logout while being ona protected access page. User plug-ins are related to user specic functions (Figure 7).
49
Prole
The user prole plug-in gives you the opportunity to ask the user for additonal prole elds, which can be congured in Basic Settings. Itcan also becombined with the contact creator plug-in to automatically create a contact item for every user(also see chapter Users and Permissions).
A plug-in to automatically create contact information for new users. It works in conjunction with the prole plug-in (also see chapter Users and Permissions). This plug-in creates a user in the database after the rst successful authentication.
Page 174
Page 175
Page 176
Chapter 17
Page 177
Page 178
Page 179
If you are reading this chapter, I assume you have already created a template style, gured out how to work with all of the available template options, but would still like to have more possibilities. Welcome to the world of HTML and CSS! I'll also assume that you know these two abbreviations. If not, have a look at wikipedia for HyperText Markup Language (HTML)50 and Cascading Styles Sheets (CSS)51. In Joomla! it is possible to edit all CSS used by the template within the Joomla! template manager. Go to Extensions - Template Manager - Templates and click on the link beez_20 Details. There, you will be able to make changes in the beez2 template as well as access all modiable les (Figure 3).
50 51
Joomla! 1.7 - Beginners Guide Print view This template is responsible for the output when you access the print view. htdocs/templates/[template_name]/component.php More template pieces like the les for the core overrides are located in htdocs/templates/ [template_name]/html. The core overrides cannot be edited from the administrator backend. The changes you make here will change the core Beez2 les. This is something to keep in mind in case of updates.
OVERRIDES
You have already created a style, changed the CSS les and the main page of your template and you are still unhappy with the result? :-) Then this is the perfect time to discuss overrides. In Joomla! there are two kinds of overrides: template overrides and alternative layouts.
TEMPLATE OVERRIDES
Let's assume you want to change the layout of the search result page. A component like the search component has a default template layout, which is stored in the le /httpdocs/components/ com_search/views/search/tmpl/default.php. This le makes the search page look the way it looks. Add a few words to the le, save it and you will immediately see the result! For example, add
<strong>I have changed something :-) </strong>
Page 181
Joomla! 1.7 - Beginners Guide scenes, you have overridden the original .../default.php le with your desired content layout without changing core code - well done! This system was introduced in the year of 2007 with the release of Joomla! 1.5 and still works very well today.
ALTERNATIVE LAYOUTS
In Joomla! 1.6 the overrides have an enhancement called alternative layouts. I am sure you have already seen the Alternative Layout eld in the edit form of articles, modules and categories (Figure 5).
Page 182
/htdocs/templates/atomic/html the folder for Override les - Atomic provides a few Overrides for modules. /htdocs/templates/atomic/images
the folder for images
/htdocs/templates/atomic/js the folder for Java script les /htdocs/templates/atomic/languages the folder for language les - Atomic comes with English base language les.
Joomla! 1.7 - Beginners Guide In line 24 you can choose whether you want to use the blueprint CSS framework or not. In line 50, 56, 62 and more you see that the template provides positions with special names (atomic-search, atomic-topmenu, ...). If you want to use these names you have to assign your modules to these positions. If you want to change the names, you may do that in the templatedetails.xml le. In line 48 you will see:
echo $this->baseurl ?>/templates/<?php echo $this->template ?>/js/template.js
Joomla! knows the values in baseurl as well as the name of your template and you can access them when needed. In line 48 you will see:
echo $app->getCfg('sitename');
It will tell you the name of your site. In line 50 you will see:
if($this->countModules('atomic-search')) ...
It counts the amount of modules at the position atomic-search. It is used to adjust your layout to different situations. In line 52 you will see:
<jdoc:include type="modules" name="atomic-search" style="none" />
This is a <jdoc> command, which only exists as a name space in Joomla!. It is used to insert the HTML output of the given type into the attributes. In this case it means the output of all modules assigned to the template position atomic search. The style attribute is called module chrome and can have these values table - The output is displayed in a table. horz - The output is displayed horizontally in a cell of a surrounding table. xhtml - The output is in in an XHTML-compliant <div> element. rounded - The output is in a format in which round corners can be displayed. The class of the element is renamed from moduletable to module. none - no formatting outline - the display type for the position preview (?tp=1) Template specic style - Some templates, like Beez, have their own styles. See chapter Angie Radtke About Her Beez Template. You will nd a complete list of styles in the Joomla! documentation - What is module chrome [6]. Other <jdoc> types are: ! Sunday, 24 July 2011 Page 184
Every page needs a head, sometimes a message (after saving) and, of course, a component. One component can be displayed per page. The component can make use of the module chrome as well. The error and the print view template les work exactly like the main template le.
CSS Folder
You will nd three les in this folder. 1. The css/template.css le with predened commented CSS commands. If you don't use the blueprint framework, you have to uncomment a few of them. The lines are specically marked. 2. The le css/template_ie.css is empty. Here you can add style overrides for Internet Explorer. 3. The le css/template_rtl.css is empty as well. You can add style overrides for right to left languages.
Blueprint framework
Blueprint is a CSS framework designed to reduce development time and ensure cross-browser compatibility. A few sentences taken from the readme le: Welcome to Blueprint! This is a CSS framework designed to cut down on your CSS development time. It gives you a solid foundation to build your own CSS commands. Here are some of the out-of-the-box features BP provides: * An easily customizable grid * Sensible default typography * A typographic baseline * Perfected browser CSS reset * A stylesheet for printing * Powerful scripts for customization * Absolutely no bloat! You will nd demos and tutorials on the project website - http://www.blueprintcss.org/ .
Page 185
Page 186
Chapter 18
Angie Radtke
Joomla! 1.7 - Beginners Guide WAI-ARIA Roles Landmark Automatic representation of the modules in accessible tabs Fade in and out of collapsible modules Fade in and out of collapsible column In beez_ 20 you can choose between two forms: natural or human In beez 5 HTML5 is usable
GENERAL ACCESSIBILITY
For most people the Internet has become the norm. Information from around the world are ready for retrieval and perhaps, more importantly, also the special offers at the local hardware store, the opening times of the registration ofce or the phone book are available on your home screen. Annoying phone calls or library visits are unnecessary, you just look on the net. But not everybody benets from this development. Those people, with any physical or mental disability have difculties to participate fully in society, even though they could benet enormously from communications technology. But they often fail because of barriers that obstruct their access to information or make it even impossible. Many of these barriers can be overcome, if the offers are designed accordingly. Operators of online shops or banks which provide Internet banking, should be aware of that not so small target group. Accessible web design aims at making content and interactions on the Internet accessible for all user groups and devices, if possible. Approx. 8% of the German population have a physical limitation that makes it difcult for them to access information from the Internet. Commonly the term accessibility in web design is identied with Internet for blind people. I want to emphasize that this is not all - indeed, this is only the smallest part. I've often wondered why this is so. Probably the reason is that the monitor has become the classic symbol for the computer, and someone who sees nothing, cannot use it. In my daily work, I have noticed that even blind people cope much better than people with other types of disabilities. Blind are people whose residual vision is only a few percent of the average value. The number of blind people in Germany lies between 150,000 to 200,000. Some of them can decipher just texts through the computer font size and customized colour settings, while others depend on acoustic information or read by touching the Braille display. Signicantly greater is the proportion of people with severe visual impairment. About a quarter of the population in working age complains of various degrees of ametropia. Later on, the percentage is much higher. Some of these problems can be compensated by glasses quite well, others with limitations only. Certain eye diseases such as cataract or glaucoma can be resolved or at least mitigated through surgery. Some, like retinitis pigmentosa or diabetic retinopathy, lead to a steady deterioration of vision and ultimately often lead to complete loss of ! Sunday, 24 July 2011 Page 188
Joomla! 1.7 - Beginners Guide vision. "In the so-called" tunnel vision, the visual eld of the affected people is extremely limited sometimes to the size of a two-Euro coin, which is held at arm length from the eyes. About 10% of the male population is affected by mild forms of colour blindness which usually means that some reds and greens cannot be distinguished from each other. Blind to other colours, complete colour blindness or red-green colour blindness in women are very rare. One other potential group of users has problems with the usual input technology - not everyone can use a mouse or a standard keyboard. There can be many reasons: arms and ngers are immobile or move spontaneously and are difcult to control. Others have even no arms and no hands or are paralyzed from the neck down after a stroke on one side. As long as a human being is capable to send a controlled binary signal the famous 0 or 1 he can learn to operate a computer and its functions with appropriate software. There are about 60,000 to 100,000 people in Germany with extremely limited ability to hear. Several thousand of these were disabled in learning the German language so that they know it only imperfectly (at the level 4th to 6th grade). This makes the demand for more understandable texts clear. To communicate with each other, but also for the reception of foreign or sophisticated content they prefer the German sign language - this is an idiom on its own, independent of the spoken language based on a system of signs and gestures. Attention Not only people with low hearing abilities surf the Internet without or with speakers turned off ! It is not sufcient, for example, to give acoustic warning signals only - they must always be accompanied by a clearly interpretable visual notice. The more the Internet conquered all areas of life, the more situational disabilities are visible: slow connections in the hotel, uncontrollable lighting conditions in the moving train, arranged waiver of sound in the workplace. All people benet from accessible websites. It is not about meeting all the rules to the fullest extent, which governmental institutions are required to comply to. Even small steps toward accessibility can signicantly improve the usability of a website. Due to its high penetration, Joomla! has the ability to inuence a lot. With the standard template beez it is now relatively easy, to create websites which are accessible and usable for many. As in beez 1.5 all those things that are necessary for the design of accessible templates are implemented also in beez_20 and beez5. The most important are: Separation of content and layout Semantically logical structure Anchors links
Page 189
Anchor Links
Linear presentation of content has a big drawback: You may have to travel a very long way, in order to access "in the back lying" areas of content. ! Sunday, 24 July 2011
Page 190
Joomla! 1.7 - Beginners Guide On the screen, a three-column layout allows that a number of areas begin above" and the eye can jump right to it, where it, supported by visual aids, suspects interesting information. Remedy offers the concept of anchors. It is, in fact, a non-visual counterpart to the graphical layout and allows the user of linear playback devices to identify key content areas at the beginning of the page and then immediately jump to the area where he/she believes the information of his/her interest lies. Practically, the use of anchors means, to set up an additional menu at the top of each page for internal navigation of the page. In most cases it will be useful to hide this menu from the graphical layout. It's irritating for users, that can see, to click a link, but nothing (apparently) is happening, because the link target is already visible in the viewport. In any case, the "anchor links menu" should be not too long and built in a very well thoughtthrough manner, because it extends and complicates, due to the linearisation itself, the path of perception. In general, it's advisable to offer the main content as the rst target jump, then regular visitors, who know the site and handle the navigation specically, have the shortest way to where they actually want to go to. At least here it becomes clear that, particularly websites with more complex content pages do not only need a graphical layout, but also a content design that aims to arrange the content in a form that it contains no unnecessary barriers for the users of linearising clients. Example:
<ul class="skiplinks"> <li><a href="#main" class="u2">Skip to content</a></li> <li><a href="#nav" class="u2">Jump to main navigation and login</a></li> </ul>
The colour choice is, in the context of accessibility, of particular importance because even people with impaired colour vision should be able to use your website fully. If you convert to a layout into shades of gray, you gain an approximate idea of what colourblind people can see. However, the perception is very individual and depending on the severity of different degrees of ametropia. Many colour-blind people, however, have learned during their life, what colours are represented by what they see. They know, for example, that grass is green, and they can identify by comparison and other shades of green. Much more widespread than the total colour blindness is the so-called red-green colour blindness. Affected by a genetic anomaly, people are not able to distinguish the colours red and green. Mixed colours that contain these colour components are blurred for them.
Contrasts
Page 191
Joomla! 1.7 - Beginners Guide Colours also play an important role in various other types of visual impairment, not only because of the colour itself, but also a signicant colour contrast can be helpful in the use of a web page. Foreground and background colour within the text elements should form a distinct contrast, though it is not possible to select the colour and contrast settings, which can meet all requirements. Black text on white background achieves a maximum colour contrast. To avoid disturbing glare effects, a slight tinge of the background can be useful. Some visually impaired people will need very strong contrasts to separate the individual elements of content in a page from each other. For them, colour combinations such as white text on a bright, contrasting orange background are not rich enough. In contrast, other strong contrasts act as a radiation the content is difcult to read.
In the Beez 2.0-Template, you can choose between personal and nature design. The implementation of the les nature.css and personal.css via the template parameters as well as the structure of the used CSS les are the basis for this method.
Page 192
Joomla! 1.7 - Beginners Guide For aesthetic reasons or to improve the search engine friendliness and accessibility, it may be necessary to position the navigation before or after the content. Both versions of the Beez templates let you choose between two options in the backend.
The variable $navposition is assigned to the currently selected value in the backend. The variable expels the value left or center. Left represents the position before the content, center stands for the positioning after the content. The term center seems to be a little confusing here, it would be logically better to say it is right. But depending on how you design the CSS, you can place the navigation in three-column view in the middle.
53
Joomla! 1.7 - Beginners Guide To focus means nothing else than to place the cursor in the appropriate place to make the positioned content accessible. In HTML and XHTML we did not had the opportunity to focus on all elements. Only the interaction elements such as links, buttons or input elds were focusable. This has changed with the use of WAI ARIA and HTML5. The used scripts within the Beez templates rely on this technique to make the template accessible to people with disabilities.
Inside the Beez template, this is done automatically by using javascript (javascript/hide.js). The approval of the Wai-Aria technology is still pending and with the direct implementation into the source code the website would fail doing the validation test. A complete overview of the landmark roles can be found at http://www.w3.org/TR/waiaria/roles#landmark_roles. If you later use the Beez template as the basis for your own template and modify the structure of page areas, you should adapt the script accordingly.
Hide Column
To test this functionality, you have to place a module in the column for additional information. The module positions position-6, position-8 and position-3 are available. No matter whether the navigation is before or after the content, whenever this column is displayed, a link appears right above with the text "close info".
Page 194
The textual contents of the JavaScript variables are controlled with the Joomla language strings.
Joomla! 1.7 - Beginners Guide One of the biggest challenges in designing a website is the clear structuring of the content. Especially on the homepage, you often need to place a variety of information without cluttering the page.
Figure 4: beez-Slider
Both Beez templates have the opportunity to present modules in the form of sliders. Here, the rst output is the title of the module. By clicking on the plus sign next to the heading, the module opens and its contents will be visible. Then, the plus sign replaced by a minus sign and the module can be folded back. Even with this method I have used the WAI ARIA technology. In order to use modules as described, they should be integrated in the template by using the command.
<jdoc:include type="modules" headerLevel="3" state="0" /> name="position-8" style="beezHide"
By using the style = "beezHide" all modules that are loaded at this position are shown as sliders. You may have noticed that the command includes the attribute state, which controls whether the module is expanded or collapsed. If you choose the value 0, it is closed when it rst loads, select the value 1, it is opened by default and can be closed by the user.
Accessible Tabs
The presentation of content in so-called Tabs is becoming increasingly popular. There are already modules that Joomla! extends with this functionality. But none of the offered modules fullled the requirements of accessibility.
Page 196
Figure 5: BeezTabs
The integrated solution in Beez is based on the WAI-ARIA techniques to ensure accessibility. To represent the modules in tabs, they are integrated as follows.
<jdoc:include type="modules" headerLevel="2" id="1" /> name="position-5" style="beezTabs"
All on the position-5 placed modules are arranged automatically in the form of tabs. You control the HTML output via the Style beezTabs. The use of the attribute id = "3" is mandatory. The reason lies in the structure of the used JavaScripts. Imagine, you want to integrate modules at different places into your template. The JavaScript function requires a unique information about where which tabs should be opened and closed. If this information is missing, the script will not work as desired. Please use at this point numbers only for the id.
In the top head of the layout the user is able to change the font size. The technical basis for this function can be found in the JavaScript le templates/your_name/JavaScript/md_stylechanger.js. Within the index.php you include a div container with id="fontsize". This area is initially empty and will then be lled dynamically with content using JavaScript. If your visitors should have turned off JavaScript, this function is not available. Some might be asking, why this function is still necessary, as every browser has a feature to increase font size. Especially for older people this technique is often of particular importance, since most of them have a more or less impaired vision. However, particularly older people often know very little about the functionality of web browsers and look forward to an apparent offer.
Page 197
Joomla! 1.7 - Beginners Guide This is based on the HTML5 template overrides, which you nd in the HTML folder of your template. HTML5 provides a variety of new possibilities and will bring a number of changes and easements in the future, but it is still not yet an approved standard (March 2011). Many of the options offered are currently not reliably applicable, but others can already be used without difculties. A very important part, which already works, are the new structuring elements. HTML4 and XHTML had low semantic weight. This has improved signicantly with HTML5. We have now really practical elements to structure the page. With the elements header footer aside nav you can structure a wonderful page. Elements such as section article hgroup help you to assign more importance to the actual content. The HTML5 code in Beez5 uses only the elements that are reliable right now. Only the Internet Explorer Version 8 has some problems, as always. In the top of the page a script is inserted, which integrates the unknown elements in the existing document structure.
<!--[if lt IE 9]> <script type="text/JavaScript" src="<?php templates/beez5/JavaScript/html5.js"></script> <![endif]--> echo $this->baseurl ?>/
Basis for the integration of HTML5 in Joomla! are the template overrides and the response to the selected markup language via the template parameter in the index.php. Because the template allows the use of two different markup languages, you have to approach this possibility in the index.php.
Page 198
Joomla! 1.7 - Beginners Guide Clearly said: The construction of the index.php is quite complicated, because depending on the selected markup language another HTML code is generated. It starts with dening the type of document. When you open the index.php of Beez5 templates, you can instantly see what I mean.
<?php if(!$templateparams->get('html5', 0)): ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http:// www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><?php else: ?> <?php echo '<!DOCTYPE html>'; ?> <?php endif; ?>
This concept is carried through the whole page and the HTML5 elements can only be issued if HTML5 was also selected in the backend. If you later want to build your own template in HTML 5, it would be better you remove all the queries and XHTML elements and output directly the HTML 5 code.
Page 199
Page 200
Chapter 19
GETTING INDEXED
Search engines use so-called web crawlers. Once they visit your website, they follow each link on the frontpage and add all those pages to the search index. Keep in mind that web crawlers don't 'see' the site. They are not a human being, they do not use a browser to render your page, they simply look at your HTML code. Sometimes the number of possible URLs they nd is so high that it becomes difcult for them to follow them all. This often happens with lists of content items with the possibility of ltering the display or those having a page navigation. Endless combinations of parameters are possible and only a few will return unique content. Once your website is nished, one of the rst steps for you is to say "hi" to the robots of your choice and give them more information about your site. Search engines are very interested in
54 http://en.wikipedia.org/wiki/Search_engine_optimization 55 http://en.wikipedia.org/wiki/PageRank
Page 201
Joomla! 1.7 - Beginners Guide knowing about your website because it makes their life easier, too. Try Google Webmaster Tools 56 and the Bing Webmaster Toolbox57.
MY PERSONAL VIEW
If you are using a CMS like Joomla! 1.7 and a template like Beez2, your HTML output is technically perfect. As I already said in the chapter Managing Content A content management system is useful for managing information that provides value for your audience
Page 202
Joomla! 1.7 - Beginners Guide If you create useful information with value for you audience within your website, be sure, every search engine will notice that. By the way, ever heard of the Nigritude Ultramarine59?
59 http://en.wikipedia.org/wiki/Nigritude_ultramarine
Page 203
Page 204
Chapter 20
Multi-Language Websites
I live in Europe. Europe has 23 ofcial languages. If you are going to create websites in regions like this, you have to think about multilingualism. Two things are especially challenging when it comes to creating multi-language websites: the translation of the static Joomla! text strings as well as the translation of the content items. While the rst challenge can normally be overcome easily, the second one presents the real challenge. The Joomla! 1.7 core is available in more than 40 languages languages and more languages are expected to come soon. Let's build a multi-language website by using Joomla! 1.6 core in this chapter.
Language Conguration
As of now, it is still necessary to have a look at the language conguration to see whether the languages are published (Extension Language Manager Installed) and the language content attributes are correct (Figure 2). Have a look at (Extension Language Manager Content). If there is no content item for the installed language, create one by clicking the new icon. This is what happened to me after I had installed the French language package.
60 http://joomlacode.org/gf/project/jtranslation1_6/frs/ 61 http://extensions.joomla.org/extensions/languages/translations-for-joomla
Page 205
Joomla! 1.7 - Beginners Guide templates positions for this module in the near future. In the default template Beez2, position-7 works well in combination with the ags.
As I have previously mentioned, each content item, such as an article, can be assigned to a language. The difculty now lies in creating all these content items in all source and target languages (Figure 5).
A MULTI-LANGUAGE WEBSITE
My example website consists of Sunday, 24 July 2011
Page 207
Joomla! 1.7 - Beginners Guide a front page with articles, a blog, an 'About Us' page, a contact form.
Front page
I create a few articles for each language with the attribute featured (Read more in chapter: A Typical Article) I create a menu called default with a menu item called default, which links to Featured Articles. I congure this menu item as Home by clicking the Home icon. The menu default needs no corresponding module, it should simply exist (This behaviour is in the actual version of Joomla! 1.7 and will hopefully be changed in the upcoming updates). Afterwards I create a menu per language and the corresponding menu module. I create a menu item for each language : (Home, Front Page, Accueil). These menu links have to be congured as Home by clicking the Home icon (Figure 6, 7). If you see the ag beside the menu item, everything works ne, if not ... watch the screencast :) 62
62
A blog
In my case I already have a blog at cocoate.com, so I use the newsfeeds component for displaying the external blog entries. I create a feed item for each language and the corresponding menu items (Read more in chapter: Newsfeeds).
A contact form
I use a single contact form for genaral inquiries. I only need one contact item, so it is not necessary to assign a language. Only if contact data differs in different languages, e.g., different address or email, will it be necessary to create one contact item for each language.
Login form
On each page a login form will be visible. I have copied the English login module twice, congured the menu assigment, changed the title and assigned the correct language. Now it is possible to login and register at my site. User menu I used the existing user menu, which provides you with a link to your prole as well as for creating an article or weblinks. (Figure 8).
Page 209
Page 210
Page 211
Chapter 21
Start a discussion with the client about their organization, whether it's a business, a nonprot, or a personal website. You might ask some of the following questions, and there are many additional questions to these: ! Sunday, 24 July 2011 Page 212
Joomla! 1.7 - Beginners Guide What is the goal of the organization? (Examples: end world hunger, make money by selling knitting products, provide updates about my latest activities) When was the organization founded and who does the organization serve? Why does the organization need a website? Does a website already exist, or is this a new site? If a site already exists, what is worth keeping in the old site? What would you add to the content of the old site? Is the site's message still on target, or has the organization changed since the last site design? Who will be maintaining the website? (Examples: IT staff, in-house webmaster, the secretary in addition to other duties, or the organization sends its updates to you to complete) You will likely want to ask many additional questions to these above to fully understand your client and the answers to the following three key questions: What are the goals of this organization? What are the goals of the website, and how does it support the goals of the organization? What do the site visitors want from the website, and how does that t with the goals of the website and the organization? Out of this discussion, you should identify some extension types you'll need to include on your site (for example: a calendar with an "upcoming events" module; a blog with comments and tagging; a shopping cart that interfaces with PayPal). You should also develop a site map for your website. This is a detailed description of all pages on your site and how they link together. The term site map also refers to a page on your site containing links to every page on the site. The rst site map you create is spelling out all of the pages and navigation structure on a piece of paper, and the second site map can be generated by an extension like XMap. For more information on website planning, I recommend the following resources: The Elements of User Experience63 , by Jesse James Garrett "Website Strategy and Planning" 64, lynda.com video training, by Jen Kramer
63 64
http://www.amazon.com/gp/product/0321683684/
Joomla! 1.7 - Beginners Guide Clients may wish to know why you've chosen Joomla for the site, or why it's a good choice of technology for them. Some arguments I use when selling Joomla include: Joomla is one of the top three open source content management systems 65 in the world, backed by a thriving community and an active development process. New releases of software occur every six months. Joomla powers over 23.5 million sites worldwide66, and it is the choice of over 3000 government sites. Because Joomla is open source technology, the client is not tied to a single web development rm, the way they would be with proprietary software. There are many rms available to help with your site. Joomla's interface is easy to use, and clients love the ability to make changes to their site without involving a web developer. It's unlikely you'll use just Joomla's core to build your website. In most cases, you'll want to add some third party extensions to your website. A great place to start looking for these is the Joomla Extension Directory 67 (JED). Debating which Joomla extensions are "best" or "critical" to each website is a topic of conversation that never seems to get old among Joomla designers and developers. Do not stack your Joomla site with endless extensions. It's best to pick a minimum number of extensions, just the ones you need most, and don't load the site up with unneccesary additional technology. Each extension should address a purpose identied as part of the goals development process described above. Just because you can put in extra extensions because they're "cool" or you think they're interesting to use does not necessarily mean they should be used on the site, unless they contribute to reaching a site goal.
With a plan established and extensions selected, and your site map in place, you are ready to assemble your Joomla website. 2. Create categories for your planned content. The categories may be driven by your site map. For example, if you have a part of the site called About Us, you might create a corresponding category. Pages like Board of Directors, History, Mission and Vision, and Management would be included under this category.
65 66
http://trends.builtwith.com/cms
http://techcrunch.com/2011/06/11/joomla-quietly-crosses-23-million-downloads-nowpowering-over-2600-government-sites/
67
Joomla! 1.7 - Beginners Guide 3. Enter your content into the website using the Article Manager. Each planned page might become an article. Helpful resources for understanding this process include: 3.1. 3.2. A Typical Article How to Create an 'About Us' Page
3.3. Media Manager, which is used for managing any images or documents you wish to include with your article 4. Link articles to your navigation bars on the website via the Menu Item Manager. 5. Install a template that makes the website look the way you wish. You can do this step earlier, but I nd it easier to evaluate the look of a template once some content is available to me in the website. 6. Congure any extensions required for your website. For example, it's highly likely that you will want to include a contact form for your site. 7. Test your website carefully. Make sure the navigation links to the expected pages and functions on the site. Read all content carefully for typos. Look at the site in several different web browsers (like Firefox, Safari, Chrome, and Internet Explorer) on both Mac and PC platforms. The site does not need to be exactly the same, but it should look reasonable in all browsers. 8. Launch your website. You may wish to do a "soft launch" rst, meaning you post the site without press releases or a big public promotion. This gives you some time to test the site in a real-world environment, while xing any additional problems that may arise. Once the site has been active for a week or two, you can do a "hard launch", meaning creating publicity for the new site.
Page 215
Page 216
Page 217
Chapter 22
Joomla! 1.7 - Beginners Guide speed of operation, ease of administration, improved security, and the overview! The most innovative ideas for the back-end are two extensions by Stephen Brandon of New Zealand. His extensions are named MetaMod (free and pro version) and Chameleon (formerly MetaTemplate Pro)! This is small summary of the extensions directly from the creator:
MetaMod
Have you ever been in a situation on your Joomla! site where you wanted modules to appear or disappear on a particular page, but it seemed impossible to achieve? You probably found that you can only assign modules to pages that are directly assigned to a menu item. MetaMod gets around this fundamental Joomla! restriction, and allows you to make modules display (or disappear) on absolutely any page of your site. Furthermore, modules can be controlled by a number of additional factors: date and time (e.g. recurring time slots) page type (e.g. article pages, or search results pages) GeoIP country, city, area etc group membership, or for specic users browser or front-end language comprehensive VirtueMart support, and support/detection for many other major extensions random selection and more! MetaMod Pro is commercial GPL, reasonably priced, and backed by comprehensive support on the forum. If there's ever something unusual you need to do with modules, ask on the forum. Chances are, with MetaMod Pro it's possible. Licence: Commercial GPL The free version of MetaMod works in almost the same way as MetaMod Pro, but just has a few limitations in the way that the "target" modules are laid out on the page. In the free version, the target modules are placed within a MetaMod "placeholder" module, which introduces extra HTML around the included module(s). This can sometimes cause CSS styling anomalies, and can prevent module positions from collapsing even when it appears that they do not contain any published modules. Despite the possible layout issues, MetaMod (free) is used in thousands of ! Sunday, 24 July 2011
Page 219
Joomla! 1.7 - Beginners Guide web sites around the world and is a great way to learn MetaMod and to try it out in different situations. Licence: GPL
With Chameleon your site can change templates and menus to t different situations (Figure
Page 220
Joomla! 1.7 - Beginners Guide or by their country or language. Perform A/B testing on different templates & menus and nd out what converts best. Chameleon in eCommerce: Streamline the users shopping experience by switching to a simplied template for checkout or other parts of the shopping cart system. Chameleon for site admins: Make your site multi-purpose; embed it in a Facebook tab, switch templates for different devices, or choose a different template, menu and home page for different sub-domains of your site. Chameleon is unique, revolutionary technology. There is no other software available on the market which can help you identify, then attempt to match customer expectations from the moment they land on your Joomla! site. Licence: Commercial GPL http://metamodpro.com
Topic: SEO
Why this may be helpful: For better search engine results. Proposed extension: shs404SEF sh404SEF rewrites Joomla URL to user-friendly format (SEF URL or URL rewriting): mysite.com/index.php?option=com_content&Itemid=69&id=34... becomes mysite.com/en/ sh404SEF-and-url-rewriting/list-of-available-plugins.html. ! Sunday, 24 July 2011 Page 221
Joomla! 1.7 - Beginners Guide It is a security component, as well as a page title and meta tags manager for every page. Works with or without .htaccess le. It is Joomsh compatible. It is a caching system for high speed with very small DB queries overhead. A lot of well known components will be supported. http://anything-digital.com/sh404sef/seo-analytics-and-security-for-joomla.html
Topic: Antispam
Why this may be helpful: Now, more so than ever, a protection against spam is absolutely important! Proposed extension: EasyCalcCheck PLUS In the core forms and also with 3rd party extensions, there is no protection against spam. This nice plugin adds an arithmetic problem, a hidden eld and a time lock. Integrated anti-spam services are: ReCaptcha, Akismet, Bot-Trap, Honeypot Project, Mollom, StopForumSpam, and BotScout http://joomla-extensions.kubik-rubik.de/ecc-easycalccheck-plus
Why this may be helpful: The Joomla! editor has the necessary functions. An extra editor, such as this, provides many useful opportunities. Proposed extension: JCE Editor If you want to work more productively writing articles, an extra editor will be helpful! A well known, congurable WYSIWYG editor based on Moxiecode TinyMCE, is the JCE Editor. It includes advanced Image/Media, File and Link handling, plugin support, and an Administration interface for the editor conguration. http://www.joomlackeditor.com/
Why this may be helpful: These are two nice plugins from Peter von Westen and one from Mike Reumer which I have added to the list! Proposed extensions: Modules Anywhere, Articles Anywhere, Plugin Include Component
Modules Anywhere
Page 222
Joomla! 1.7 - Beginners Guide With this plugin you can place modules anywhere that you can enter text. With Modules Anywhere you can include a single module or complete module positions anywhere in your site, including within 3rd party components and even within other modules. Modules Anywhere is very exible, it works anywhere, not only in articles. It even works in modules and you can load a single module, not only complete module positions. http://www.nonumber.nl/modulesanywhere
Articles Anywhere
With this plugin you can place articles anywhere that you can enter text. Articles Anywhere is a plugin that allows you to insert articles anywhere on your site. So you can place articles inside modules or in other components or wherever. You can place articles using the syntax: Using the title of the article: {article Some article}...{/article} Using the alias of the article: {article some-article}...{/article} Using the id of the module: {article 123}...{/article} Within those tags you can place different tags to place different article data/details. http://www.nonumber.nl/articlesanywhere
Why this may be helpful: With this plugin you can use different scripts inside Joomla. Proposed extension: Embed Any Script
Page 223
Joomla! 1.7 - Beginners Guide Include JS, VB scripts to your site with ease! With this plugin, you will be able to embed a list of scripts in every page of the site. As well, the plugin supports in-article tags to embed scripts only to specic pages. Those tags can be, not only in articles, but also in modules etc. - anywhere in html. http://tushev.org/
Topic: Filemanager
Why this may be helpful: Faster and more clearly arranged le management Proposed extension: eXtplorer eXtplorer is a web-based le management component, for all your needs. It has a desktopapplication-like interface with drag&drop, a grid and a directory tree, and makes heavy use of the ExtJS Javascript Library. You can use it to access and modify the les and directories on your server via FTP or direct le access. http://extplorer.sourceforge.net/
Why this may be helpful: This simple plugin will prevent admin session expiration. Prevent a loss, for example, of input texts. Proposed extension: Admin Forever You will never be logged out when you don't want it to happen. http://edo.webmaster.am/projects
Topic: Compression
Why this may be helpful: Minimize external Javascripts and CSS les into one, to minimize expensive http request.
Page 224
Joomla! 1.7 - Beginners Guide Proposed extension: JCH Optimize The les can be minied and gzipped to reduce bandwidth and to further optimize download time. Typical results after plugin is congured with optimum settings for your site is a 6-10 point jump on Page Speed. http://jch-optimize.sourceforge.net/
Why this may be helpful: Intelligent caching makes accessing the pages faster Proposed extension: JOT Cache JotCache is an advanced solution for page caching in Joomla! 1.6 framework. JotCache consists of JotCache Plugin and JotCache Component. JotCache Plugin is an extended replacement of the standard System-Cache plugin, but with a lot of enhancements! http://www.kanich.net/radio/site/
Joomla! 1.7 - Beginners Guide This will be great in campaigns, live chat usage, Find us and Follow us use. http://www.o-sense.com/
Topic: Contact
Why this may be helpful: The contact component from Joomla! is very simple and has only a few possibilities. Proposed extension: Fox Contact form A fast and very easy to setup contact form designed for Joomla! 1.6. Tableless and css styled output simplify integration into your website. Some interesting features: Multiple recipients Antispam system Captcha system Multi-language and more http://www.fox.ra.it/joomla-extensions/fox-contact-form.html
Topic: Search
Why this may be helpful: Your visitors can quickly detect whether a keyword is available on the website. Proposed extension: RokAjaxsearch This powerful module brings fantastic search functionality to Joomla!, using the powerful and versatile javascript library, Mootools, as well as full Google Search integration(Figure 3).
Page 226
Topic: Slideshow
Why this may be helpful: Nearly every modern website has a slideshow, often on the frontpage. It helps to give the visitors a nice impression of your identity. Proposed extensions: Image Show GK4 LOF Articles Slideshow Module
Joomla! 1.7 - Beginners Guide with an easy way to control the module display via simple parameters, you can do everything you would like, to impress you client. http://landofcoder.com/joomla/f33/lof-articlesslideshow-module
Why this may be helpful: With new cameras, it is easy and cheap to shoot your own videos and to put them on your site. Proposed extension: JPlayer JPlayer is a simple ash player plugin for Joomla based on ash player "JW Player". This plugin is a fork of AllVideos plugin (by JoomlaWorks). JPlayer has simplied code without unnecessary functions but is enhanced with lots of useful features. The plugin is easy to use, offers a lot of tunable parameters, plays video with subtitles and much more. http://vault.futurama.sk/joomla/
Topic: Gallery
Why this may be helpful: An easy way to make your own photo album! Proposed extension: Phoca Gallery, Simple Image Gallery (SIGE)
Phoca Gallery
Phoca Gallery is a Joomla! component that offer an image gallery with slideshow. With a lot of add-ons, it meets almost all requirements. http://www.phoca.cz/phocagallery/
SIGE (Simple Image Gallery Extended) is a powerful gallery content plugin for Joomla!. It offers numerous opportunities to present pictures quickly and easily in articles. The special feature of the plugin is that you can control any parameter on the syntax call. http://joomla-extensions.kubik-rubik.de/sige-simple-image-gallery-extended
Why this may be helpful: Facebook is, at this time, a must-have platform to make your site popular. Proposed extension: Facebook Link Content Image It adds in the header of the page, absolute links to images found in article. It is useful for sharing links on the Facebook Wall. Compatible with Open Graph. Plugin works only for ! Sunday, 24 July 2011 Page 228
Joomla! 1.7 - Beginners Guide components which res events from Content Plugins, e.g. Joomla! Articles, Section/Category Blog, Frontpage/Featured. It Works only for HTTP urls! http://www.perfect-web.pl/download/joomla/plugins
Topic: Tweet
Why this may be helpful: More and more people build up their own tweet to inform others very quickly about their news. Proposed extension: Tweet Display 1901 Tweet Display 1901 is a simple module, that will automatically show your twitter feed in a nice widget on you site. http://a.1901webdesign.com/
Topic: Menu
Why this may be helpful: Upgrade your own website and make it more accessible with helpful advanced navigation! Proposed extension: Art Wijmo Menu Art Wijmo Menu is a free customizable menu with horizontal and vertical layouts with multiple themes! http://www.artetics.com/ A good alternative module: Maxi Menu CK
Topic: Sitemap
Why this may be helpful: A sitemap is good for visitors and good for search engines! Proposed extension: XMap
Page 229
Joomla! 1.7 - Beginners Guide Xmap is a Site Map generator component for Joomla!. Xmap allows you to create a map of your site using the structure of your menus. A lot of plugins are available for the most popular components! http://joomla.vargas.co.cr/
Topic: Typograghie
Why this may be helpful: Easily usable graphical enhancements for its own articles Proposed extension: JB Type JB Type is a Joomla style and typography plugin for your content. By using some simple Joomla! syntax you can create some awesome typography for your site without knowing any html at all. The plugin simply renders predened styles in your content. Now it comes with a JCE plugin that allows you to render the JB Type styles in the editor window as well. http://www.joomlabamboo.com/joomla-extensions/jb-type-joomla-typography-plugin
Topic: Favicon
Why this may be helpful: Eyecatching web address ! Sunday, 24 July 2011
Page 230
Joomla! 1.7 - Beginners Guide Proposed extension: Phoca FaviconA simple component that generates a favicon on your Joomla! site. You can change the favicon whenever you like. http://www.phoca.cz/phocafavicon/
Page 231
Page 232
Page 233
Chapter 23
68 69
How can you migrate a Joomla! 1.5 website to Joomla! 1.7 without loss of data or similar disasters? There are two ways to complete the update: 1. You can update the existing Joomla! 1.5 website by using an additional component. This component loads all the necessary les with one click to your Joomla! 1.5 website and automatically converts them to Joomla! 1.7. 2. You can create an empty Joomla! 1.7 website and insert the data from the Joomla! 1.5 websitemanually. Auto upgrade from Joomla! 1.5 to Joomla! 1.7 WARNING: The upgrade component I am using does not allow the transfer of data from ALL third-party components. But, generally, I think the idea is a good one. :-) Before you begin, please answer the following questions with a loud and clear YES. Does your server environment meet the minimum requirements for Joomla! 1.7? PHP, version 5.2.4 or higher (Not for Joomla 1.7 but for the upgrade component, you willneed the CURL module in PHP.) MySQL, version 5.0.4 or higher Are all the installed extensions availablefor Joomla! 1.7? Have a look at the extension directory extensions 70. Is the installed template available for Joomla! 1.7, or are you able to change it manually? Here is a good presentation by Chris Davenport. It's about Joomla! 1.6 but in general, nothing changed in Joomla! 1.7. Are you experienced enough to change small snippets of code with instruction :-)? If you feel comfortable and answered all the questions with yes ... let's go!
Step 1: Back-up
Before you do anything else, please do a backup of your site. You are probably already using Akeeba Backup [5]. The extension is available for version Joomla! 1.5 and 1.6. If not, install it and do a back-up of your site!
70
dump your MySQL database, create a local database and import the dump into the local one change conguration.php You can also implement the process with Akeeba backup, which allows you to create a zip package of your site. To again create a website from this package, you will need the Akeeba Kickstarter.71 Place the kickstart les and the zip package of your website in the local folder of your website (htdocs). Create an empty database for your Joomla! 1.5 Launch kickstart.php. Presumably, the URL will look like http://localhost/kickstart.php. Then follow the instructions.
71 72 73
Joomla! 1.7 - Beginners Guide The component creates a folder with the name jupgrade and installs the Joomla! 1.7 variant of your 1.5 website in this new folder (http://localhost/jupgrade). The Joomla! 1.7 core template is activated..
If you use Joomla! in a language other than English, you rst have to install the correct language les 74. Customize your template and activate it. This wonderful graphic give you a precise idea of the future (Figure 2).
74
75
http://sanderpotjer.nl/
Sunday, 24 July 2011
Page 238
Page 239
Chapter 24
WHY ME?
Do you ever: have customers that don't pay your invoice? work twice as much as you're getting paid for? have a big misunderstanding about the deliverables with your customer? encounter disrespectful behavior of clients? frown upon the choices customers make in your eld of expertise? get no or low appreciation for what you've delivered? need to battle scope creep? take much longer to deliver, but the customer did not care?
discuss with your partner wife or husband about whether it's a good idea to continue your rm
Page 240
Joomla! 1.7 - Beginners Guide think of going back to a normal and easy job? You are not alone. If all the answers are 'no' you are natural talent in earning respect & money with open source CMS expertise. Or you've worked through this chapter before?
DENIAL
After years of long days and hard work, you only nd your soul mates at open source congresses and meetings. Where we share our experiences. Or via the IRC channel, where we like to complain about our customers: they're stupid, they don't want to pay, they think they know it all, they expect you to go to work without them putting pen to paper, and so on. What's happening here is that we are in denial. The customer is not the problem. We ourselves have to change our attitude.
Fair enough, but did you start up your own organization to be in charity work? Charity workers get respect and "sell" their free help. If you have decided to start your own rm, not selling is not an option. You have to get off the wrong bus quickly.
"I'm not what you call a salesperson - I'm too soft. To be honest: I hate selling."
You need a change in how you perceive the world. Selling is a profession that should be indicated as "assisting with purchasing". Put aside your prejudice! Start assisting your customer in purchasing the right things (instead of selling), and teach them how to give you the respect and treatment you deserve, plus payment.
On the contrary: Open source integration has at least ve major innovational effects 76 that closed source can't beat. Proven and indisputable. For that reason long term or short term replacement propositions of closed source by open source ''are'' big money. Just because closed source is about big money. Closed source will eventually adapt itself to open source innovation. But that will take time. In the meanwhile, your expertise is worth respect & money. If your have
76
Joomla! 1.7 - Beginners Guide not been convinced yet, click the link above about the said innovative effects of open technology because you need to ooze pride.
Still in denial?
Sorry for bothering you! Please continue your good work and put your mind at rest with the other chapters you'll nd in this book. One last request: could you please efface yourself quietly, poor and lonely? :-) The other chapters are very much worth reading. Don't get me wrong. Don't however lull yourself to sleep by obtaining more technical knowledge only as a distraction from a totally different ballgame: earning respect & money. Because that's got nothing to do with Joomla, Drupal, TYPO3 or any other world class open source CMS, nor your great expertise. Awake? Good, we need a clear mind to learn & practice how to earn respect & money with our expertise & means.
Joomla! 1.7 - Beginners Guide A resource is pending input from a customer or third party. If you don't get the resource, you can't do or nish your job. E.g. digital photos from a photographer, a list of menu-item names in a different language, a signature on the contract of your assignment (oops, you never ask for that?), etc.
Resourceplanning
Ensuring that the input of customers and third parties is ready for use in a project or support.
Scope
The extent of a solution. The size and magnitude of an effort, expertise, machinery, functionality that is wanted/planned to offer that solution. <google scope - wikipedia>
Functionality-blocks
A logical group of functionality under a common title. Expressed in normal ''homo sapiens'' language. E.g. a forum, design, interface, advanced search. (A homo digitalis would invent titles like Jom-social, psd plus html/css and template based on wire frame, database lookup of indexed content.)
Release plan
The release plan species which Functionality-blocks are going to be implemented for each system release and dates for those releases. The release plan species who (in which role) fullls the particular tasks.
Sprint
All efforts within a certain phase in a project (as agreed in a release plan). The word "sprint" suggests running to a deadline, no time to lose. We have to catch an airplane in time. Because the airplane will leave and we better be on it. And therefore we might not pack our bag that well, some items might be missing, we might go in ts and starts, but we get there in time! By doing so, we are much better off than having all stuff beautifully packed: everything we might need is packed in the suitcase, but we are left behind on the airport.
SprintX
The virtual sprint after the last planned sprint within the release plan. It is a container for extra work (scope creep or agreed out of scope) or waiting area for functionality-blocks that couldn't be implemented in the sprints so far.
Contract management
The management of contracts made with customers, vendors, partners, or employees. Contract management includes negotiating the terms and conditions in contracts and ensuring compliance with the terms and conditions, as well as documenting and agreeing on any changes that may arise during its implementation.The purpose: maximizing nancial and operational performance and minimizing risk.
Project management
! Sunday, 24 July 2011
Page 243
Joomla! 1.7 - Beginners Guide The discipline of planning, organizing, securing and managing resources to bring about the successful completion of specic project goals and objectives. Put it differently: running from A to B without looking up and getting there in time; no matter what.
Findings
How people perceive the world and in an open source web system / Joomla implementation in particular: how people see results in the context of what is agreed. We need to elaborate on Findings a bit more because synchronization of Findings is the key to a valuable contract management.
FINDINGS
Findings are complex. We might have conicting interests, personal issues versus the roles we play. Different levels of expertise and experience. How well were negotiations perceived. What about respect? Did parties involved that wrote their Findings receive enough respect from others and give enough respect to others during the process? All these factors inuence the way we perceive things. Example: An emotional quarrel with your neighbor hardly ever has to do with the subject or object at hand. Most likely it's something else that formed their opinion, expressed in a sort of "Findings".
Let's also have a quick look at some important psychological effects while doing business. In case of an open source web system implementation, we stumble upon a few interesting effects that have a major impact.
Cover and future proof advice. That is it, folks. He/she is not interested in open source, Joomla, you, your product, your measures, your vision, etc. So stop telling them dumb stories and start asking smart questions to secure them in what they really want.
Everything that is already done, is worth less every following day and everything that needs to be done is very important and urgent. Does it ring a bell? A customer is always right. If not, we just have a different opinion on the subject That is a good example of what synchronization of Findings is all about.
Projects tend to go over the deadline. Why? Are you such a crappy planner, do you like to disappoint people? Of course not. Do you end up with a buggy result to has to be debugged, do you accept new requirements and changed resources while you are developing? Yes, you do. Do you have a problem stopping development efforts and starting a thorough test? Do you deliver Sunday, 24 July 2011 Page 244
Joomla! 1.7 - Beginners Guide half-baked systems just to "keep the customer happy"? You most probably do. And you should stop this behavior from this moment on. "Deadline rst" means: no matter what, we deliver on time. Read that sentence again: we deliver on time. 40 years of ICT has done us no good in some perspectives. It's perfectly accepted that we don't deliver on time. Even worse: it's accepted that more than 50% of the larger ICT projects world wide are a sheer failure. And we accept that they tend to be twice as expensive in the end than quoted upfront. Suppose your grocery store would say "no milk today" after you ordered it by phone yesterday. Suppose your bakery would raise their prices from one day to the other by 100% or 200%. What would you say if the constructor of your house that just collapsed sends you the last invoice for "work done to your house"? Customers in ICT just walk off and mumble their disdain. They go and start another ICT project. And we suppliers? We get away with nonperformance! We don't deliver on time, we don't stick to promises and we deliver systems that will not be used (long enough). Sometimes a customer sues us. But what the hack: you can't get blood from a stone. In many cases, angry customers don't pay the last installment or the main installment (depends on how stupid we were). But that's about it. Easy walk in the park. We continue to next project and act more or less the same STOP IT! Deliver on time, no matter what, no excuses, but deliver!
I will now go into detail about how it's done and the positive effects of this behavior for all parties involved, including your customers. How do you deliver on time? Most importantly by exing the scope. The Basecamp-company 37signals 77 writes in their visionary guidebook Getting Real78 : open source (and also Joomla) web systems are very well equipped to stick to this rule. (Read the full book for other good rules) 1. Open source has good prototyping & Proof of Concept capabilities, scope gets clearer ''after'' prototyping and thus scope changes.
77 78
Joomla! 1.7 - Beginners Guide 2. An Open source web system has extensive and useful hidden functionality on board, loads of change available (see also Negotiate continuously) 3. Scope should be exible because customers change their mind on what they want, after experiencing rst results and possibilities. Customers learn on the job. And change their mind accordingly. Scope creep is the negative effect, ''ex scope'' the positive solution.
Agree upfront that you put deadline rst and ex the scope to meet the deadline. Explain honestly what "ex scope" means. Lets call the customers "they". Be very open: what they want now, they don't get in the end. Why not? Why not? Advancing insight will eventually lead to different systems! However they do get what they want in every iteration towards the end result. Be sure to be in charge of exing the scope (no discussion, you have to meet the deadline, so you're the one that makes decisions after touching base. Plan a time buffer in your work towards a deadline. Use the buffer to ex the scope and make an new version of your release plan. Do that by diminishing the number of functionality-blocks in the current sprint, slim down functionality-blocks.
1. A: Always say and write: We "can't" instead of "we don't want to" or "we won't". Example: I am sorry sir, I am afraid I can't continue staging your site to production. The partial payment has not arrived in our bank account. It's company policy to proceed only if due payments have arrived in our bank account.
79
Joomla! 1.7 - Beginners Guide 2. B: Say you can't start this server virus-x analysis before the money has arrived in the bank account, but let the customer ''feel'' that your back ofce has already taken measures and is full on the job of analyzing & xing the bug. 3. C: A support contract is hardly ever a result insurance. Support on webCMS's, especially those based on open source can only be a guided effort insurance. That means: at the most we promise reaction, response and resolve times and capacity available in the required expertise. Don't introduce this result responsibility of customers site on your business' shoulder. They can't bear it. The load of several million lines of code someone else's code. Code running on a contentiously changing stack that's attacked by scoundrels every day (hackers). Remember: Before the customer rst rang your door bell, their site was never your problem. Keep that in mind and remind your customer. Some of these customers think they can buy your commitment, devotion, hiring you as a templater for a few hours. And some of you act like sinners right away when a customer is in great distress and quick to point the nger at you because of a non-operating web system. Again: behave like a professional and they will respect you as a professional. Behave like a low grade assistant, they will treat you as a doormat. A webCMS is the customers problem and we can assist by improving it and helping out when problems occur. It is not your problem. Comprendo? Tiny difference, huge effect. Only watch the tone of voice. Having said (and repeated) that, you work your ass off to help this customers web shop to go live again before the rush of Christmas shopping. D: We do deliver exactly what was agreed (no rebate for nothing), but we ''put in the extra mile'' too.
It's obvious that you have to sell a project and negotiate conditions (among them ''price''). What is new to many people is that in a web system development project or the support afterwards, you have to sell and negotiate continuously. A few examples: Is it done? Can I send my invoice now? ("No, there is still a few issues left to improve") Support request: change a logo on the site. How much time do you need? ("Ooh, come on you can't be serious!") You think it is extra work, your customer doesn't seem to think so. ("It might not be in the RFP, but I remember very well us discussing this functionality") Remember that sales is game. The customer should have the overall feeling that he/she won that game. Give them that feeling and be well-off with the deal at the same time! ! Sunday, 24 July 2011 Page 247
Joomla! 1.7 - Beginners Guide To be able to play a game of marbles, you'll need marbles. How do you get marbles? By signing the contract? No. By sending invoices? No no. By holding back results. Sometimes The main source of credits for your sales game are happiness and money. Don't mix them. Build up credits in the emotional bank account of your relations (See Steven R. Covey 80). Solve frustration you might have; you need to be happy in the work relation too! If partial payments have arrived on time, you have credits for new games. Refrain from having too many service hours unpaid. It makes you vulnerable and clears the way for customers to put you under pressure and/or reopen negotiations. The more they owe you, the more they might throw in these bullshit arguments to not proceed and pay you. Inappropriate pressure is coming down on you. But you caused it yourself in the rst place. (See: be rm but sympathetic)
80
Joomla! 1.7 - Beginners Guide feel acquainted and safe with the LAMP stack and cronjob-mechanism and you x it (woow!) that the international open source community and especially a web CMS Joomla is a sort of homecoming for you; you know a lot of people, anywhere in the world. 'What a man, what a man, what a talented man. No idea where we're heading? Hold on and ''no worries'', these are just harmless examples to get you to understand the risks of being foolishly responsive. Lets pull the trigger of the shotgun pointed at you. Remember that it was you that loaded the ammunition: Now wait a minute, you advised Joomla and now we have to program tailor-made code that might solve the issue that Drupal does out of the box?!' Every night we expected to have a safe copy of our website, because you said PHP was capable of doing it. We paid you to congure the cronjob. And now we ended up with a useless restore" You promised multilingual support and now we have to pay for it?' Where did the respect go that you counted on? Why does this customer behave like this? It's obvious that the customer is angry and I guess you have to work for free to make her or him happy again! So what's your best bet, pal? What went wrong? A few elementary things in conducting professional business. And please don't lull yourself to sleep with oh, no but I'm just a small rm, a creative entrepreneur, and my customers are small. I do not need this. A few elementary and universal things in conducting professional business went wrong: You didn't separate your different talents in distinctive roles. Symbolize them by different colored caps. So from now on: dene roles. You didn't put on the right caps while answering the questions. That made you vulnerable: the customer can take your answer from any point of view. Play your role!
Joomla! 1.7 - Beginners Guide I am sorry, ms. customer, as your developer I could never answer your "should we use Joomla" question. The reason is your organization has to choose a webCMS and I can make the best of it. Of course I can connect you with mr. colleague_of_mine, he is consultant at our company and specialized in selection-processes. His fee is very reasonable compared to the coverage of corporate risks he covers with his advice. PHP for the backup cycle. As a contract manager I would have to say 'no' to you, because a backup procedure is out of scope. As a project manager I'm afraid I have to give you the same answer for a different reason: we are busy in this sprint reaching the deadline, we haven't planned it and I don't have the backup routine in the release plan as a listed functionality that I have to fulll. As a developer I would say: yes, doable. But the alarm bells go off in my ofce as a hoster: rst the characteristics of the restore should be clear before we could invent a suitable back-up strategy. You see, there are many ways of looking at this simple question. Multilingual support in time? You have to be more specic to avoid disappointment in the near future. I could say Yes to you, because it's easy to install a translation module. That's my development cap. But somebody has got to do the translations as well. And that could be me in a different role, different cap: translator/congurator. If you expect 'Multilingual support' to be localized content, I would have to perform a task that I am not able to: I am not a native speaker of the foreign language that you focus at and I'm not a citizen that lives locally in that region. Whether or not I can perform the tasks in time that I am capable of doing, depends on the planning. I have to take a look at that next Thursday when I have my project management-day. This all might seem a silly play, but it is dead serious business.
Tactics
Example: interaction design
Your tomorrow's user interaction design session with the customer will be easier if someone else (but on behalf of you) mentioned the cascade of your legal steps against him, as long as invoices remain unpaid. You could tap the customer's arm and say "please do not be to angry on him, he just doing his job. We can not blame him, can we?" The customer will respect him for his and yours professionalism. Image how hard it is to play these roles all by yourself. To avoid backre on your personal relationship with your customer you could '''introduce your real colleagues''' (individuals). Real colleagues (even if they do not know that they are your colleague) are very good to have around, you can: a. blame them
Page 250
Joomla! 1.7 - Beginners Guide b. praise them for their excellent work in his/hers role To postpone and divert: answer the question in one or two roles right away, but then park as an agenda-item for a different role on the critical path. Example given: "Yes, technically no problem, but I have to take a look at that next Thursday when I have my project managementday." Invent a diversion yourself. It's nothing to be ashamed of. In business it is done every day. Ask yourself the question "Does it sound as an excuse?" It shouldn't. It should be a ''role well played''.
Revisited
The 4 interdependent rules of earning respect and money in your work as an open source expert revisited: Deadline rst, ex scope Be rm but sympathetic Sell en negotiate continuously Dene roles and play them See?!: Earning respect and money with Joomla! has nothing to do with Joomla!. (Thanks to Froukje Frijlink who checked my English).
Page 251
Page 252
Chapter 25
Resources
This book was a beginning. I hope you enjoyed reading it. My intention was to guide you through Joomla! 1.6. Not everything was covered because that would have been too much. I think we could use a developer book and a template designer book to dip deeper into these topics. Nobody knows what the future holds in store! What kind of useful resources are there for you to learn more about Joomla! or to get in touch with the Joomla! community?
COMMUNITY
As it is written on the back of this book, Joomla! is backed by a worldwide community. If you like this idea, come and join us! Become a member of http://community.joomla.org/. Read the community magazine at http://magazine.joomla.org/. Maybe there is a Joomla! user group near you that you can join. http://community.joomla.org/user-groups.html If not, start one yourself ! Twitter: http://twitter.com/joomla Facebook Group: http://www.facebook.com/joomla
DOCUMENTATION
http://docs.joomla.org/
SECURITY CHECKLIST
http://docs.joomla.org/Security_Checklist_1_-_Getting_Started
The Joomla! extension directory provides more than 6,000 extensions - http:// extensions.joomla.org/ There is no central directory for free templates. There is no central directory for commercial templates. Anyway, there are a lot of template clubs and professionals that provide Joomla! templates. Just search the web and you will most certainly nd something that suits you.
Page 253
EVENTS
Joomla! is known for its Joomla! days. A Joomla! day is a one- or two-day event organized by and for the community. A list of Joomla! days can be found here http://community.joomla.org/events.htm There is an international Joomla! conference in Europe called jandbeyond. Go to http:// jandbeyond.org/ for more information.
THE FUTURE
The community plans a six month release cycle, based on the ideas people post in the Joomla! idea pool. The next releases will be Joomla 1.7 in July 2011 and Joomla! 1.8 in January 2012, but of course, it depends on how the community will support implementing these ideas! The Joomla! developer network is always looking for people like you :-) http:// developer.joomla.org/
TRAINING
http://resources.joomla.org/directory/support-services/training.html
COMMERCIAL SUPPORT
http://resources.joomla.org/
HOSTING
http://resources.joomla.org/directory/support-services/hosting.html
CERTIFICATES
At the moment there is no possibility to get certied in Joomla!. You see, there is enough work left for you, your friends and the rest of the world :-).
Page 254
cocoate.com
is the publisher of this book and an independent management consultancy, based in France and working internationally. Specialised in three areas Consulting, Coaching and Teaching cocoate.com develops web based strategies for process and project management and public relations; provides customized trainings for open source content management systems Drupal, Joomla! and WordPress, in the area of management and leadership skills and develops educational projects with the focus on non-formal learning. The European educational projects focus on the promotion of lifelong learning with the goal of social integration. Particular emphasis is placed on learning methods in order to learn how to learn, the conception and realization of cross-generational learning strategies and local community development. http://cocoate.com
Page 255
Page 256