Joomla - Donation Module

In this chapter, we will study the donation module in Joomla.

Donation Module

Following are the simple steps to edit an existing donation module in Joomla.

Step 1 − Click Extension → Module Manager in Joomla Admin, the following screen will appear.

Step 2 − Next, click on the New button and the following screen will appear. Next, click on OS Donate .

Step 3 − After clicking on OS Donate , the existing Donate module will appear as shown below.

By default, the Module tab is displayed . Below we have mentioned the details of the fields present in the Module tab .

• Title - Displays the title of the module.

• Module class suffix - These modules are allowed to create custom CSS styles to apply.

• Open in new window - opens a new window after clicking on the PayPal button.

• Success Return Page - Enter the URL of the page that the user will return to after donating to PayPal.

• Cancel Return Page - Enter the URL of the page the user will return to after canceling a PayPal donation.

• Company Logo URL - Enter the path to the company logo image.

• PayPal button image - Sets the path to the PayPal button.

• Show introductory text - Introductory text is displayed in the module.

• Intro Text - Enter the intro text that appears in the module.

• E-Mail / PayPal ID - Enter your PayPal ID or email address.

• PayPal Description - Displays a brief description of the PayPal donation.

• Currencies - Allow users to select currencies.

• PayPal Language - Set the language for PayPal.

• Show Field Amount - The editable amount field is displayed.

• Amount - The donation amount is set.

• Show Title - Show the title of the module at the front.

• Position - will select the position of the module for display.

• Status - Displays the status of the article, such as Published, Unpublished, and Trash .

• Start Publishing - Publishing will start at the scheduled date and time.

• Finish Publication - The publication will be completed at the scheduled date and time.

• Access - Allows only selected users from the drop down list, such as Guest, Public, Superusers, Registered and Special, to view items.

• Order − Displays a drop down list of all modules present in the position.

• Language - defines the language of the site. It provides either ALL or English (UK) options.

• Note. Used to enter text information.

Title - Displays the title of the module.

Module class suffix - These modules are allowed to create custom CSS styles to apply.

Open in new window - opens a new window after clicking on the PayPal button.

Success Return Page - Enter the URL of the page that the user will return to after donating to PayPal.

Cancel Return Page - Enter the URL of the page the user will return to after canceling a PayPal donation.

Company Logo URL - Enter the path to the company logo image.

PayPal button image - Sets the path to the PayPal button.

Show introductory text - Introductory text is displayed in the module.

Intro Text - Enter the intro text that appears in the module.

E-Mail / PayPal ID - Enter your PayPal ID or email address.

PayPal Description - Displays a brief description of the PayPal donation.

Currencies - Allow users to select currencies.

PayPal Language - Set the language for PayPal.

Show Field Amount - The editable amount field is displayed.

Amount - The donation amount is set.

Show Title - Show the title of the module at the front.

Position - will select the position of the module for display.

Status - Displays the status of the article, such as Published, Unpublished, and Trash .

Start Publishing - Publishing will start at the scheduled date and time.

Finish Publication - The publication will be completed at the scheduled date and time.

Access - Allows only selected users from the drop down list, such as Guest, Public, Superusers, Registered and Special, to view items.

Order − Displays a drop down list of all modules present in the position.

Language - defines the language of the site. It provides either ALL or English (UK) options.

Note. Used to enter text information.

Step 4 − The Description tab provides a brief description of the donation module.

Step 5 − When we click on the Menu Assignment tab , you get a screen as shown below.

• Module Destination - Select an option to view the item from the drop-down list, such as All Pages, No Pages, Only Selected Pages, or All Pages Except Selected .

• Menu selection - after selecting the option, only the selected pages or all pages except those selected will display all the menu items present in Joomla. This will allow the module to be assigned to some rather than all pages.

Module Destination - Select an option to view the item from the drop-down list, such as All Pages, No Pages, Only Selected Pages, or All Pages Except Selected .

Menu selection - after selecting the option, only the selected pages or all pages except those selected will display all the menu items present in Joomla. This will allow the module to be assigned to some rather than all pages.

Step 6 − Module Permissions tab shows three actions to choose from. It manages the module's permission settings for user groups, as shown in the following screen.

• Delete - Allows users in the group to delete the content present in the module.

• Edit - Allows users in the group to edit the content present in the module.

• Edit State - Allows users in the group to change the state of the content present in the module.

Delete - Allows users in the group to delete the content present in the module.

Edit - Allows users in the group to edit the content present in the module.

Edit State - Allows users in the group to change the state of the content present in the module.

Step 7 − In the sticky hover options tab , you can set sticky hover options.

• Use sticky hover - sets the position of the module where the PayPal button is set to permanent after the page is scrolled.

• Horizontal Reference Side — Sets the reference side horizontally to the left or right.

• Horizontal Distance - sets the horizontal distance in pixels.

• Vertical Support Side - Sets the support side vertically down or up.

• Vertical Distance - Sets the vertical distance in pixels.

• Font Color - Enter the font color in hexadecimal value.

• Width - Set the width.

Use sticky hover - sets the position of the module where the PayPal button is set to permanent after the page is scrolled.

Horizontal Reference Side — Sets the reference side horizontally to the left or right.

Horizontal Distance - sets the horizontal distance in pixels.

Vertical Support Side - Sets the support side vertically down or up.

Vertical Distance - Sets the vertical distance in pixels.

Font Color - Enter the font color in hexadecimal value.

Width - Set the width.

Step (8) − The Advanced tab is used to make advanced settings for the Donation module. A screenshot of the Advanced tab is shown below.

• Module Tag - Specifies the HTML tag for modules.

• Bootstrap Size - Selects the width of the built-in bootstrap module.

• Header tag − Modules use HTML header tags.

• Header Class - Additional CSS classes are added to the header of the module.

• Module Style - Overrides the template style for its position.

Module Tag - Specifies the HTML tag for modules.

Bootstrap Size - Selects the width of the built-in bootstrap module.

Header tag − Modules use HTML header tags.

Header Class - Additional CSS classes are added to the header of the module.

Module Style - Overrides the template style for its position.

Toolbar

Following are the details about the feature tabs provided in the donation module toolbar.

Save - saves your modules.

Save and Close - Saves modules and closes the current screen.

Save & New - saves modules and opens a new module creation screen.

Cancel - cancel created modules in Joomla.