Adds a mention to a post.

Adds a post to a group.

Adds multiple posts to a group in a single transaction.

Adds tags to a post.

Creates tags if they don't exist, then assigns them to the post. Updates usage counters for tags.

Attaches media to a post.

Counts posts matching the given filter options.

Accepts the same filter options as list_posts/1 (:user_uuid, :status, :type, :search) but ignores pagination options.

Creates a user group.

Creates a new post.

Parameters

• user_uuid - Owner UUID (UUIDv7 string)
• attrs - Post attributes (title, content, type, status, etc.)

Examples

iex> create_post("019145a1-...", %{title: "Test", content: "Content", type: "post"})
{:ok, %Post{}}

iex> create_post("019145a1-...", %{title: "", content: ""})
{:error, %Ecto.Changeset{}}

Decrements the comment counter for a post.

Examples

iex> decrement_comment_count(post)
{1, nil}

Decrements the dislike counter for a post.

Examples

iex> decrement_dislike_count(post)
{1, nil}

Decrements the like counter for a post.

Examples

iex> decrement_like_count(post)
{1, nil}

Deletes a group.

Deletes a post and all related data (cascades to media, likes, comments, etc.).

Parameters

• post - Post struct to delete

Examples

iex> delete_post(post)
{:ok, %Post{}}

iex> delete_post(post)
{:error, %Ecto.Changeset{}}

Detaches media from a post.

Detaches media from a post by PostMedia ID.

Disables the Posts module.

Examples

iex> disable_system()
{:ok, %Setting{}}

User dislikes a post.

Reverts a post to draft status.

Examples

iex> draft_post(post)
{:ok, %Post{status: "draft"}}

Enables the Posts module.

Examples

iex> enable_system()
{:ok, %Setting{}}

Checks if the Posts module is enabled.

Examples

iex> enabled?()
true

Finds or creates a tag by name.

Automatically generates slug from name. Returns existing tag if slug already exists.

Gets the current Posts module configuration and stats.

Examples

iex> get_config()
%{enabled: true, total_posts: 42, published_posts: 30, ...}

Gets the featured image for a post (PostMedia with position 1).

Gets a single group by ID with optional preloads.

Returns nil if group not found.

Gets a single group by ID with optional preloads.

Raises Ecto.NoResultsError if group not found.

Gets a single post by ID with optional preloads.

Returns nil if post not found.

Parameters

• id - Post ID (UUIDv7)
• opts - Options
  • :preload - List of associations to preload

Examples

iex> get_post("018e3c4a-...")
%Post{}

iex> get_post("018e3c4a-...", preload: [:user, :media, :tags])
%Post{user: %User{}, media: [...], tags: [...]}

iex> get_post("nonexistent")
nil

Gets a single post by ID with optional preloads.

Raises Ecto.NoResultsError if post not found.

Parameters

• id - Post ID (UUIDv7)
• opts - Options
  • :preload - List of associations to preload

Examples

iex> get_post!("018e3c4a-...")
%Post{}

iex> get_post!("018e3c4a-...", preload: [:user, :media, :tags])
%Post{user: %User{}, media: [...], tags: [...]}

iex> get_post!("nonexistent")
** (Ecto.NoResultsError)

Gets a single post by slug.

Parameters

• slug - Post slug (e.g., "my-first-post")
• opts - Options
  • :preload - List of associations to preload

Examples

iex> get_post_by_slug("my-first-post")
%Post{}

iex> get_post_by_slug("nonexistent")
nil

Increments the comment counter for a post.

Examples

iex> increment_comment_count(post)
{1, nil}

Increments the dislike counter for a post.

Examples

iex> increment_dislike_count(post)
{1, nil}

Increments the like counter for a post.

Examples

iex> increment_like_count(post)
{1, nil}

Increments the view counter for a post.

Examples

iex> increment_view_count(post)
{1, nil}

User likes a post.

Creates a like record and increments the post's like counter. Returns error if user already liked the post.

Lists all groups ordered by name.

Lists popular tags by usage count.

Lists all dislikes for a post.

Lists all likes for a post.

Lists media for a post (ordered by position).

Lists mentioned users in a post.

Lists posts with optional filtering and pagination.

Parameters

• opts - Options
  • :user_uuid - Filter by user
  • :status - Filter by status (draft/public/unlisted/scheduled)
  • :type - Filter by type (post/snippet/repost)
  • :search - Search in title and content
  • :page - Page number (default: 1)
  • :per_page - Items per page (default: 20)
  • :preload - Associations to preload

Examples

iex> list_posts()
[%Post{}, ...]

iex> list_posts(status: "public", page: 1, per_page: 10)
[%Post{}, ...]

iex> list_posts(user_uuid: "018e3c4a-9f6b-7890-abcd-ef1234567890", type: "post")
[%Post{}, ...]

Lists posts in a group.

Lists public posts only.

Parameters

• opts - See list_posts/1 for options

Examples

iex> list_public_posts()
[%Post{}, ...]

Lists user's groups.

Lists user's posts.

Parameters

• user_uuid - User UUID (UUIDv7 string)
• opts - See list_posts/1 for options

Examples

iex> list_user_posts("019145a1-...")
[%Post{}, ...]

Callback invoked by the Comments module when a comment is created on a post. Increments the post's denormalized comment_count.

Callback invoked by the Comments module when a comment is deleted from a post. Decrements the post's denormalized comment_count.

Parses hashtags from text.

Extracts all hashtags (#word) from text and returns list of tag names.

Checks if a user has disliked a post.

Checks if a user has liked a post.

Processes scheduled posts that are ready to be published.

Finds all posts with status "scheduled" where scheduled_at <= now, and publishes them. Returns list of published posts.

Should be called periodically (e.g., via Oban job every minute).

Examples

iex> process_scheduled_posts()
{:ok, 2}

Publishes a post (makes it public).

Sets status to "public" and published_at to current time.

Examples

iex> publish_post(post)
{:ok, %Post{status: "public"}}

Removes the featured image from a post.

Removes a mention from a post.

Removes a post from a group.

Removes a tag from a post.

Reorders user's groups.

Reorders media in a post.

Resolves post titles and admin paths for a list of resource IDs.

Called by the Comments module to display resource context in the admin UI. Returns a map of resource_uuid => %{title: ..., path: ...}.

Schedules a post for future publishing.

Updates the post status to "scheduled" and creates an entry in the scheduled jobs table for execution by the cron worker.

Parameters

• post - Post to schedule
• scheduled_at - DateTime to publish at (must be in future)
• attrs - Additional attributes to update (title, content, etc.)
• opts - Options
  • :created_by_uuid - UUID of user scheduling the post

Examples

iex> schedule_post(post, ~U[2025-12-31 09:00:00Z])
{:ok, %Post{status: "scheduled"}}

iex> schedule_post(post, ~U[2025-12-31 09:00:00Z], %{title: "New Title"})
{:ok, %Post{status: "scheduled", title: "New Title"}}

Sets the featured image for a post (PostMedia with position 1).

User removes dislike from a post.

User unlikes a post.

Deletes the like record and decrements the post's like counter. Returns error if like doesn't exist.

Unschedules a post, reverting it to draft status.

Cancels any pending scheduled jobs for this post.

Parameters

• post - Post to unschedule

Examples

iex> unschedule_post(post)
{:ok, %Post{status: "draft"}}

Updates a group.

Updates an existing post.

Parameters

• post - Post struct to update
• attrs - Attributes to update

Examples

iex> update_post(post, %{title: "Updated Title"})
{:ok, %Post{}}

iex> update_post(post, %{title: ""})
{:error, %Ecto.Changeset{}}