|
# Accordion Stories
|
|
|
|
Create narrative content with expandable sections that can include maps, datasets, and rich text.
|
|
|
|
## Overview
|
|
|
|
Accordion Stories provide a storytelling interface with expandable sections. Each section can contain rich HTML content, embedded maps, and linked datasets, making them ideal for creating interactive narratives and guided explorations.
|
|
|
|
## Creating Accordion Stories
|
|
|
|
### Access
|
|
|
|
- Navigate to Accordion Stories (`accordion_stories.php`)
|
|
- Publishers and admins can create stories
|
|
- Users can view stories they have access to
|
|
|
|
### Story Structure
|
|
|
|
Stories consist of:
|
|
- **Title**: Story title
|
|
- **Description**: Story description
|
|
- **Sections**: Multiple expandable sections
|
|
- **Category**: Optional categorization
|
|
- **Permissions**: Access control settings
|
|
|
|
## Sections
|
|
|
|
### Section Content
|
|
|
|
Each section can contain:
|
|
|
|
- **Title**: Section heading
|
|
- **HTML Content**: Rich text with formatting
|
|
- **Dataset Link**: Optional dataset association
|
|
- **Maps**: Embedded map displays
|
|
- **Media**: Images and other media
|
|
|
|
### Section Features
|
|
|
|
- **Expandable**: Click to expand/collapse
|
|
- **Rich Text**: HTML formatting support
|
|
- **Dataset Integration**: Link to datasets
|
|
- **Map Integration**: Display maps in sections
|
|
- **Ordering**: Custom section order
|
|
|
|
## Building Stories
|
|
|
|
### Step 1: Create Story
|
|
|
|
1. Navigate to Accordion Stories
|
|
2. Click "New Story"
|
|
3. Enter title and description
|
|
4. Select category (optional)
|
|
5. Set permissions
|
|
|
|
### Step 2: Add Sections
|
|
|
|
1. Open story builder
|
|
2. Add new section
|
|
3. Enter section title
|
|
4. Add HTML content
|
|
5. Optionally link dataset
|
|
6. Save section
|
|
|
|
### Step 3: Configure Content
|
|
|
|
1. Use rich text editor for content
|
|
2. Format text with HTML
|
|
3. Add images and media
|
|
4. Link to datasets
|
|
5. Embed maps if needed
|
|
|
|
### Step 4: Arrange Sections
|
|
|
|
1. Reorder sections by dragging
|
|
2. Set default expanded section
|
|
3. Organize narrative flow
|
|
4. Save story
|
|
|
|
## Content Editor
|
|
|
|
### Rich Text Editing
|
|
|
|
- **Formatting**: Bold, italic, underline
|
|
- **Headings**: Multiple heading levels
|
|
- **Lists**: Ordered and unordered lists
|
|
- **Links**: Hyperlinks to external content
|
|
- **Images**: Image embedding
|
|
- **Tables**: Table creation
|
|
|
|
### HTML Support
|
|
|
|
- Direct HTML editing
|
|
- Custom styling
|
|
- Embedded content
|
|
- Script integration (if allowed)
|
|
|
|
## Dataset Integration
|
|
|
|
### Linking Datasets
|
|
|
|
- **Dataset Selection**: Choose dataset to link
|
|
- **Automatic Display**: Map automatically displays linked dataset
|
|
- **Synchronization**: Section expansion shows linked data
|
|
- **Filtering**: Apply filters to linked datasets
|
|
|
|
### Map Display
|
|
|
|
When a section has a linked dataset:
|
|
- Map automatically displays dataset
|
|
- Section expansion shows map
|
|
- Map updates with section changes
|
|
- Interactive map features available
|
|
|
|
## Viewing Stories
|
|
|
|
### Story Viewer
|
|
|
|
- **Left Panel**: Accordion sections
|
|
- **Right Panel**: Map display (if dataset linked)
|
|
- **Navigation**: Expand/collapse sections
|
|
- **Responsive**: Mobile-friendly layout
|
|
|
|
### Interaction
|
|
|
|
- **Expand Sections**: Click to expand
|
|
- **Collapse Sections**: Click to collapse
|
|
- **Map Interaction**: Pan, zoom, query
|
|
- **Content Scrolling**: Scroll through content
|
|
|
|
## Use Cases
|
|
|
|
### Guided Tours
|
|
|
|
- Location-based tours
|
|
- Historical narratives
|
|
- Educational content
|
|
- Story maps
|
|
|
|
### Data Narratives
|
|
|
|
- Data exploration guides
|
|
- Analysis walkthroughs
|
|
- Results presentations
|
|
- Research stories
|
|
|
|
### Documentation
|
|
|
|
- Feature documentation
|
|
- User guides
|
|
- Tutorial content
|
|
- Help systems
|
|
|
|
### Presentations
|
|
|
|
- Interactive presentations
|
|
- Conference materials
|
|
- Public engagement
|
|
- Stakeholder reports
|
|
|
|
## Permissions
|
|
|
|
### Access Control
|
|
|
|
- **Public**: Accessible to all users
|
|
- **Private**: Creator only
|
|
- **Group-based**: Shared with user groups
|
|
- **Custom**: Specific user permissions
|
|
|
|
### Editing Permissions
|
|
|
|
- **Creator**: Can edit their stories
|
|
- **Admins**: Can edit all stories
|
|
- **Publishers**: Can create and edit stories
|
|
- **Users**: Can view accessible stories
|
|
|
|
## Story Management
|
|
|
|
### Editing
|
|
|
|
- Edit story metadata
|
|
- Modify sections
|
|
- Update content
|
|
- Reorder sections
|
|
- Change permissions
|
|
|
|
### Sharing
|
|
|
|
- Share via URL
|
|
- Set public/private status
|
|
- Configure group access
|
|
- Embed in other pages
|
|
|
|
### Organization
|
|
|
|
- Categorize stories
|
|
- Tag stories
|
|
- Search stories
|
|
- Filter by category
|
|
|
|
## Example Story
|
|
|
|
A typical accordion story might include:
|
|
|
|
1. **Introduction Section**: Overview and context
|
|
2. **Data Section**: Dataset description with linked map
|
|
3. **Analysis Section**: Analysis results and findings
|
|
4. **Conclusion Section**: Summary and next steps
|
|
|
|
Each section expands to reveal content and updates the map display.
|
|
|
|
## Best Practices
|
|
|
|
### Content
|
|
|
|
- Write clear, engaging content
|
|
- Use appropriate section titles
|
|
- Organize content logically
|
|
- Include visual elements
|
|
|
|
### Maps
|
|
|
|
- Link relevant datasets
|
|
- Use appropriate basemaps
|
|
- Configure map styling
|
|
- Test map interactions
|
|
|
|
### Navigation
|
|
|
|
- Set logical section order
|
|
- Use descriptive titles
|
|
- Provide clear navigation
|
|
- Test user experience
|
|
|
|
## Related Documentation
|
|
|
|
- [Dashboard](dashboard.md)
|
|
- [Web Apps](web-apps.md)
|
|
- [Dataset Viewer](../ui/dataset-viewer.md)
|
|
- [Map Viewer](../ui/map-viewer.md)
|
|
|