{"id":21241274,"url":"https://github.com/joomla/volunteers.joomla.org","last_synced_at":"2025-10-29T14:35:19.136Z","repository":{"id":55013810,"uuid":"61070679","full_name":"joomla/volunteers.joomla.org","owner":"joomla","description":"Extension for the volunteers portal","archived":false,"fork":false,"pushed_at":"2025-01-10T18:25:48.000Z","size":52555,"stargazers_count":21,"open_issues_count":13,"forks_count":20,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-06-06T08:24:52.711Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joomla.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-06-13T21:23:10.000Z","updated_at":"2025-01-10T18:25:52.000Z","dependencies_parsed_at":"2025-04-18T18:40:34.138Z","dependency_job_id":null,"html_url":"https://github.com/joomla/volunteers.joomla.org","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/joomla/volunteers.joomla.org","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomla%2Fvolunteers.joomla.org","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomla%2Fvolunteers.joomla.org/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomla%2Fvolunteers.joomla.org/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomla%2Fvolunteers.joomla.org/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joomla","download_url":"https://codeload.github.com/joomla/volunteers.joomla.org/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joomla%2Fvolunteers.joomla.org/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259925015,"owners_count":22932835,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-21T00:55:16.657Z","updated_at":"2025-10-29T14:35:09.407Z","avatar_url":"https://github.com/joomla.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# volunteers.joomla.org\nThis is the repository of the website [volunteers.joomla.org](https://volunteers.joomla.org). This websites runs on a default Joomla! installation extended with a custom component called `com_volunteers`. Your ideas, feature requests, bug reports and code contributions are welcome! \n \n# Bugs, ideas \u0026 feature requests\nPlease use the [Issue tracker](https://github.com/joomla/volunteers.joomla.org/issues) to report bugs, ideas and feature requests.\n\n---\n\n# Contributing code\nCode contributions are very welcome! Browse the [Issue tracker](https://github.com/joomla/volunteers.joomla.org/issues) for issues that need code and/or come up with your own ideas \u0026 code. Please open a [Pull Request](https://github.com/joomla/volunteers.joomla.org/pulls) to contribute your own code.\n\n## Local Development\nYou can fork \u0026 clone the repository for local development. To get started you need to:\n - Clone the repository\n - Set up the [sample database](https://github.com/joomla/volunteers.joomla.org/tree/master/database/installation/)\n - Rename `configuration.php.dist` into `configuration.php`, add the database credentials and paths to the `logs` and `tmp` folder. All marked with `[XXXXXXXXXX]`.\n - Rename `htaccess.txt` into `.htaccess`\n\n## Database changes\nPlease update the sample database if any code changes are needed for your code contributions and add a .sql file with the changes in the [updates folder](https://github.com/joomla/volunteers.joomla.org/tree/master/database/updates/) and use the issue number as filename. \n\n---\n\n# Volunteers Portal Structure\nThe Volunteers Portal and its custom component `com_volunteers` is using the following setup.\n\n_Note: please read `Departments` as `Leadership` until the new organizational structure and methodology of the Joomla!-project is in place._\n\n## Departments\n`com_volunteers/departments`\n\nA Department has a _Departmental Coordination Team Leader_, _Assistant Departmental Coordination Team Leader_ and _Departmental Coordinators_. A department has several teams within their department. Within the department Reports can be created. Volunteers are assigned to a department as Member.\n\n## Teams\n`com_volunteers/teams`\n\nA Team has a _Team Leader_, _Assistant Team Leader_, _Members_ and _Contributors_. A team is assigned to one department. A team can also contain one or more subteams. Within the team Reports and Roles can be created. Volunteers are assigned to a team as Member.\n\n## Volunteers\n`com_volunteers/volunteers`\n\nA Volunteer (_Joomler_) is a user with an account on the website. A volunteer has their own profile with fields that can be edited by the volunteer.\n\n## Members\n`com_volunteers/members`\n\nA Member is the relation between a Department or Team and a Volunteer. It also contains their Position and (optional) Role within the Department or Team. Each member has a Start Date. Once someone steps down an End Date will be set and the volunteer will move to the Honour Roll. Permissions connected with their Position will become inactive. \n\n## Reports\n`com_volunteers/reports`\n\nA Report is an article reporting about the progress of a Department or Team and written by a Volunteer.\n\n## Positions\n`com_volunteers/positions`\n\nA Position is the relation between a Volunteer and its permissions. Departments and Teams have their own set of positions \u0026 permissions:\n\n### Departments\n\n* **Departmental Coordination Team Leader**\nThe _Departmental Coordination Team Leader_ is the leader of a department.\n\n* **Assistant Departmental Coordination Team Leader**\nThe _Assistant Departmental Coordination Team Leader_ is the assistant of a Departmental Coordination Team Leader.\n\n* **Departmental Coordinator**\nThe _Departmental Coordinator_ is a general member of a department.\n\n#### Permissions\n\nThe _Departmental Coordination Team Leader_, _Assistant Departmental Coordination Team Leader_ and _Departmental Coordinator_ can:\n\n* create \n  * teams within the department\n  * reports for the department and teams within the department\n  * members for the department and teams within the department\n  * roles for the teams within the department\n* edit\n  * department\n  * teams within the department\n  * reports within the department and its teams\n  * members within the department and its teams\n  * roles for the teams within the department\n\n### Teams\n\n* **Team Leader**\nThe _Team Leader_ is the leader of a (sub)team.\n\n* **Assistant Team Leader** \nThe _Assistant Team Leader_ is the assistant to the leader of a (sub)team.\n\n* **Member** \nThe _Member_ is a general member of a team.\n\n* **Contributor** \nThe _Contributor_ is a contributing, but not a member of a team.\n\n#### Permissions\n\nThe _Team Leader_ and _Assistant Team Leader_ can:\n\n* create \n  * subteams for the team\n  * reports for the team and subteams\n  * members for the team and subteams\n  * roles for the team and subteams\n* edit\n  * team\n  * subteams\n  * reports within the team and subteams\n  * members within the team and subteams\n  * roles within the team and subteams\n  \nThe _Member_ can:\n\n* create \n  * reports for the team involved\n* edit\n  * their own reports\n  \nThe _Contributor_ can:\n\n* _none_\n\n## Roles\n`com_volunteers/roles`\n\nA Role is used (optionally) for teams. For each role a description can be provided and if the Role is open (Team is looking for Volunteers for the Role).\n\n---\n\n## Test User Accounts\nThe sample database has several accounts available for testing.\n\n#### Admin\n\n**Admin User**\n* User ID: 1\n* Name: `Admin Joomler`\n* Email: `admin@volunteers.joomla.org`\n* Password: `test`\n\n#### Departmental Coordination Team Leader\n\n**Frontend Department**\n* User ID: 2\n* Name: `Frontend Leader`\n* Email: `frontend.leader@volunteers.joomla.org`\n* Password: `test`\n\n**Backend Department**\n* User ID: 5\n* Name: `Backend Leader`\n* Email: `backend.leader@volunteers.joomla.org`\n* Password: `test`\n\n#### Assistant Departmental Coordination Team Leader\n\n**Frontend Department**\n* User ID: 3\n* Name: `Frontend Assistant`\n* Email: `frontend.assistant@volunteers.joomla.org`\n* Password: `test`\n\n**Backend Department**\n* User ID: 6\n* Name: `Backend Assistant`\n* Email: `backend.assistant@volunteers.joomla.org`\n* Password: `test`\n\n#### Departmental Coordinator\n\n**Frontend Department**\n* User ID: 4\n* Name: `Frontend Coordinator`\n* Email: `frontend.coordinator@volunteers.joomla.org`\n* Password: `test`\n\n**Backend Department**\n* User ID: 7\n* Name: `Backend Coordinator`\n* Email: `backend.coordinator@volunteers.joomla.org`\n* Password: `test`\n\n#### Team Leader\n\n**Extensions Team**\n* User ID: 8\n* Name: `Extensions Leader`\n* Email: `extensions.leader@volunteers.joomla.org`\n* Password: `test`\n\n**Sample Data Team**\n* User ID: 12\n* Name: `Sample Leader`\n* Email: `sample.leader@volunteers.joomla.org`\n* Password: `test`\n\n#### Assistant Team Leader\n\n**Extensions Team**\n* User ID: 9\n* Name: `Extensions Assistant`\n* Email: `extensions.assistant@volunteers.joomla.org`\n* Password: `test`\n\n**Sample Data Team**\n* User ID: 13\n* Name: `Sample Assistant`\n* Email: `sample.assistant@volunteers.joomla.org`\n* Password: `test`\n\n#### Member\n\n**Extensions Team**\n* User ID: 10\n* Name: `Extensions Member`\n* Email: `extensions.member@volunteers.joomla.org`\n* Password: `test`\n\n**Sample Data Team**\n* User ID: 14\n* Name: `Sample Member`\n* Email: `sample.member@volunteers.joomla.org`\n* Password: `test`\n\n#### Contributor\n\n**Extensions Team**\n* User ID: 11\n* Name: `Extensions Contributor`\n* Email: `extensions.contributor@volunteers.joomla.org`\n* Password: `test`\n\n**Sample Data Team**\n* User ID: 15\n* Name: `Sample Contributor`\n* Email: `sample.contributor@volunteers.joomla.org`\n* Password: `test`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoomla%2Fvolunteers.joomla.org","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoomla%2Fvolunteers.joomla.org","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoomla%2Fvolunteers.joomla.org/lists"}