GitHub is a web-based hosting service for projects that use the Git revision control system.

Purpose of Github Action

If you are using Github to manage your ticketing system and want to create issues dynamically on some form submission say, when any user reports a bug and you wish to create an issue for the same in your Github account.

This can be achieved by Github-Issue action.

How to setup Asana-Task action :

Step 1:

Go to plugin manager and enable the GitHub plugin. You can also enable the plugin from JXiForms dashboard.

Enable Plugin to Create Issue in GitHub on Form Submission : Joomla Forms

Step 2:

Now from JXiForms action screen, create action ofGithub-issue type.

How to Make Form To Create Issue on GitHub

Step 3:

Enter the details asked in the Github action screen.

[span style="text-decoration: underline;"]Under the Github-Issue - Details section[/span]

  • [span style="line-height: 1.3em;"]Title : Title of the action.[/span]

  • [span style="line-height: 1.3em;"]Published : It indicates the status of the action (published or not).[/span]

  • [span style="line-height: 1.3em;"]Description : Description of the action.[/span]

  • [span style="line-height: 1.3em;"]Select Form : Here you can select the form list on which you want to apply this action.[/span]

  • [span][strong style="line-height: 1.3em;"]Require Approval :[/strong][span style="line-height: 1.3em;"] This parameter lets you decide whether to place approval request before creating issue in[/span]Github[span style="line-height: 1.3em;"]If you set this to YES then issue will be created only after your approve it. And if this setting is set to NO then issue will be created immediately after the form submission.[/span][/span]

[span][span style="line-height: 1.3em;"]Enter Details To Create Forms Which Submit Data to Add Issue on GitHub[/span][/span]

Step 4:

[span style="text-decoration: underline;"]Under the Parameters Section-[/span]

  • [strong style="line-height: 1.3em;"]Github Username :[/strong][span style="line-height: 1.3em;"]Enter username of GitHub account.[/span]

  • [span style="line-height: 1.3em;"]Password :Enter the password.[/span]

  • [span style="line-height: 1.3em;"]Repository Name :Repository name in which you want to create issue.[/span]

  • [span style="line-height: 1.3em;"]Organization Name :Enter name of the organization above mentioned repository belongs to.[/span]

  • [span style="line-height: 1.3em;"]Issue Title : Name of the issue to create. Here you can add user submitted data as well by using relevant token.[/span]

  • [span style="line-height: 1.3em;"]Issue Description :Description about the issue, here also you can add user submitted data by using token.[/span]

  • [span style="line-height: 1.3em;"]Milestone :Select the milestone to associate this issue.[/span]

  • [span style="line-height: 1.3em;"]Labels :Associate labels with the issue. You can apply multiple labels on the issue by providing comma separated values. Provided label gets created if does not exists. Label names are case-sensitive.[/span]

  • [span style="line-height: 1.3em;"]Assignee :Enter the username to whom this created issue should be assigned to.[/span]

[span style="text-decoration: underline;"]Points to Note[/span]

  1. If the repository in which you are creating issue lies under an organization then it is mandatory to enter the organization name otherwise issue will either be created in the same name repository outside the organization if exists or no issue will be created.

  2. [span style="line-height: 1.3em;"]Only users with push access can set the assignee, labels and milestones for new issues.These options can be silently dropped otherwise.[/span]

[span style="line-height: 1.3em;"]Additional requirements : cURL installation on your server is mandatory to use this action.[/span]