Articles & Newsletters

​

Overview

The Maths Society Platform provides two types of content to keep students informed and engaged: Articles and Newsletters. Both are managed through a unified content system but serve different purposes.

​

Content Types

​

Articles

​

What Are Articles?

Articles are educational content pieces that:

• Explore mathematical concepts in depth
• Provide problem-solving strategies
• Feature student achievements
• Discuss mathematical topics beyond the curriculum
• Offer study tips and exam guidance

​

Article Structure

Each article includes:

​

Browsing Articles

The Articles page displays:

• All articles sorted by most recent first
• Article titles and publication dates
• Preview of content or excerpt
• Author information

​

Reading Articles

Click on any article to:

1. View the full content
2. See detailed author information
3. Access any attached PDF files
4. Read the complete publication date and time

​

Newsletters

​

What Are Newsletters?

Newsletters are periodic publications containing:

• Platform updates and announcements
• Competition results and highlights
• Upcoming events and important dates
• Featured challenges and solutions
• Community news and student spotlights

​

Newsletter Features

​

Accessing Newsletters

​

Newsletter List Page

The Newsletters page shows:

• All newsletters in reverse chronological order (newest first)
• Newsletter titles and publication dates
• Quick links to view each newsletter

​

Individual Newsletter View

Each newsletter displays:

• Full title
• Publication date
• Text content summary
• Download link for PDF version

​

Homepage Display

The homepage features:

• Latest Newsletter: Most recent newsletter automatically displayed
• Direct link to view full content
• Quick access to newsletter archive

​

Content Management System

​

Database Structure

Both articles and newsletters are stored in the same Article model with a type field:

• type = “article”: Regular educational articles
• type = “newsletter”: Newsletter publications

This unified structure allows:

• Consistent content management
• Shared search and filtering
• Efficient database queries

​

Fields Tracked

​

Homepage Integration

​

Recent Articles

The homepage displays:

• 3 most recent articles
• Quick preview to drive engagement
• Links to full article pages

​

Latest Newsletter

Homepage features:

• Single latest newsletter in dedicated section
• Prominent placement for visibility
• Direct link to full newsletter content

This ensures students always see fresh content when they log in.

​

Navigation and Discovery

​

Main Navigation

Access content through:

• Articles Link: Browse all educational articles
• Newsletters Link: View newsletter archive
• Homepage: See latest of both types

​

Content Filtering

The platform automatically:

• Separates articles from newsletters in listings
• Prevents newsletters from appearing in article browsing (and vice versa)
• Returns 404 errors if you try to view an article as a newsletter or vice versa

​

PDF File Management

​

Newsletter PDFs

Newsletters use a dedicated file system:

• Stored in uploads/newsletters/ directory
• Served through secure file delivery route
• Filename tracked in database
• Download links generated dynamically

​

Article PDFs

Articles can also include PDF attachments:

• Optional supplementary materials
• Diagrams, worksheets, or extended content
• Referenced via file_url field

​

Author Attribution

​

User-Based Attribution

Content is linked to the administrator who posted it via user_id, establishing:

• Accountability for published content
• Relationship between users and their articles
• Query capabilities for finding content by author

​

Named Creator Field

The optional named_creator field allows:

• Crediting external contributors
• Featuring student authors
• Recognizing guest writers
• Providing additional attribution context

This supports collaborative content while maintaining administrative control.

​

Content Lifecycle

​

Best Practices for Users

​

Integration with Other Features

​

Announcements

While separate from articles and newsletters, announcements also appear on the homepage:

• Latest Announcement: Urgent or timely information
• Separate database model for different use case
• Complementary to newsletter content

​

Challenge Context

Articles may reference or explain:

• Challenge-solving techniques
• Mathematical concepts used in challenges
• Competition results and highlights

This creates a rich learning ecosystem around the challenge system.

​

Next Steps