Getting Started

To use the Flash Card Application:

1. Access the Application: Open the page on your WordPress site where the Flash Card Application is hosted.
2. User Interface Overview: The interface has sections for adding, editing, and viewing flashcards.

Adding New Flashcards

Create new flashcards with the following steps:

1. Enter Front Text: Type the text for the front of the card in the Enter text for the front input box.
2. Upload Front Image (Optional): Use the Choose File button to upload an image for the front of the card. This step is optional.
3. Enter Back Text: Type the text for the back of the card in the Enter text for the back input box.
4. Upload Back Image (Optional): Use the Choose File button to upload an image for the back of the card. This step is optional.
5. Add the Card: Click the Add Card button to add your flashcard to the deck. A random flashcard will be displayed on the screen.

Viewing and Flipping Flashcards

To view and flip flashcards:

1. View Flashcard: The current flashcard is shown with the front side visible by default.
2. Flip Flashcard: Click on the card to flip it and view the back side. Click again to return to the front.

Editing Flashcards

To edit existing flashcards:

1. Open Edit Mode: Click the ✏️ button on the flashcard you want to edit. The Edit Card section will appear.
2. Edit Text and Images: Modify the text and upload new images if needed in the Edit text for the front and Edit text for the back input boxes.
3. Save Changes: Click the Save Changes button to update the flashcard.
4. Cancel Editing: Click the Cancel button to exit edit mode without saving changes.

Rating Flashcards

Rate flashcards based on your confidence:

1. Good: Click the Good button (green) if confident about the flashcard's content. This increases the card's success score.
2. Bad: Click the Bad button (red) if you find the flashcard challenging. This decreases the card's success score, making it appear more frequently for review.
3. Skip: Click the Skip button (gray) to view another random flashcard without affecting its score.

Deleting Flashcards

To remove a flashcard:

1. Remove a Flashcard: Click the ❌ button on the flashcard. It will be permanently deleted from your deck, and a new flashcard will be shown if any are left.

Managing Flashcards

Manage your flashcard deck with these features:

1. Deck Size: Each flashcard shows the total number of cards in the deck in the bottom right corner, helping you track your progress.
2. Random Selection: Flashcards are shown randomly, with those having lower success values appearing more frequently. This weighted randomization helps you focus on the flashcards you struggle with the most.
3. Save and Load: Flashcards are automatically saved to your user account. When you revisit the application, your flashcards will be loaded, allowing you to continue seamlessly.

How the Flash Card Application Decides the Next Card

The system uses a weighted randomization algorithm to select the next flashcard:

1. Success Score: Each flashcard has a success score that changes based on your ratings. Cards with lower scores appear more frequently to help you review challenging content.
2. Weighted Probability: The probability of a card appearing is inversely proportional to its success score. This means the lower the score, the higher the chance it will be shown next.
3. Random Selection: The system calculates a weighted random selection, ensuring a mix of cards with varying difficulty levels, but prioritizing those that need more review.

Troubleshooting

Common issues and solutions:

1. Cannot Add Flashcards: Ensure text is entered for at least the front side or an image is uploaded. Verify your internet connection.
2. Flashcards Not Loading: Refresh the page and ensure you are logged into your account.
3. Edit Mode Issues: Ensure you click Save Changes after editing. Verify that the image files are in supported formats (JPG, PNG).
4. Deleting Flashcards: Confirm deletion as it is irreversible.
5. General Issues: Check for JavaScript errors in the browser console and ensure the REST API endpoint is accessible and functioning correctly.