Advanced Story Features

Plugin documentation for installation, usage, uninstallation, and troubleshooting.

Slug: advanced-story-features Version: 1.0.0 Author: Arman Sen

Introduction

Advanced Story Features upgrades the Sngine story experience with modern interactions and creator tools without modifying core files.

The plugin works using hooks, JavaScript/CSS injection, AJAX endpoints, and plugin-managed database tables.

Features

1. Story views tracking with owner viewer list.
2. Emoji reactions with one reaction per user per story media.
3. Story replies integrated with private messages (DM style).
4. Story highlights with albums, grouping, and custom cover selection.
5. Configurable story expiry (admin default and optional user selection).
6. Background music support using admin music library.
7. Optional user music upload (admin-controlled).
8. Music trim support (start/end seconds).
9. Unified media upload for photo/video in story publisher.
10. Photo/video editing workflow before publish (crop, text, filters, draw, emoji, undo/redo).
11. Highlight preview with previous/next navigation and media playback.
12. Profile avatar story ring and avatar click menu: See Profile Picture / See Story.

How to Install

1. Make sure plugin path exists: content/plugins/advanced-story-features.
2. Open /admincp/plugins.
3. Find Advanced Story Features and click Install.
4. Click Enable.
5. Open plugin settings and save your expiry/music preferences.

How to Use

• Open story publisher and upload photo/video from unified media section.
• Optionally set expiry and choose music from library.
• Publish story and test viewer actions: seen count, reactions, reply, highlight.
• Create highlight albums and add stories to specific albums.
• Open profile highlights to preview media in story-style modal.
• In admin panel, upload/manage music tracks and categories.

How to Uninstall

1. Go to /admincp/plugins.
2. Disable Advanced Story Features.
3. Click Uninstall.
4. Remove plugin folder only after uninstall is completed if full removal is required.

FAQs

Q: Stories are not showing enhanced UI. Why?

A: Hard refresh with Ctrl+F5 to load latest plugin assets, then test again.

Q: Music picker opens but no tracks are listed.

A: Enable music feature in plugin settings and upload tracks from admin music library.

Q: Highlight media opens but does not load correctly.

A: Recheck highlight mapping and media source validity, then hard refresh browser cache.

Q: Can users upload their own music?

A: Yes, only when Show custom music upload option to users is enabled by admin.

Q: Does this plugin modify Sngine core files?

A: No. It is implemented via plugin hooks, injected assets, AJAX, and separate plugin tables.