{"id":19123066,"url":"https://github.com/akashcraft/gradeplus","last_synced_at":"2025-05-05T18:33:37.267Z","repository":{"id":256524426,"uuid":"855551929","full_name":"akashcraft/GradePlus","owner":"akashcraft","description":"ECE 6400 Project","archived":false,"fork":false,"pushed_at":"2024-11-27T17:24:40.000Z","size":62419,"stargazers_count":0,"open_issues_count":0,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-19T11:08:32.061Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/akashcraft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-09-11T03:56:59.000Z","updated_at":"2024-11-27T17:24:43.000Z","dependencies_parsed_at":"2024-09-11T11:10:15.060Z","dependency_job_id":"1f9a4f5c-1e07-4fa2-8d79-1dc1565613d3","html_url":"https://github.com/akashcraft/GradePlus","commit_stats":null,"previous_names":["akashcraft/gradeplus"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashcraft%2FGradePlus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashcraft%2FGradePlus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashcraft%2FGradePlus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashcraft%2FGradePlus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akashcraft","download_url":"https://codeload.github.com/akashcraft/GradePlus/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252553134,"owners_count":21766835,"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-09T05:24:11.668Z","updated_at":"2025-05-05T18:33:37.228Z","avatar_url":"https://github.com/akashcraft.png","language":"PHP","readme":"## GradePlus\nECE 6400 Project\n\n## Installation Guide\n\n### Software Requirements\n\nDownload and install the following software:\n\n- [XAMPP](https://www.apachefriends.org/) (Comes with Apache, PHP, and MySQL bundled)\n- [Git](https://git-scm.com/downloads) (Required - macOS users can `brew install git` if needed)\n- VSCode\n- Any Chromium Browser (Google Chrome, Microsoft Edge, etc.)\n\n### VSCode Extensions\n\n- PHP Server by brapifra (Required)\n- php cs fixer by junstyle (Required)\n- Live Server by Ritwick Dey (Optional)\n- GitHub Copilot (Recommended - Students get free GitHub Pro)\n\n### GitHub\n\nYou need to have a GitHub account. Please create one if you have not done so.\n\n\u003e [!TIP]\n\u003e For GitHub Copilot, you need to get GitHub Pro which is free for students. However, GitHub will ask for document verification which may take 2-3 business days.\n\nOnce that is done, fork this repository first and then clone it to your local machine.\n\n\u003cimg width=\"400px\" src=\"https://github.com/user-attachments/assets/d5856cfb-6ea4-426f-b717-7f788d5511a5\"\u003e\n\nUse the following command to clone the forked repository to your local machine.\n\n```\ngit clone \u003cYOUR FORKED REPO ADDRESS\u003e \u003cOPTIONAL FOLDER NAME\u003e\n```\n\n\u003cimg width=\"400px\" src=\"https://github.com/user-attachments/assets/3cc28e2f-5526-44f2-9741-6ff8b70ad942\"\u003e\n\n### XAMPP\n\nTo run the initial boiler plate code, you only need PHP which comes bundled with XAMPP. XAMPP will be used to run the PHP server and MySQL database in the future. Here is a quick look. Just clicking the first two buttons will do the job. No need for complex MySQL or Docker setups. Again not needed for initial setup.\n\n\u003cimg width=\"400px\" src=\"https://github.com/user-attachments/assets/4e48b96c-a4b2-488b-b4c1-ff2142fc9b36\"\u003e\n\u003cbr\u003e\u003cbr\u003e\n\nInstall XAMPP in the root directory of your C: drive. Please add the PHP directory to user PATH during or after installation. In some cases, you may need to add to VSCode settings as well. It would be `C:\\xampp\\php`.\n\n\u003cimg width=\"400px\" src=\"https://github.com/user-attachments/assets/68df2e84-7ebc-4b80-92a5-4bfcc8ab6db0\"\u003e\n\u003cbr\u003e\u003cbr\u003e\n\nTo verify your PHP installation, run the following command in a terminal window.\n\n```\nphp --version\n```\n\nYou should see your installed PHP version.\n\n\u003cimg width=\"400px\" src=\"https://github.com/user-attachments/assets/5f70ca0d-44e1-4863-87e4-257a9154abac\"\u003e\n\n\n## Formatter\n\u003e [!IMPORTANT]\n\u003e Finally add `php cs fixer` VSCode Extension as the default formatter in VSCode Settings. This is **important**. If we do not use a consistent formatter, PRs may have incorrect indentation when you `CTRL+S` php files leading to huge unnecessary changes across the whole file.\n\n\u003cimg width=\"400px\" src=\"https://github.com/user-attachments/assets/694af1ea-c7f5-4024-9fdf-052dad042019\"\u003e\n\n### Running the Code\nGo to the `index.php` file in the project folder. Click the button on top right or right click and select `PHP Server: Serve Project`. This will open up your default browser automatically.\nYou should see a green themed GradePlus website. If you see that, you are good to go. If you have any questions, please give me a tag in the discord or `asamanta@mun.ca`.\n\u003cbr\u003e\u003cbr\u003e\nBest Regards,\u003cbr\u003e\nAkash Samanta\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakashcraft%2Fgradeplus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakashcraft%2Fgradeplus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakashcraft%2Fgradeplus/lists"}