# Userscripts for PVO

## Hướng dẫn cài đặt
- Bước 1: Vào https://addons.mozilla.org/en-US/firefox/addon/tampermonkey/ để cài Tampermonkey vào trình duyệt Firefox, hoặc vào https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo?hl=en để cài đặt Tampermonkey vào trình duyệt Chrome
- Bước 2: Nhấn vào biểu tượng , sau đó nhấn Create a new script
- Bước 3: Chép đoạn mã của tính năng bạn muốn vào cửa sổ, sau đó nhấn Ctrl+S, hoặc File -> Save
- Tính năng tự động điền định nghĩa của từ điển Wordnet cho Concept, điền đoạn mã sau: https://pastebin.com/raw/MQ3S7hjz
- Tính năng mở từ điển Cambridge để tra định nghĩa Concept, điền đoạn mã sau: https://pastebin.com/raw/KPtUU9Sm
- Tính năng mở từ điển Merriam-Webster để tra định nghĩa Concept, điền đoạn mã sau: https://pastebin.com/raw/m9VvL0fg
- Tính năng chèn ảnh, video vào Example, điền đoạn mã sau: https://pastebin.com/raw/9Jb69hq9
- Nếu bạn muốn nhiều hơn một tính năng, lặp lại quy trình từ bước 2

## Hướng dẫn sử dụng các tính năng
### Tính năng tự động điền định nghĩa
- Sau khi cài đặt thành công, màn hình Concept của bạn sẽ có thêm nút Define trông giống như dưới đây
- Gõ tên Concept vào ô Enter new concept, sau đó nhấn Define. Định nghĩa của concept sẽ được điền vào Enter concept definition
- Nếu từ có nhiều nghĩa và nghĩa được điền không phải nghĩa bạn muốn, bạn có thể nhấn Define tiếp để lấy định nghĩa khác
- Nếu định nghĩa của từ không thay đổi thì nghĩa là từ chỉ có một nghĩa duy nhất trong từ điển Wordnet.
### Tính năng mở từ điển
- Sau khi cài đặt thành công, màn hình Concept của bạn sẽ có thêm nút Cambridge / Merriam-Webster như dưới đây:
- Gõ tên Concept vào ô Enter new concept, sau đó nhấn Cambridge. Trang từ điển tương ứng với concept sẽ được mở.
- Trong trường hợp trang từ điển không được mở, có thể trình duyệt web đã chặn pop-up từ trang vupvo.org. Bạn cần đồng ý cho phép trang tạo pop-up.
- Đọc trang từ điển và chép định nghĩa bạn muốn vào PVO.
### Tính năng chèn ảnh / video vào Example
Lưu ý: Tính năng chưa hoạt động ổn định và có thể làm ảnh hưởng kết quả tìm kiếm trong PVO. **Use at your own risk**
- Sau khi cài đặt thành công, màn hình Example sẽ trông giống như hình dưới đây (có thêm ô Media và nút Add Media)
- Nhập các thông tin của Example.
- Chèn video / hình ảnh bằng một trong hai cách sau:
- Cách 1: Điền mã `iframe` đối với video hoặc mã `img` đối với ảnh vào ô Media, rồi nhấn Add Media. Video sẽ ngay lập tức được chèn vào ô nhập Example.
- Để lấy mã iframe của một video YouTube, bạn có thể vào video đó, nhấn Chia sẻ, chọn Nhúng/Embed, rồi chép đoạn mã vào ô Media.
- Kết quả sau khi nhấn Add Media
- Tuy hơi nhỏ nhưng bạn có thể cho nhấn vào nút Xem toàn màn hình của YouTube để xem rõ hơn.
- **Lưu ý một khi đã chèn ảnh/video vào một example theo cách này, mọi chỉnh sửa khác ở ô Example thường sẽ không được PVO ghi nhận.** (Các bạn vẫn có thể sửa Tone, Mode, Register, thay đổi mối quan hệ, nhưng nếu example có chỗ sai chính tả bạn sẽ không sửa được). Cách chỉnh sửa duy nhất là xóa example đó và tạo example mới.
- Cách 2: Điền link YouTube hoặc Google Drive vào ô Notes. Ở lần tiếp theo mở lại Example, bạn sẽ thấy video được chèn vào phần phía dưới của phần Media.
- Link YouTube cần có dạng `https://www.youtube.com/watch?v=2aMoScImtYg` còn link Google Drive cần có dạng `https://drive.google.com/file/d/1KyCKiTcIu2tGRQ-8BfKK3RuxcoW1U0LF/view`. Video Google Drive cần có kích thước nhỏ hơn 100 MB (khoảng 7 phút với chất lượng video HD)
- Bạn vẫn có thể điền các thông tin khác ở phần Notes mà không làm ảnh hưởng tới video trong hầu hết trường hợp.

## Hướng dẫn gỡ tính năng
- Bạn có thể nhấn vào biểu tượng , rồi nhấn vào biểu tượng bật/tắt để làm một tính năng nào đó ngừng hoạt động
- Bạn cũng có thể gỡ bở Tampermonkey như bất cứ extension / add-on nào khác của trình duyệt.