Difference between revisions of "Joomla/C2/Common-mistakes-and-uninstalling-Joomla/English-timed"

From Script | Spoken-Tutorial
Jump to: navigation, search
Line 4: Line 4:
  
 
|-
 
|-
|| 00:01
+
||00:01
|| Welcome to the Spoken Tutorial on '''Basic Formatting of Articles in Joomla.'''
+
|| Welcome to the Spoken Tutorial on '''Common Mistakes while Installing Joomla and Uninstalling Joomla''' on a local server.
  
 
|-
 
|-
|| 00:07
+
|| 00:11
|| In this tutorial, we will learn about: '''Article''' editor in '''Joomla''', Basic formatting for an '''article''', And styling an '''article''' text
+
|| In this tutorial, we will learn about: Common mistakes when installing '''Joomla''', Solutions to those mistakes and How to uninstall '''Joomla'''
  
 
|-
 
|-
|| 00:19
+
||00:23
|| We will also learn how to: Insert '''lists''', Insert a '''page break''' and, Insert '''Read More links''' in '''articles'''.
+
|| For this tutorial, we will be using: '''Ubuntu''' Linux 14.04, '''Joomla''' 3.4.1, '''Apache''', '''MySQL''' and '''PHP''' obtained through '''XAMPP''' 5.5.19
  
 
|-
 
|-
|| 00:28
+
|| 00:41
|| For this tutorial, we will be using: '''Ubuntu Linux OS''' 14.04, '''Joomla''' 3.4.1, '''Apache''', '''MySQL''' and '''PHP''' obtained through '''XAMPP''' 5.5.19
+
|| To follow this tutorial, you need to have: '''XAMPP''' and '''Joomla ''' installed on your system.  
  
 
|-
 
|-
|| 00:46
+
|| 00:49
|| To follow this tutorial: You should know how to create '''articles''' in '''Joomla'''
+
|| You also need to have knowledge of the '''Joomla''' installation process.
  
 
|-
 
|-
|| 00:51
+
|| 00:54
||If not, check the relevant '''Joomla''' tutorials on the website.
+
|| If not, check the relevant tutorial in the '''Joomla''' series, on the '''spoken tutorial ''' website.
  
 
|-
 
|-
|| 00:56
+
|| 01:02
|| Earlier, we learnt to create, edit, delete and copy an '''article''' in '''Joomla'''.
+
|| First of all, let me start '''XAMPP''' on my machine.
  
 
|-
 
|-
|| 01:03
+
|| 01:06
||Now, let’s learn how to format '''articles.'''
+
|| Let's open the '''terminal''' by pressing''' Ctrl + Alt + T ''' keys.
  
 
|-
 
|-
|| 01:07
+
|| 01:12
||Let’s switch to the '''Joomla control panel.'''
+
||Alternately, click on the '''Terminal'''” icon in the launcher bar. |-
  
 
|-
 
|-
|| 01:11
+
|| 01:17
||Click on '''Article Manager. '''
+
||Start ''' XAMPP ''' by typing '''sudo space slash opt slash lampp slash lampp space start ''' and press''' Enter.'''
  
 
|-
 
|-
|| 01:14
+
|| 01:28
||Here are the '''articles''' we created earlier: '''“Benefits of Sodium”''' and '''“Vitamin A”'''
+
|| It will prompt for '''administrative''' password.
  
 
|-
 
|-
|| 01:21
+
|| 01:31
|| Let us view them on the '''Digital India''' webpage.
+
|| Let me type my '''administrative password''' and press '''Enter'''.
  
 
|-
 
|-
|| 01:25
+
||01:36
||Click on '''Digital India''' at the top right of the page.
+
|| Now we have''' XAMPP''' running.  
  
 
|-
 
|-
|| 01:29
+
|| 01:39
|| We can see both our '''articles''' here.
+
|| The first mistake one can make is to extract '''Joomla''' in a different directory.
 
+
|-
+
|| 01:32
+
|| Click on '''Benefits of Sodium.'''
+
 
+
|-
+
|| 01:35
+
|| We can see the '''article''' is not formatted.
+
 
+
|-
+
|| 01:38
+
||Let’s go back to the '''Article Manager.'''
+
 
+
|-
+
|| 01:41
+
||Click on the '''article''' title '''“Benefits of Sodium”.'''
+
  
 
|-
 
|-
 
|| 01:45
 
|| 01:45
|| The editor in which we type the text of the '''article''', is called a '''WYSIWYG editor.'''
+
|| Go the the browser and open the ''' XAMPP ''' page by typing '''http colon double slash localhost '''and press''' Enter'''
 
+
|-
+
|| 01:53
+
|| '''WYSIWYG''' is the abbreviation of ''''What You See Is What You Get'.'''
+
  
 
|-
 
|-
|| 01:59
+
|| 01:55
|| It means the '''article''' looks the same in the web page as seen in the editing window.
+
|| In the menu on the left of the screen, click on '''phpinfo'''().  
  
 
|-
 
|-
|| 02:05
+
||02:00
|| Look at the menu bar of the editor now.
+
|| Now press '''Ctrl +F ''' keys and search for '''DOCUMENT underscore ROOT.'''
  
 
|-
 
|-
|| 02:08
+
|| 02:07
|| The first row has drop-down menus, which have various formatting options.
+
||It will be found in the table '''Apache Environment'''.
  
 
|-
 
|-
|| 02:13
+
|| 02:11
|| You can see the sub-options when you click on them.
+
|| Value of '''DOCUMENT underscore ROOT''' will be either '''slash opt slash lampp slash htdocs''' or
 +
''' slash var slash www'''
  
 
|-
 
|-
|| 02:17
+
|| 02:14
|| The second row has set of formatting options.
+
|| In my machine, it is '''slash opt slash lampp slash htdocs.'''
  
 
|-
 
|-
|| 02:20
+
|| 02:30
|| So here, we see a set of text enhancement options like  '''Bold, Italics, Underline''' and '''Strikethrough. '''
+
|| Please note that '''Joomla''' needs to be extracted in the '''apache DOCUMENT underscore ROOT''' directory.
  
 
|-
 
|-
|| 02:28
+
|| 02:37
|| Next, we see the options to align the text to the '''left, centre, right''' and '''justify'''.
+
||If this is not the case, the installation setting page would not show up at all.
  
 
|-
 
|-
|| 02:36
+
|| 02;43
|| These work as in any other text editor.
+
|| Second common mistake that one can make is to have the '''output buffering ON'''.
  
|-
 
|| 02:40
 
|| After the alignment options, we can see a button named  '''Paragraph.'''
 
  
 
|-
 
|-
|| 02:45
+
|| 02:49
|| When we click on it, we can see various options like '''Heading 1, Heading 2''', etc.
+
|| In the 3rd step of the installation setup, '''output buffering ''' should be marked as '''OFF.'''
  
 
|-
 
|-
|| 02:51
+
|| 02:55
|| These are pre-set options provided by '''Joomla''' for formatting purposes.
+
||This is a recommended setting and not a required setting.  
  
 
|-
 
|-
||02:56
+
|| 02:59
|| '''Headings''' are very useful in making text easier to read on the screen.
+
||Usually, by default, it is turned '''OFF'''.
  
 
|-
 
|-
|| 03:01
+
|| 03:03
|| '''Headings''' also define the hierarchy of details.
+
||If ''' output buffering '''is '''ON''', installation might proceed successfully.
  
 
|-
 
|-
|| 03:06
+
|| 03:08
|| '''Heading 1''' defines the most important heading and '''Heading 6''' is the least important.
+
||However, the website might be extremely slow later.  
  
 
|-
 
|-
|| 02:12
+
|| 03:12
|| Switch to '''Digital India''' webpage.
+
||In some cases, installation might hang up at this step.
  
 
|-
 
|-
|| 02:15
+
|| 03:17
|| Here, the text '''Home''' is in '''Heading 1.'''
+
|| In case it is '''ON''', we can turn it ''' OFF''' by editing ''' php.ini ''' in the '''apache installation.'''
  
 
|-
 
|-
|| 02:19
+
|| 03:24
|| The title of an '''article''' in '''Joomla''' is in '''Heading 2.'''
+
|| We will go to the '''terminal''' window and locate '''php.ini''' first by typing '''locate space php dot ini '''and press ''' Enter.'''
  
 
|-
 
|-
|| 02:23
+
|| 03:37
|| Other headings, like '''Main Menu''' and '''Login Form''' are in '''Heading 3'''.
+
||We may get a number of results for this query.  
  
 
|-
 
|-
|| 02:29
+
|| 03:40
|| Notice that the font size keeps decreasing with levels of '''headings.'''
+
||There will be one result in which '''php.ini''' will be inside the '''etc''' directory.
  
 
|-
 
|-
||02:34
+
|| 03:48
|| Switch to the '''Edit Article''' webpage.
+
||This directory is inside the '''lampp''' directory inside the '''opt''' directory.  
  
 
|-
 
|-
|| 02:37
+
|| 03:54
|| Let us add one section on food sources of '''Sodium.'''
+
||This is the one we need to edit.
  
 
|-
 
|-
|| 02:41
+
|| 03:57
|| At the end of the '''article''' text, click '''Enter''' to begin a new paragraph.
+
||In my machine, the path to that file is '''slash opt slash lampp slash etc slash php.ini'''
 
+
|-
+
|| 02:46
+
||  Type '''Food Sources:''' as the heading.  
+
 
+
|-
+
|| 02:50
+
|| We will type 3 food sources here – '''Salt, Processed Food''' and '''Canned Food'''.
+
 
+
|-
+
|| 04:00
+
|| Select the text '''Food Sources:''' and in the '''Paragraph''' drop-down, select '''Heading 4'''.
+
  
 
|-
 
|-
 
|| 04:07
 
|| 04:07
|| Click on '''Save''' button.
+
|| We open the file in '''Gedit text editor ''' by typing ''' sudo space gedit space slash opt slash lampp slash etc slash php dot ini'''
  
 
|-
 
|-
||04:09
+
||04:23
|| Switch to the '''Digital India''' webpage and refresh the page.
+
|| If prompted, enter your '''admin''' password.  
  
 
|-
 
|-
||04:13
+
|| 04:27
|| Notice that the text '''Food Sources''' appears in bold.
+
||You will have to do so whenever prompted, as we proceed.
  
 
|-
 
|-
|| 04:17
+
|| 04:32
||Go back to '''Edit Article''' webpage.
+
|| '''Gedit''' is the default text editor preloaded in''' Ubuntu Linux. '''
  
 
|-
 
|-
|| 04:20
+
|| 04:37
||Next to the heading '''Food Sources''', add the text - '''Let’s look at some food sources of sodium.'''
+
||Alternately, you can use any text editor of your choice.
  
 
|-
 
|-
|| 04:27
+
|| 04:42
||Here, we have added the text in the same paragraph.
+
|| When the file is open, search for '''output underscore buffering'''.
  
 
|-
 
|-
|| 04:30
+
|| 04:48
|| The newly added text becomes part of the heading and is formatted as '''Heading 4.'''
+
||The first search result we get is commented. So we check for the next result.  
  
 
|-
 
|-
|| 04:36
+
|| 04:54
||Please note that: The '''header formatting''' applies to the entire paragraph and not to particular words.
+
||Here we find the text we are looking for.
  
 
|-
 
|-
|| 04:43
+
|| 04:57
||To separate this line from the '''heading''', press '''Enter''' before the newly added text.
+
||Change ''' output underscore buffering = 4096''' to '''output underscore buffering = off'''
  
 
|-
 
|-
||04:49
+
|| 05:05
||Then select the text and from the '''Paragraph''' drop-down, select the option '''Paragraph'''.
+
||We save the file by pressing ''' Control + S ''' keys.
  
 
|-
 
|-
|| 04:56
+
|| 05:09
|| The text is no longer in '''Heading 4''' format.
+
||We can then exit the '''Gedit ''' editor.
  
 
|-
 
|-
|| 04:59
+
|| 05:12
|| Let me add a text line at the top of the page: '''“Chemical Symbol of Sodium is Na.”'''
+
|| We need to restart '''XAMPP''' for the change to get reflected.
  
|-
 
|| 05:07
 
||Select the text line and then from the '''Paragraph''' drop-down button, select '''Pre'''.
 
  
|-
 
||05:14
 
||The '''Pre''' option is for preformatted text.
 
  
 
|-
 
|-
|| 05:17
+
|| 05:16
|| Preformatted text is displayed in fixed wide font, and preserves both spaces and line breaks.
+
|| Switch to the '''terminal''' and type '''sudo space slash opt slash lampp slash lampp space restart'''
  
 
|-
 
|-
||05:24
+
|| 05:25
||Click on '''Save''' button.
+
||Press ''' Enter.'''
  
 
|-
 
|-
||05:26
+
|| 05:27
||Go to the '''Digital India''' webpage and refresh it.  
+
||So, we can proceed to the next step.
  
 
|-
 
|-
 
|| 05:30
 
|| 05:30
|| Notice that the newly added text appears in a grey box.  
+
|| The third mistake you can make is to have '''no write permission '''for the '''configuration file.'''
  
 
|-
 
|-
|| 05:34
+
||05:36
|| It also appears in a different font and style.
+
|| In the last step of installation, you might get an error that says “'''Your configuration file or directory is not writable or there was a problem creating the configuration file”.'''
  
 
|-
 
|-
||05:38
+
|| 05:48
||'''Pre''' style is usually used for text that needs to stand out in an '''article'''. This could be poetic stanza, computer code, quotes etc.
+
||This occurs when we forget to give ''' write permission''' to the ''' Joomla''' folder.
  
 
|-
 
|-
||05:48
+
|| 05:53
||Switch to the '''Edit Article''' webpage again.
+
|| If this error occurs, you will get some text inside a text box.
  
 
|-
 
|-
||05:51
+
|| 05:58
||Next, we have the '''bulleted list''' and '''numbered list''' options.
+
||We will copy this text using '''Control + C '''keys.
  
 
|-
 
|-
|| 05:56
+
|| 06:02
|| Let us see how to use them.
+
||In this case, we can create a new ''' configuration.php''' file and paste the text into it.
  
 
|-
 
|-
||05:58
+
|| 06:09
||Select the last 3 line items in the '''article''' text.
+
||We will use the '''touch''' command to create the '''configuration.php '''inside our '''joomla '''folder.
  
 
|-
 
|-
||06:03
+
|| 06:16
||Now click on '''bullet list''' icon and then click on '''Save''' button.
+
||At the '''command prompt''' type '''sudo space touch space slash opt slash lampp slash htdocs slash joomla slash configuration dot php'''
  
 
|-
 
|-
||06:08
+
|| 06:32
||Refresh the '''Website''' to see the bulleted list in the '''article Benefits of Sodium'''.
+
||Press '''Enter.'''
 +
 
  
|-
 
||06:14
 
||Come back to the '''Edit Article''' webpage.
 
  
|-
 
||06:17
 
||The third row has some advanced formatting options like: Decrease and increase '''indent''', '''Un-do''' and '''Redo''', '''Insert links, images, tables''', etc., '''Subscript, superscript ''' and '''special characters'''
 
  
 
|-
 
|-
 
|| 06:34
 
|| 06:34
|| You can try these on your own and see how they work.
+
|| Then type '''sudo space gedit space slash opt slash lampp slash htdocs slash joomla slash configuration dot php.'
  
 
|-
 
|-
||06:38
+
|| 06:46
||Let’s look at our '''article''' again.
+
||Press '''Enter.'''
  
 
|-
 
|-
||06:41
+
|| 06:49
||Here we have 2 sections: Text about introduction of '''sodium''' and its benefits and '''Food Sources.'''
+
||This will open the file in '''Gedit''' text editor.
  
 
|-
 
|-
||06:49
+
|| 06:52
||Let’s separate these two sections using a horizontal line.
+
||Paste the copied text inside this file.
  
 
|-
 
|-
||06:53
+
|| 06:56
||Keep the cursor before the text '''Food Sources'''.
+
||Check the file to make sure '''left bracket question mark php''' is present as the first line of the file
 +
and the content is exactly the same
  
 
|-
 
|-
||06:57
+
|| 07:08
||Now click on the '''Horizontal Line''' icon in the formatting tool bar.
+
||Save the '''configuration.php''' by pressing '''Control + S '''keys.
  
 
|-
 
|-
|| 07:01
+
|| 07:14
|| This will insert a horizontal line.
+
||We can then exit the '''Gedit ''' editor.
  
 
|-
 
|-
||07:04
+
|| 07:17
||'''Save''' and refresh the Digital India webpage.
+
||Now we have the '''configuration.php''' for our '''Joomla''' installation.
  
 
|-
 
|-
|| 07:08
+
|| 07:22
|| We can see the changes in the '''article “Benefits of Sodium”'''.
+
||Now, we will see the fourth mistake that one can make during the ''' Joomla''' installation.
  
 
|-
 
|-
||07:12
+
||07:27
||Instead of inserting a horizontal line, why not put these 2 sections in 2 different pages? Let’s try doing that.
+
||This is to not delete the '''installation ''' folder in the '''Finish''' step.
  
 
|-
 
|-
||07:20
+
||07:32
||Go back to the '''Edit Article''' webpage.
+
||I cannot emphasize the importance of this step enough.
  
 
|-
 
|-
||07:22
+
|| 07:36
||First we will remove the horizontal line.
+
||This is one of the most common mistakes.
  
|-
 
|| 07:26
 
|| So click on it and then press the '''Backspace''' key on the keyboard.
 
  
|-
 
||07:31
 
||Now place the cursor at the point where we want to insert the '''Page Break'''.
 
  
 
|-
 
|-
||07:36
+
|| 07:39
||Scroll down and locate the '''Page Break''' button at the bottom of the editor window. Click on it.
+
||So, make sure the folder is deleted.  
  
 
|-
 
|-
||07:43
+
||07:42
||It will open an '''Insert Pagebreak''' dialog box.
+
||If you get an error in this step, you must remove the folder manually.
  
 
|-
 
|-
 
|| 07:47
 
|| 07:47
|| Enter '''Sources''' as '''Page Title''' and '''Food Sources of Sodium''' as '''Table of Contents Alias'''.
+
||I got an error because I am not logged-in as '''linux superuser''' and don't have '''delete permission'''  
  
 
|-
 
|-
||07:57
+
|| 07:56
||Click on '''Insert Page Break''' button.
+
||So, now let us switch to the ''' terminal.'''
  
 
|-
 
|-
||08:00
+
|| 07:59
|| You will see a zig-zag line between the two sections.
+
||We will delete the '''Joomla''' installation folder manually, from the '''joomla''' folder.  
  
 
|-
 
|-
||08:03
+
|| 08:04
||Click on '''Save''' button.
+
||This is mandatory. So, type '''cd slash opt slash lampp slash htdocs slash joomla'''  
  
 
|-
 
|-
||08:06
+
|| 08:14
||Switch to the '''Digital India''' webpage and refresh it.
+
||Press '''Enter'''
  
 
|-
 
|-
||08:10
+
|| 08:16
||This page says '''Page 1 of 2'''.
+
||Then type ''' sudo space rm space minus rf space installation forward slash'''
  
 
|-
 
|-
|| 08:14
+
|| 08:25
|| There are '''Prev''' and '''Next''' buttons below the '''article''' text.
+
||Press ''' Enter'''
  
 
|-
 
|-
||08:19
+
|| 08:27
||A new block has appeared on the right.
+
||We have now successfully installed ''' Joomla. '''
  
 
|-
 
|-
|| 08:22
+
|| 08:30
|| It helps us navigate to the various pages of the particular '''article'''.
+
||We can check this by going to the browser and typing ''' http colon double slash localhost slash joomla'''
  
 
|-
 
|-
||08:27
+
|| 08:40
||The title of the 2nd page is the '''Table of Contents Alias''' we typed earlier…..i.e. '''Food Sources of Sodium'''
+
||We can see our webpage.
  
|-
 
||08:35
 
||Click on '''Next''' button.
 
  
|-
 
||08;37
 
||Now, the page says '''Page 2 of 2'''. 
 
  
|-
 
||08:41
 
||Notice the '''Page Title''' that we typed in the '''Insert Pagebreak''' field.
 
  
 
|-
 
|-
||08:46
+
||08:43
||It has been appended to the title of the '''article'''.
+
||We will now talk about uninstalling ''' Joomla'''.
  
 
|-
 
|-
||08:50
+
|| 08:46
||Now, let’s click on the '''Digital India''' link to go back to our website’s '''Homepage'''.
+
||We need to first delete the folder into which we extracted ''' Joomla.'''
  
 
|-
 
|-
||08:56
+
|| 08:51
||Scroll down to see the '''article Benefits of Sodium'''.
+
||So, I will switch to the '''terminal '''and type ''' sudo space rm space minus rf space forward slash opt slash lampp slash htdocs slash joomla slash'''
  
 
|-
 
|-
|| 09:00
+
|| 09:07
|| Notice here that the full '''article''' text is displayed on the '''Homepage'''.
+
||Press '''Enter'''.
 
+
|-
+
||09:04
+
||Let us explore how to add a '''Read More''' option here.
+
  
 
|-
 
|-
 
|| 09:09
 
|| 09:09
|| This option will show only a part of the '''article''' on the '''Homepage'''.
+
||Now type '''cd forward slash opt slash lampp slash htdocs slash joomla slash '''  
  
 
|-
 
|-
|| 09:14
+
|| 09:17
|| For this '''article''', I’ll insert a '''Read More''' link before the text: '''Daily consumption of sodium, however, depends on a number of factors.'''
+
||This is to check if the folder is deleted.  
  
 
|-
 
|-
||09:22
+
|| 09:20
||Go back to the '''Edit Article''' webpage.
+
||As you can see, the directory does not exist.
  
 
|-
 
|-
||09:25
+
|| 09:24
||Place the cursor at the point where you want to insert the '''Read More''' link.
+
||We will then delete the database and the users.
  
 
|-
 
|-
||09:30
+
|| 09:28
||Now, at the bottom, click on the '''Read More''' button next to the '''Page Break''' button.
+
||This step will uninstall '''Joomla '''completely.
  
 
|-
 
|-
||09:36
+
||09:33
||Scroll up and click on the '''Save''' button.
+
||I will first go to the browser and type '''http colon double slash localhost slash phpmyadmin'''
  
 
|-
 
|-
|| 09:39
+
|| 09:44
|| Switch to the webpage and refresh it.
+
||I will click on the ''' Users ''' tab and select the user ''' Joomla-1'''
  
 
|-
 
|-
||09:42
+
|| 09:50
||We can see the '''Read More''' link below the '''article''' text here.
+
||Below, there is an option ,'''Drop the databases that have same names as the users'''. Click on it.
  
|-
 
||09:46
 
||When we click on it, the '''article Benefits of Sodium''' opens.
 
  
|-
 
|| 09:50
 
|| And it will display the full '''article''' in 2 pages, just as we had set it earlier.
 
  
 
|-
 
|-
 
|| 09:57
 
|| 09:57
|| Let us summarise. In this tutorial, we learnt about: '''Article''' editor in '''Joomla''', Basic formatting of an '''article''', Styling an '''article''' text.
+
||This will give you a prompt .''' You are about to DESTROY a complete database! Do you really want to execute DROP DATABASE?''' Click on '''OK.'''
  
 
|-
 
|-
||10:08
+
||10:07
||We also learnt how to: Insert '''Lists''', Insert '''Page Break''' and Insert '''Read More links''' in '''articles'''.
+
||Now click on '''GO''' button at the bottom right.
  
 
|-
 
|-
||10:15
+
||10:11
||Here is an assignment for you: Modify the 4 health benefits of '''sodium''' as a numbered list. '''Center align''' the heading '''Food Sources'''.
+
||We have now successfully uninstalled ''' Joomla''' from our '''localhost'''.
  
 
|-
 
|-
|| 10:25
+
||10:16
|| Remove the '''Read More''' link and put it just before '''Food Sources'''
+
||Let us summarize. In this tutorial, we learnt about: Common Mistakes and their solutions when installing '''Joomla''' and to uninstall '''Joomla'''
 +
 
 +
|-
 +
||10:28
 +
||Let's come to the assignment now.
  
 
|-
 
|-
 
|| 10:30
 
|| 10:30
|| Add the text '''Melting Point 97.72 °C''' as pre-formatted text along with the current pre-formatted text.
+
||Install ''' Joomla.''' Uninstall''' Joomla''', Check if ''' Joomla''' is indeed uninstalled and Install '''Joomla''' once again.
  
 
|-
 
|-
|| 10:40
+
||10:41
|| Hint is to Use '''special characters''' to get the text '''°C''' in the '''article'''Save the '''article''', Refresh the '''Homepage''', Observe the changes and understand what has happened.
+
||The video at this link, summarizes the Spoken Tutorial project.
  
 
|-
 
|-
|| 10:54
+
|| 10:46
|| The video at the following link, summarizes the '''Spoken Tutorial '''project. Please download and watch it.
+
||If you do not have good bandwidth, you can download and watch it.
  
 
|-
 
|-
|| 11:01
+
||10:51
|| The '''Spoken Tutorial''' Project Team conducts workshops and gives certificates on passing online tests. For more details, please write to us.
+
||The Spoken Tutorial Project Team conducts workshops using spoken tutorials and gives certificates on passing online tests.
  
 
|-
 
|-
||11:11
+
|| 10:59
||'''Spoken Tutorial Project''' is funded by '''NMEICT, MHRD, Government of India.'''. More information on this mission is available at the link shown.
+
||For more details, please write to us.
  
 
|-
 
|-
||11:22
+
||11:03
||This is Priyanka signing off. Thank you for joining.
+
||Spoken Tutorial Project is supported by '''NMEICT, MHRD, Government of India.'''
  
 +
|-
 +
||11:10
 +
||This is Priyanka signing off. Thank you for joining.
 
|-
 
|-
 
|}
 
|}

Revision as of 11:29, 14 February 2018

Time Narration
00:01 Welcome to the Spoken Tutorial on Common Mistakes while Installing Joomla and Uninstalling Joomla on a local server.
00:11 In this tutorial, we will learn about: Common mistakes when installing Joomla, Solutions to those mistakes and How to uninstall Joomla
00:23 For this tutorial, we will be using: Ubuntu Linux 14.04, Joomla 3.4.1, Apache, MySQL and PHP obtained through XAMPP 5.5.19
00:41 To follow this tutorial, you need to have: XAMPP and Joomla installed on your system.
00:49 You also need to have knowledge of the Joomla installation process.
00:54 If not, check the relevant tutorial in the Joomla series, on the spoken tutorial website.
01:02 First of all, let me start XAMPP on my machine.
01:06 Let's open the terminal by pressing Ctrl + Alt + T keys.
01:12 Alternately, click on the “Terminal” icon in the launcher bar. |-
01:17 Start XAMPP by typing sudo space slash opt slash lampp slash lampp space start and press Enter.
01:28 It will prompt for administrative password.
01:31 Let me type my administrative password and press Enter.
01:36 Now we have XAMPP running.
01:39 The first mistake one can make is to extract Joomla in a different directory.
01:45 Go the the browser and open the XAMPP page by typing http colon double slash localhost and press Enter
01:55 In the menu on the left of the screen, click on phpinfo().
02:00 Now press Ctrl +F keys and search for DOCUMENT underscore ROOT.
02:07 It will be found in the table Apache Environment.
02:11 Value of DOCUMENT underscore ROOT will be either slash opt slash lampp slash htdocs or

slash var slash www

02:14 In my machine, it is slash opt slash lampp slash htdocs.
02:30 Please note that Joomla needs to be extracted in the apache DOCUMENT underscore ROOT directory.
02:37 If this is not the case, the installation setting page would not show up at all.
02;43 Second common mistake that one can make is to have the output buffering ON.


02:49 In the 3rd step of the installation setup, output buffering should be marked as OFF.
02:55 This is a recommended setting and not a required setting.
02:59 Usually, by default, it is turned OFF.
03:03 If output buffering is ON, installation might proceed successfully.
03:08 However, the website might be extremely slow later.
03:12 In some cases, installation might hang up at this step.
03:17 In case it is ON, we can turn it OFF by editing php.ini in the apache installation.
03:24 We will go to the terminal window and locate php.ini first by typing locate space php dot ini and press Enter.
03:37 We may get a number of results for this query.
03:40 There will be one result in which php.ini will be inside the etc directory.
03:48 This directory is inside the lampp directory inside the opt directory.
03:54 This is the one we need to edit.
03:57 In my machine, the path to that file is slash opt slash lampp slash etc slash php.ini
04:07 We open the file in Gedit text editor by typing sudo space gedit space slash opt slash lampp slash etc slash php dot ini
04:23 If prompted, enter your admin password.
04:27 You will have to do so whenever prompted, as we proceed.
04:32 Gedit is the default text editor preloaded in Ubuntu Linux.
04:37 Alternately, you can use any text editor of your choice.
04:42 When the file is open, search for output underscore buffering.
04:48 The first search result we get is commented. So we check for the next result.
04:54 Here we find the text we are looking for.
04:57 Change output underscore buffering = 4096 to output underscore buffering = off
05:05 We save the file by pressing Control + S keys.
05:09 We can then exit the Gedit editor.
05:12 We need to restart XAMPP for the change to get reflected.


05:16 Switch to the terminal and type sudo space slash opt slash lampp slash lampp space restart
05:25 Press Enter.
05:27 So, we can proceed to the next step.
05:30 The third mistake you can make is to have no write permission for the configuration file.
05:36 In the last step of installation, you might get an error that says “Your configuration file or directory is not writable or there was a problem creating the configuration file”.
05:48 This occurs when we forget to give write permission to the Joomla folder.
05:53 If this error occurs, you will get some text inside a text box.
05:58 We will copy this text using Control + C keys.
06:02 In this case, we can create a new configuration.php file and paste the text into it.
06:09 We will use the touch command to create the configuration.php inside our joomla folder.
06:16 At the command prompt type sudo space touch space slash opt slash lampp slash htdocs slash joomla slash configuration dot php
06:32 Press Enter.



06:34 Then type sudo space gedit space slash opt slash lampp slash htdocs slash joomla slash configuration dot php.'
06:46 Press Enter.
06:49 This will open the file in Gedit text editor.
06:52 Paste the copied text inside this file.
06:56 Check the file to make sure left bracket question mark php is present as the first line of the file

and the content is exactly the same

07:08 Save the configuration.php by pressing Control + S keys.
07:14 We can then exit the Gedit editor.
07:17 Now we have the configuration.php for our Joomla installation.
07:22 Now, we will see the fourth mistake that one can make during the Joomla installation.
07:27 This is to not delete the installation folder in the Finish step.
07:32 I cannot emphasize the importance of this step enough.
07:36 This is one of the most common mistakes.


07:39 So, make sure the folder is deleted.
07:42 If you get an error in this step, you must remove the folder manually.
07:47 I got an error because I am not logged-in as linux superuser and don't have delete permission
07:56 So, now let us switch to the terminal.
07:59 We will delete the Joomla installation folder manually, from the joomla folder.
08:04 This is mandatory. So, type cd slash opt slash lampp slash htdocs slash joomla
08:14 Press Enter
08:16 Then type sudo space rm space minus rf space installation forward slash
08:25 Press Enter
08:27 We have now successfully installed Joomla.
08:30 We can check this by going to the browser and typing http colon double slash localhost slash joomla
08:40 We can see our webpage.



08:43 We will now talk about uninstalling Joomla.
08:46 We need to first delete the folder into which we extracted Joomla.
08:51 So, I will switch to the terminal and type sudo space rm space minus rf space forward slash opt slash lampp slash htdocs slash joomla slash
09:07 Press Enter.
09:09 Now type cd forward slash opt slash lampp slash htdocs slash joomla slash
09:17 This is to check if the folder is deleted.
09:20 As you can see, the directory does not exist.
09:24 We will then delete the database and the users.
09:28 This step will uninstall Joomla completely.
09:33 I will first go to the browser and type http colon double slash localhost slash phpmyadmin
09:44 I will click on the Users tab and select the user Joomla-1
09:50 Below, there is an option ,Drop the databases that have same names as the users. Click on it.


09:57 This will give you a prompt . You are about to DESTROY a complete database! Do you really want to execute DROP DATABASE? Click on OK.
10:07 Now click on GO button at the bottom right.
10:11 We have now successfully uninstalled Joomla from our localhost.
10:16 Let us summarize. In this tutorial, we learnt about: Common Mistakes and their solutions when installing Joomla and to uninstall Joomla
10:28 Let's come to the assignment now.
10:30 Install Joomla. Uninstall Joomla, Check if Joomla is indeed uninstalled and Install Joomla once again.
10:41 The video at this link, summarizes the Spoken Tutorial project.
10:46 If you do not have good bandwidth, you can download and watch it.
10:51 The Spoken Tutorial Project Team conducts workshops using spoken tutorials and gives certificates on passing online tests.
10:59 For more details, please write to us.
11:03 Spoken Tutorial Project is supported by NMEICT, MHRD, Government of India.
11:10 This is Priyanka signing off. Thank you for joining.

Contributors and Content Editors

PoojaMoolya, Sandhya.np14, Venuspriya