- Details
- Written by: Cliff
- Category: Uncategorised
- Hits: 56
In the Header of the joomla.org sites are two buttons: Download and Launch. The Launch button links to a page that invites you to Build fully functional Joomla! websites and experience the world’s best Content Management System for FREE. This article shows what to expect if you accept this invitation.
Launch Forms
Step 1: Choose a subdomain name
Choose something that is likely to be unique to replace Enter website name:
Step 2: Select Joomla! Version
Step 3: Create an Account
After submission of this form you will receive an email with an account verification code for use in the next step.
Step 4: Verify Account
There may be additional steps in this sequence. Eventually, you will receive a series of emails from CloudAccess.net with instructions on what to do next. Login with your email and the password you entered in Step 3.
Cloud Acess.net Control Panel
Your Products
All being well, after dismissing any offer boxes, you will see a Cloud Control Panel (CCP) screen showing your registered products. If you have any problems, open a New Ticket and the support team will fix whatever needs fixing.
You will see a link to your free Joomla! site so you could try it out now. Click the link and your site will open in a new browser tab. Append /administrator/ to the URL to bring up the Administrator login form. Note that the Username and Password for Joomla! login differ from those for the CCP Login. You will find the credentials in one of the welcome emails. You can login directly from the Login button in the product Actions column. This article does not cover using Joomla! So back to some of the CPP tools needed to manage a Joomla! site.
Notice the Renew button. It is a condition of the Free account that it is renewed within 28 days. When you select the Renew button you are prompted to Upgrade for 6$/month. Select Renew again to bypass the Upgrade prompt. A Success notice will appear.
Site Management
Select the Manage button in the product Actions column to reveal a list of features needed for site management. Each is a drop down list that needs to be explored (and remembered).
Some of the management tools are not available in the Free version. Tools that you are likely to need for trouble-shooting Joomla! include:
- Application / Database for access to phpMyAdmin
- Application / Manage Backups to Create and Remove backups.
- Server / File Explorer for access to the Joomla! code files in httpdocs for elementary editing.
Conclusion
The free Joomla! site provided by CloudAccess.net is similar to Shared Hosting where a large number of sites share the resources of a single computer: disks, memory and bandwidth. The only snag is that performance may vary depending on the demands of all of the sites sharing the hosting service.
It took a few days over New Year (2023-2024) to create a free account and compose this article. A good start with Joomla!?
- Details
- Written by: Cliff
- Category: Uncategorised
- Hits: 100
This is a discussion document
The new Welcome to Joomla! tour scheduled to appear in Joomla 5 is the first thing that a new site will display on Administrator login. It gives us the chance to point out the main areas of the Home Dashboard: the Menu, the Title bar and the Dashboard Panels. The wording is important because it sets a tone for Joomla newcomers. Herein lies the problem!
The wording provided with the Tour is intended to be informal, engaging, friendly, welcoming and comforting. The problem is that some are of the opinion that the English is poor, the tone is unprofessional and the content is technically deficient. There are only six small text panels in the tour so the table below shows the original friendly version alongside an alternative more professional version. Which would you prefer? You can comment on Mattermost, or the Joomla Issue Tracker.
Original | Alternative |
Welcome to Joomla!Congratulations, the most important step is done: you have installed Joomla! Now comes the fun part. This is called “The Backend” of your Joomla installation, otherwise known as the “Administrator” area. Now you can start your journey to become a Joomla Administrator! |
Welcome to Joomla!This is the first of a set of Guided Tours designed to introduce newcomers to the main features of the Joomla Administrator pages, sometimes referred to collectively as the backend to distinguish it from the frontend public Site pages. The Administrator pages are used to configure and manage your whole Joomla website. The current page is the Home Dashboard, the starting point for access to the Administrator menu, to the left, and the Quick access panels, to the right. Please select Start to continue this brief tour or the X symbol above to close the tour. You can take the tour again at any time. |
The menuThe menu is the heart of the backend. Ever get lost? Use the “Home Dashboard” link to come to this page. The help section at the bottom is nearby, giving you access to useful information and a community of volunteers. The menu also gives access to the most essential areas of Joomla!, like your articles and menus. If you’re missing something in the menu, try the “System” link, to access additional areas of the backend. |
The menuThe menu provides access to the Administrator management pages. Each section has a collection of pages for managing that particular aspect of Joomla, such as Content, Menus and Users. The window pane icons link to individual dashboards for those menu groups. The System menu itself leads to a dashboard. The Help menu item leads to another dashboard containing links to many sources of Joomla help and information. |
The quick access sectionsOn the dashboard you can also quick access the most key areas by selecting their icons. Many extensions also have their own dashboards for additional information. Just select the dashboard icon ( ) at each of the different extension menu items. Adjust your dashboard sections by selecting the specific cogs’ icon ( ). |
The dashboard panelsDashboards provide quick access to frequently used pages via their icons. Each dashboard panel is an Administrator module that can be added to or removed from a dashboard and each panel may have items added or removed via its Settings icon (). This allows you to configure your site dashboards to suit your own purposes. |
The notificationsNeed a quick overview of the status of your installation? Check out the “Notifications” section. It shows if updates for Joomla! are available as well as your other extensions. Any outstanding tasks are also shown here. |
The Notifications panelThe Notifications panel shows whether updates are available for Joomla! and other extensions that provide update sites. Any outstanding Privacy Requests are shown here too. |
The top barWant to learn more about Joomla!? All available tours are at the top. Also, you can see your current Joomla version, and you can manage your user account. Feel free to look around, and don’t forget: if you get lost, either check out the available tours or come back to the dashboard. |
The Title barThe title bar shows the title of the displayed page. The other items in the title bar are modules that you can configure to display or not as you see fit. Your current Joomla version and the list of tours are often the next items in the title bar. The last items in the title bar are usually a link to the Site frontend and the User Menu where you can change your password, personal settings and logout. |
Final wordsWe have many resources available where you can learn more, get support and become more involved in Joomla Itself. If you need help from the forums, documentation and community you can use out help pages. |
Help and InformationMany resources are available where you can find help, learn more and become more involved in Joomla Itself if you wish. See the list available via the Help menu. |
And in pictures:
Original | Altenative |
- Details
- Written by: Cliff
- Category: Uncategorised
- Hits: 301
Joomla documentation is plentiful and easy for anyone to contribute to. Over the years the Joomla Documentation Wiki has grown considerably, which in itself is good, but also brings challenges. It lacks structure, it's hard to search, it contains a lot of outdated articles, and translating the documentation is not as straightforward as it should be. So it's time to reconsider our documentation tools. What if we could have a Joomla based solution for our documentation?
Jdocmanual is a custom component designed as a Proof of Concept for ease of use, ease of contribution, ease of translation and ease of management. It brings together Joomla articles in Manual format as seen in many other software documentation projects: Index of Articles to the left, Article text in the centre and Article Contents to the right. That presentation is the easy part! This article mostly covers how the other easy requirements are met in Jdocmanual. It is intended to contribute to a discussion on the future of Joomla documentation.
You can try the public view yourself: https://jdocmanual.org. This is what it looks like in the Administrator view:
The Site view is similar but without the left menu. A user may choose any of the available manuals and display the Index and/or Content in any of the available languages.
Source Data
The articles for Jdocmanual have been selected from docs.joomla.org, which is the MediaWiki installation used for Joomla documentation. Only articles relevant for Joomla 4 have been included and each has been converted to GitHub Flavoured Markdown. The articles have been organised into separate Manuals for different user groups: User, Developer, Documenter and Help. Others can be added, for example Tutorials selected from the Joomla Community Magazine may come later.
Updating data
Jdocmanual can have multiple contributors in two User Groups: a JDM Author may create a personal copy of an article for editing purposes; a JDM Publisher may commit changes created by a JDM Author (JDM is used here to indicate separate user groups from Joomla default Author and Publisher). A Publisher also has Author permissions. The list of articles available is always based on the source English list. This is a screenshot of the article list with a language other than English selected:
The ticks in the Translated column indicate that this particular article has been translated into the selected language. Those without a tick have yet to be translated. If English is selected this column is not displayed. In the Status column, Stashes: 1 indicates that a user has created a personal stash of that article to work on. The yellow New Stash buttons indicate that I can make my own personal stash of that article to work on. The green Edit Stash button indicates that I have already created a personal stash of that article.
New Pages must be created in English so a New button only appears in the Toolbar when English is selected. Also, new pages cannot appear in the Pages list because they only exist as stashes until committed. So the New Pages tab shows a list of any new pages in preparation.
My Stashes is a tab used to display a list of any stashes I have created to work on.
Pull Requests is a tab seen only by users in the JDM Publisher group. The list includes all pull requests by all users. The links in this list opens the same Stash Edit form used by Authors but it has an extra Toolbar button labelled Commit.
Editing Content
The following screenshots show selected tabs from the stash edit form. The fields in the Details tab are mostly prefilled from data on the page being edited. The Display Title is the only field that can be changed, except for a completely new English article where more fields must be filled before saving.
The Stash tab is where editing of content occurs. If the page is a translation the English version is displayed in a read-only text area to the left. If the page is an English version the edit area fills the whole page. Editing requires familiarity with Markdown syntax.
If you need to know what has changed in the original English version since the last update you can look at the English Diff tab:
The Source tab shows the current source of the Stash you are working on. The Diff tab shows the difference between your Stash and the Source. Before making any changes this will be empty because there are no differences to show.
The Preview tab shows a HTML rendering of your Stash. The Comments tab is for entry of a Commit message and feedback on any Pull Request.
Pull Requests
When a Stash is ready to replace the original content a click on the Pull Request button makes it visible to all the JDM Publishers. Anyone in that group can inspect the Stash using exactly the same form. If it is acceptable, a click on the Commit button, which appears in the Toolbar when a Pull Request is made, is enough to stage and merge the changes into the original article. The result is visible immediately.
Ease of Use
Is it easy to maintain? The answer is probably Yes and No. If I am editing the data myself with a few trusted friends then I guess the answer is yes. If there are dozens or hundreds of contributors in the Author Group, processing all the pull requests could become a challenge for a small team.
Help Proxy
The Joomla Help Pages are delivered by a proxy server. The url is in your Joomla installtion configuration.php file:
public $helpurl = 'https://help.joomla.org/proxy?keyref=Help{major}{minor}:{keyref}&lang={langcode}';
Where {major} and {minor} are replaced by your Joomla installation values, the {keyref} value is set in the Administrator page invoking a Help page and {langcode} is the two-letter code for whatever language your Administrator template is using, for example en or de.
In practice, we do not maintain different Help pages for different minor versions of Joomla. And updating Help pages when migrating from one major version of Joomla to the next is a significant problem. About 200 original English pages have to be copied and re-translated even though any changes may be minor.
All of this is much easier to do with Jdocmanual. If you are testing Joomla 5 you can change the domain in your configuration.php file to https://jdocmanual.org/
and expect to see the Joomla 4 and Joomla 5 Help pages in English or your own language.
Menus
In Jdocmanual the order in which items appear in the article index to the left of the article content is independent of the order in which the items appear in the list of source files. That is achieved with a menu list - a text file containing the list of articles in the desired order. This is very easy to edit by cut and paste to move an item. This is much easier than the drag and drop method used for Joomla menus. The menu order is language independent so there is only one menu for each manual. Users can make their own stash copy of the menu, change it and then make a pull request to have it replace the existing menu. The menu stash edit form has tabs similar to the article stash edit form:
Utilities
The other items in the Jdocmanual Administrator menu are used to manage languages, to translate menu headings and to manage manuals.
Future Development
Development of Jdocmanual has focussed on functionality. Little effort has gone into appearance other than that offered by the default Cassiopeia and Atum templates. Suggestions and alternative style sheets would be welcome!
Coding
Jdocmanual was developed as a proof of concept. Under the hood some of the code needs to be improved: libraries for handling markdown to html conversion have been included within the component itself rather than within the Joomla libraries folder; there are probably better ways of implementing git commands, for example by using the Joomla GitHub library; and more. Comments and suggestions are welcome.
Content Revision
In processing and checking MediaWiki articles I came to the conclusion that there are too many unnecessary internal links. With a good index, as in Jdocmanual, many links can be left out without affecting the value of the article. This leads to a better user experience.So far precious little attention has been given to the actual content of the articles appearing in Jdocmanual.
I think the next important task is to update content, merge similar items and incorporate new content from other sources, such as the Community Magazine.
Conclusion
If you want to try it yourself you can get the code and data here:
Code: https://github.com/ceford/j4xdemos-com-jdocmanual-v2.git
Data: https://github.com/ceford/j4xdemos-data-jdocmanual.git
Pay heed to the README.md files. Setup requires more than simple installation of the component!
If you would like to participate in further development of the Jdocmanual code please feel free to make a pull request.
Introduction
Much of the Joomla Documentation is handled by a MediaWiki installation. It does a good job of delivering the Help pages invoked with a Toolbar button on almost all Administrator pages. However, it has shortcomings that have led many in the community to look for an alternative. Some of the problems are mentioned at the end of this article.
- Details
- Written by: Cliff
- Category: Uncategorised
- Hits: 909
- Details
- Written by: Cliff
- Category: Uncategorised
- Hits: 1474
Some content with bold and an image: