Skip to content

Commit

Permalink
feat!: Editting features and Status of courses
Browse files Browse the repository at this point in the history
  • Loading branch information
DreamyWanderer committed Feb 5, 2024
1 parent c7e2458 commit 58a37e6
Show file tree
Hide file tree
Showing 11 changed files with 1,560 additions and 35 deletions.
414 changes: 414 additions & 0 deletions Changelog.html

Large diffs are not rendered by default.

75 changes: 63 additions & 12 deletions Changelog.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,75 @@
# HCMUS GPA Calculator Bookmarklet (v 2.0.0)

Add a feature to Hcmus Portal, calculate and show your GPA
# HCMUS GPA Calculator Bookmarklet Maintenance Project

- [HCMUS GPA Calculator Bookmarklet Maintenance Project](#hcmus-gpa-calculator-bookmarklet-maintenance-project)
- [Contributions](#contributions)
- [What is this?](#what-is-this)
- [List Updates](#list-updates)
- [Update 4 (-)](#update-4--)
- [Update 3 (-)](#update-3--)
- [Update 2](#update-2)
- [Update 1](#update-1)
- [Update 0](#update-0)
- [List of bugs fixed](#list-of-bugs-fixed)
- [List of minor modification](#list-of-minor-modification)
- [Bugs](#bugs)
- [Guideline](#guideline)
- [Bugs Report and Suggestions](#bugs-report-and-suggestions)
- [Licenses and Derivative Works](#licenses-and-derivative-works)

## Contributions

*Thanks **[vkhuy's repository](https://github.com/vkhuy/GPABookmarklet)** for [this finding](#thcsBug). Thanks [Nguyen Quang Thang](https://github.com/thanguyen165) for the 4.0 grade system calculation implementation!*

## What is this?

This is a [forked version](https://github.com/DreamyWanderer/GPABookmarklet_Maintanence) of GPABookmarlet utility, which is created by the execellent [dtrung98's repository](https://github.com/dtrung98/GPABookmarklet). Thank you so much for providing this repository as an open source project!

It has been 4 years since the last updated of original repository, and unfortunately I observed a bug comes from Portal itself which this bookmarklet need to deal with. Although they are not computation bugs (which will be more severe), but they can cause some confusion for user. Recently the portal is receiving frequenly updating, so I think there should be a consistent maintenance for GPABookmarklet to cope with those changings 😢.
This project maintained primarily by DreamyWanderer Github user, who is currently a student of VNU-HCMUS. Originally, this extension is developed by dtrung98 Github user (a graduated student) with a simple purpose: **Calculate the GPA for HCMUS student automatically** on their Portal page.

It has been 4 years since the last updated of original repository, and unfortunately I observed a bug comes from Portal itself which this bookmarklet need to deal with. Although they are not computation bugs (which will be more severe), but they can cause some confusion for user. Recently the portal is receiving frequenly updating and the school is also developing a new Portal page, so I think there should be a consistent maintenance for GPABookmarklet to cope with those changings 😢.

Besides that, I also add some minor modifications to this bookmaklet for ~~my~~ user's convenience 😆.

## List of bugs fixed
So in short, the goal of this project is:

- Maintenace the extension to **work at least properly** with the **old** Portal page **until that page is no longer work**. There will be **no more** features added to this extension version.
- Develope the extension to **work properly** with the **new** Portal page (bring all funtions that **existed** in old Portal page to the new one) and **add more features** as users requires.

## List Updates

### Update 4 (-)

Phiên bản dùng cho trang Portal cũ (portal4.hcmus.edu.vn) hiện có thể chạy trên trình duyệt của điện thoại di động và tự động cập nhật các chỉnh sửa mà không cần phải thay đổi bookmark thủ công (tương tự như bản dùng cho trang Portal mới (student.hcmus.edu.vn) ở Update 3). Các bạn nên vào trang hướng dẫn (https://dreamywanderer.github.io/GPABookmarklet_Maintanence/) và thay Bookmark của GPA dùng cho Portal cũ lần cuối nhé.

### Update 3 (-)

Hiện tại, các bạn có thể sử dụng GPA Bookmarklet cho [Portal mới](https://student.hcmus.edu.vn/student-affairs) của trường nhé. Các tính năng hiện có:

- Tính điểm GPA.
- Hiện các bạn có thể chạy tiện ích này với bản Portal mới ngay trên trình duyệt điện thoại nhé.

Trong thời gian tới nếu cần thiết thì mình sẽ implement lại các tính năng hiện có bên bản của Portal cũ để hoạt động trên Portal mới.

Hiện tại trang Portal mới của trường có vẻ đang được update thường xuyên nên sẽ không tránh khỏi nhiều lúc tiện ích bị lỗi. Khi đó mình sẽ tìm cách fix lại. Nếu các bạn dùng bản có tên "Khtn GPA Portal-v2.0" thì không cần cập nhật thủ công nhé, chỉ cần chờ một chút (Chắc vậy!).

Note: Nếu trang Portal mới của trường nâng mức bảo mật của CSP thì phiên bản di động và cập nhật tự động sẽ không hoạt động nữa :>>


### Update 2

Cập nhật lại cách quy đổi hệ 4.0.

Ngoài ra, các đầu điểm chính thức từ Phòng Đào tạo sẽ cập nhật tại trang Portal mới của trường, còn tại trang Poral cũ thì không chắc là cũng sẽ vậy. Do đó các bạn cân nhắc xem điểm bên trang mới nhé. Nếu như cần thiết thì tiện ích này sẽ được chỉnh sửa nhanh để dùng tạm cho trang Portal mới 🥲.

### Update 1

GPA Bookmarklet v 2.0 sẽ được nhập vào Github repo gốc của anh Lê Đình Trung, nên các bạn cũng có thể dùng link cũ (https://dtrung98.github.io/GPABookmarklet/) vẫn được nhé.

Tuy nhiên, do có độ trễ khi hai trang hướng dẫn được nhập lại nên các bản Update có kí hiệu (-) sẽ chỉ áp dụng với đường link (https://dreamywanderer.github.io/GPABookmarklet_Maintanence/) cho tới khi kí hiệu (-) mất.

### Update 0

##### List of bugs fixed

- ~~Deal with a bug comes from Portal, which duplicate some graded courses (GPABookmarklet takes all of duplication for computing).~~

Expand All @@ -36,7 +93,7 @@ Besides that, I also add some minor modifications to this bookmaklet for ~~my~~

<br>

## List of minor modification
#### List of minor modification

- Calculate "**Điểm trung bình học tập**" (includes courses that student has not passed).

Expand Down Expand Up @@ -82,12 +139,6 @@ Besides that, I also add some minor modifications to this bookmaklet for ~~my~~

- Sometimes enabling the letter/4 grade system causes wrong format. You should re-run the GPABookmarklet to see if that can be fixed.

## Future modification

- Let user adds courses as if they have studided them and calculate GPA (it can be useful in case you want to plan what subjects you should learn and what grade you should get for goal GPA).

- Create a version for Tampermonkey, so that the source code can be more organizable and be able to add more features.

## Guideline

- Step 1: You must be a HCMUS Student.
Expand Down
Binary file added Figure/Editting.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Figure/Tutorial.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 4 additions & 2 deletions bookmarklet.js
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
javascript: (async function gpa() {
async function main() {
console.clear()

const currentHref = window.location.href;
Expand Down Expand Up @@ -477,4 +477,6 @@ javascript: (async function gpa() {
});
}

})();
}

main();
Loading

0 comments on commit 58a37e6

Please sign in to comment.