AhoMINNA - Japanese Learning Plugin for WordPress

A comprehensive WordPress plugin for teaching Japanese with Minna no Nihongo textbook (50 lessons) designed specifically for Vietnamese learners.

• Vocabulary (Từ vựng): Interactive flashcard system with flip animations
• Grammar (Ngữ pháp): Structured grammar patterns with Vietnamese explanations
• Dialogue (Hội thoại): Conversation practice with audio and video support
• Quiz (Trắc nghiệm): Multiple-choice quizzes with instant feedback

• 🎴 Flashcard System: Learn and review mode with swipe/click navigation
• 🎵 Audio Support: Japanese pronunciation for vocabulary and dialogues
• 🎥 Video Integration: YouTube embed or direct video upload
• 📊 Progress Tracking: Save user progress for each lesson section
• 🎯 Quiz System: Track scores and review answers with explanations
• 📱 Responsive Design: Optimized for desktop, tablet, and mobile
• 🖥️ Fullscreen Mode: Presentation-ready with keyboard shortcuts
• 🌐 Bilingual: Japanese-Vietnamese interface

• Custom post types for lessons, vocabulary, grammar, dialogues, and quizzes
• Bulk import from CSV for vocabulary and quiz questions
• Visual dashboard with statistics
• Easy content management with custom meta boxes
• Settings page for plugin configuration

1. Upload the ahominna folder to /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Navigate to AhoMINNA in the admin menu
4. Start creating lessons!

• WordPress 5.0 or higher
• PHP 7.4 or higher
• Modern web browser with JavaScript enabled

1. Go to AhoMINNA > Add New Lesson
2. Enter lesson title, number, and description
3. Create vocabulary, grammar, dialogues, and quizzes
4. Link them to the lesson using IDs

1. Go to AhoMINNA > Import
2. Select import type (Vocabulary or Quiz)
3. Choose CSV file with correct format
4. Upload and import

kanji,hiragana,romaji,vietnamese,image_url,audio_url
学生,がくせい,gakusei,học sinh,https://example.com/image.jpg,https://example.com/audio.mp3

question,type,option_a,option_b,option_c,option_d,correct_index,explanation,audio_url
Question text,vocabulary,Option A,Option B,Option C,Option D,0,Explanation here,

Display lessons on any page or post:

[ahominna_lessons]

Display a specific lesson:

[ahominna_lesson id="1"]

Display vocabulary flashcards:

[ahominna_vocabulary lesson="1"]

Display quiz:

[ahominna_quiz lesson="1"]

Override styles by adding custom CSS in your theme:

.ahominna-lesson-container {
    /* Your custom styles */
}

Edit /public/css/style.css to change the color variables:

:root {
    --primary-color: #e74c3c;
    --secondary-color: #3498db;
    --accent-color: #f39c12;
}

• ← Previous card
• → Next card
• Space Flip card

• ← Previous question
• → Next question
• Enter Submit quiz

• Esc Exit fullscreen
• Shift + ← Previous section
• Shift + → Next section

The plugin is fully responsive and optimized for:

• Desktop (1200px+)
• Tablet (768px - 1199px)
• Mobile (< 768px)
• Landscape mode

• ahominna_lesson - Lessons
• ahominna_vocabulary - Vocabulary items
• ahominna_grammar - Grammar patterns
• ahominna_dialogue - Conversation dialogues
• ahominna_quiz - Quiz questions

• {prefix}_ahominna_progress - User progress tracking
• {prefix}_ahominna_quiz_results - Quiz results

• ahominna_save_progress - Save learning progress
• ahominna_submit_quiz - Submit quiz answers
• ahominna_get_vocabulary - Fetch vocabulary data

The plugin is translation-ready. Translation files are located in /languages/ directory.

Current languages:

• English (default)
• Vietnamese (vi)

Contributions are welcome! Please feel free to submit a Pull Request.

This plugin is licensed under the GPL v2 or later.

DatNong

• GitHub: @datnong1210-arch

For support, please open an issue on the GitHub repository.

• Mobile app integration
• Additional quiz types (fill-in-the-blank, matching)
• Gamification features (badges, streaks)
• Social sharing
• Export progress reports
• Lesson completion certificates

Screenshots will be available in the /assets/ directory.

• Lazy loading for images
• Optimized CSS and JavaScript
• Minimal database queries
• Caching support

• CSRF protection with nonces
• Input sanitization and validation
• Prepared SQL statements
• Capability checks for admin functions

For detailed documentation, visit the Wiki.

Made with ❤️ for Japanese language learners in Vietnam