WP Manifestindependent plugin directory
manifest / social / koopo-plugin

Koopo

koopo wordpress plugin

by Plu2oprinze · github.com/prinze-amir/koopo-plugin · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/prinze-amir/koopo-plugin/archive/refs/heads/main.zip
Readme github.com/prinze-amir/koopo-plugin ↗

Koopo Stories: 17-Phase Development Roadmap

Here is the official project roadmap for the Stories feature, aligned to commits and enhanced with social engagement features.

📊 Current Status

Phase Status Completion
Phase 0-8 ✅ Complete 100%
Phase 9-10 ✅ Complete 100%
Phase 11 ✅ Complete 100%
Phase 12 ✅ Complete 100%
Phase 13 ✅ Complete 100%
Phase 14-17 🔄 Planned 0%

Overall Progress: 76% (13/17 phases complete)

Latest Commit: 009 - Phase 11 Complete (Interactive Features)

Next Up: Phase 14 - Performance & Optimization

Phase 0 – Foundation & Stability ✅ COMPLETE

  1. Plugin bootstrap stability
  2. Admin menu architecture
  3. Widget rendering correctness
  4. Load order safety
  5. No stray output / fatals

👉 Commits: 001–003 ✅ Almost complete

Phase 1 – Stories Core Data Model ✅ COMPLETE

  1. Story CPT (koopo_story)
  2. Story Item CPT (koopo_story_item)
  3. Meta schema + expiration model
  4. Ownership + permissions rules

👉 Commits: 001–003 ✅ All CPTs, meta, and permissions implemented

Phase 2 – Seen / View Tracking ✅ COMPLETE

  1. Custom DB table (story_views)
  2. Insert + lookup logic
  3. Unseen detection logic

👉 Commits: 001–003 ✅ Custom table with view tracking complete

Phase 3 – REST API (API-First) ✅ COMPLETE

  1. Feed endpoint
  2. Story detail endpoint
  3. Seen endpoint
  4. Upload endpoint
  5. Permission callbacks

👉 Commits: 001–003 ✅ All 4 REST endpoints implemented

Phase 4 – Web UI: Stories Tray ✅ COMPLETE

  1. Tray renderer
  2. Unseen ring logic
  3. Ordering (unseen / recent)
  4. Widget + shortcode integration

👉 Commits: 001–003 ✅ Tray, widget, and shortcode complete

Phase 5 – Web UI: Viewer ✅ COMPLETE

  1. Fullscreen modal
  2. Progress bars
  3. Tap / swipe navigation
  4. Autoplay rules

👉 Commits: 001–003 ✅ Fullscreen viewer with navigation complete

Phase 6 – Uploader UX ✅ COMPLETE

  1. Preview before upload
  2. Rate limiting
  3. Validation
  4. Error handling

👉 Commits: 001–003 ✅ Upload composer with preview complete

Phase 7 – Cleanup & Expiration ✅ COMPLETE

  1. Cron cleanup
  2. Manual admin cleanup
  3. Orphan detection

👉 Commits: 001–003 ✅ Automated cron cleanup implemented

Phase 8 – Widget Enhancements ✅ COMPLETE

  1. Layout modes
  2. Per-widget overrides
  3. Sidebar UX polish

👉 Commits: 001–003 ✅ Horizontal/vertical layouts complete

Phase 9 – User Privacy & Granular Controls ✅ COMPLETE

  1. Per-story privacy settings (public, friends only, close friends) ✅
  2. Story archive (save stories beyond 24h for logged-in user) ⏸️ Deferred
  3. Hide story from specific users ⏸️ Deferred
  4. Close friends list integration ✅

👉 Commit: 005 ✅ Privacy controls implemented

  • Privacy selector in upload UI (3 levels: public, friends, close friends)
  • Database-backed close friends lists
  • Privacy-aware permissions system
  • REST API for close friends management
  • User-facing close friends manager UI (shortcode)
  • Privacy indicators on story bubbles

Phase 10 – Engagement: Reactions & Replies ✅ COMPLETE

  1. Like/reaction system (emoji picker) ✅
  2. Story replies (DM or comment system) ✅
  3. Reaction counts display ✅
  4. Reply notifications (BuddyBoss notifications integration) ✅

👉 Commits: 005, 006 ✅ Full engagement implementation (backend + frontend)

  • Reactions database with 7 emoji types
  • Replies database with DM/public modes
  • 6 REST API endpoints for reactions & replies
  • BuddyBoss notifications integration
  • Privacy-aware reply visibility
  • Frontend UI: Emoji picker modal, reply textarea modal
  • UX: Reaction and reply buttons in story viewer
  • Buttons hidden for own stories

Phase 11 – Interactive Features ✅ COMPLETE

  1. ✅ Stickers database with position tracking
  2. ✅ Mention sticker (@username validation)
  3. ✅ Link sticker (URL + title)
  4. ✅ Location sticker (name, coordinates, address)
  5. ✅ Poll sticker (question + up to 4 options)
  6. ✅ Poll voting system with real-time counts
  7. ✅ REST API endpoints for sticker CRUD
  8. ✅ Sticker UI in story composer
  9. ✅ Sticker display in story viewer
  10. ✅ @mention autocomplete with BuddyBoss integration

👉 Commits: 008-009 ✅ Full implementation complete

Backend:

  • koopo_story_stickers table with position tracking
  • koopo_story_poll_votes table for voting
  • Support for 4 sticker types: mention, link, location, poll
  • REST endpoints: add sticker, delete sticker, vote on poll
  • Type-specific validation and sanitization

Frontend:

  • Sticker toolbar in story composer with 4 sticker buttons
  • Modal forms for adding each sticker type
  • Draggable sticker positioning in composer preview
  • Real-time sticker rendering in story viewer
  • Interactive poll voting with live vote counts
  • @mention autocomplete with avatar suggestions from BuddyBoss
  • Click handlers: profile links for mentions, external links, Google Maps for locations

Phase 12 – Analytics & Insights ✅ COMPLETE

  1. View counts per story ✅
  2. Viewer list ("Seen by" feature) ✅
  3. Per-user "seen" state tracking ✅
  4. Story insights dashboard (who viewed, when) ✅

👉 Commit: 006 ✅ Full analytics implementation

  • View counts integrated in get_story endpoint
  • /stories/{id}/viewers REST endpoint for viewer list
  • /stories/{id}/analytics REST endpoint for comprehensive insights
  • Viewer list UI modal with avatars and timestamps
  • View count badge in story viewer (author-only)
  • Analytics include views, reactions, and replies
  • Privacy-aware (only story author can see analytics)

Phase 13 – Moderation ✅ COMPLETE

  1. Reporting ✅
  2. Admin review dashboard ✅
  3. Auto-hide thresholds ✅
  4. Flagged content queue ✅

👉 Commit: 007 ✅ Full moderation system implemented

  • Reports database with status tracking
  • User reporting UI with 7 report reasons
  • ⚠ Report button in story viewer
  • REST API for reporting and moderation
  • Admin moderation dashboard with stats
  • Auto-hide stories after threshold (configurable, default: 5)
  • Dismiss or delete reported stories
  • Audit trail with reviewer tracking
  • Can't report own stories
  • One report per user per story

Phase 14 – Performance

  1. Caching (transients for feeds)
  2. Query optimization
  3. Lazy loading for media
  4. CDN integration for attachments

👉 Commit: 032

Phase 15 – React Native Readiness

  1. Auth abstraction
  2. Mobile-friendly payloads
  3. API versioning
  4. Push notification hooks

👉 Commit: 033

Phase 16 – Final Polish

  1. Accessibility (ARIA labels, keyboard nav)
  2. Animations & transitions
  3. Edge cases & error handling
  4. Internationalization (i18n)

👉 Commit: 034

Phase 17 – Hardening & Release

  1. Security review
  2. Back-compat testing
  3. Release notes
  4. Documentation

👉 Commit: 035 (v1.0)

Process change (important)

Starting Commit 004, every commit will include:

  • ✅ Phase number(s) in the commit notes
  • ✅ Which checklist items were completed
  • ✅ Which phase is next

Example:

Commit 004: Phase 0 enhancements
- Added BuddyBoss profile URL linking
- Fixed current user avatar display
Phase 0 complete, moving to Phase 9

📋 Feature Comparison: Planned vs. Industry Standard

Feature Instagram Facebook Koopo Stories (Planned)
Core Features
24h auto-expire ✅ ✅ ✅ Complete
Image/Video upload ✅ ✅ ✅ Complete
Fullscreen viewer ✅ ✅ ✅ Complete
Progress bars ✅ ✅ ✅ Complete
Privacy
Public/Friends toggle ✅ ✅ ✅ Complete
Close friends list ✅ ✅ ✅ Complete
Hide from specific users ✅ ✅ ⏸️ Deferred
Story archive ✅ ✅ ⏸️ Deferred
Engagement
Reactions/Likes ✅ ✅ ✅ Complete
DM replies ✅ ✅ ✅ Complete
View counts ✅ ✅ ✅ Complete
Viewer list ✅ ✅ ✅ Complete
Interactive
Mentions ✅ ✅ 🔄 Phase 11
Link stickers ✅ ✅ 🔄 Phase 11
Location tags ✅ ✅ 🔄 Phase 11
Polls ✅ ✅ 🔄 Phase 11
Platform
Web support ✅ ✅ ✅ Complete
Mobile app API ✅ ✅ 🔄 Phase 15
Push notifications ✅ ✅ 🔄 Phase 15

🎯 Development Priorities

Immediate (Next 2 weeks)

  1. Phase 9: Privacy controls (essential for user trust)
  2. Phase 10: Reactions & replies (drives engagement)

Short-term (1 month)

  1. Phase 12: Analytics/insights (user value)
  2. Phase 13: Moderation tools (platform safety)

Medium-term (2-3 months)

  1. Phase 11: Interactive stickers
  2. Phase 14: Performance optimization
  3. Phase 15: Mobile API readiness

Long-term (3+ months)

  1. Phase 16: Polish & accessibility
  2. Phase 17: Security audit & v1.0 release

📝 Notes

  • Privacy features (Phase 9) are critical before public launch
  • Engagement features (Phase 10) should come before analytics
  • Performance optimization (Phase 14) can run parallel with feature development
  • All phases maintain backward compatibility with existing stories