Search by

marphy / blogstudio-bundle

marphy

Symfony bundle for integrating BlogStudio blog management

Package info

github.com/marphy-sk/blogstudio-symfony

Type:symfony-bundle

pkg:composer/marphy/blogstudio-bundle

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

v0.1.0 2026-03-27 10:06 UTC

This package is not auto-updated.

Last update: 2026-11-07 12:05:20 UTC


README

Symfony 7.2+ bundle for integrating BlogStudio blog content and analytics tracking into your Symfony application.

Installation

composer require marphy/blogstudio-bundle

Configuration

Create config/packages/blogstudio.yaml:

blogstudio:
    api_key: '%env(BLOGSTUDIO_API_KEY)%'
    public_key: '%env(BLOGSTUDIO_PUBLIC_KEY)%'
    base_url: 'https://api.blogstudio.dev'  # optional, this is the default
    cache_ttl: 300                           # optional, seconds (0 = no cache)

Add to .env:

BLOGSTUDIO_API_KEY=your-server-side-api-key
BLOGSTUDIO_PUBLIC_KEY=your-client-side-public-key

Usage

In a Controller

use Marphy\BlogStudioBundle\Client\BlogStudioClientInterface;

class BlogController extends AbstractController
{
    #[Route('/blog', name: 'blog_index')]
    public function index(BlogStudioClientInterface $client): Response
    {
        $articles = $client->getArticles(limit: 10);

        return $this->render('blog/index.html.twig', [
            'articles' => $articles->articles,
            'nextCursor' => $articles->nextCursor,
        ]);
    }

    #[Route('/blog/{slug}', name: 'blog_show')]
    public function show(string $slug, BlogStudioClientInterface $client): Response
    {
        $article = $client->getArticle($slug);

        return $this->render('blog/show.html.twig', [
            'article' => $article,
        ]);
    }
}

In Twig

Requires symfony/twig-bundle.

{# List articles #}
{% set result = blogstudio_articles(10) %}
{% for article in result.articles %}
    <h2>{{ article.title }}</h2>
    <p>{{ article.excerpt }}</p>
{% endfor %}

{# Single article #}
{% set article = blogstudio_article('my-post-slug') %}
<h1>{{ article.title }}</h1>
{{ article.content|raw }}

{# Categories and tags #}
{% set categories = blogstudio_categories() %}
{% set tags = blogstudio_tags() %}

{# Analytics tracker (renders script tag) #}
{{ blogstudio_tracker(article.id) }}

Available Twig Functions

Function Returns Description
blogstudio_articles(limit, cursor, categoryId) ArticleList List articles with pagination
blogstudio_article(slug) Article Get single article by slug
blogstudio_categories() Category[] List all categories
blogstudio_tags() Tag[] List all tags
blogstudio_tracker(articleId) string (HTML) Render analytics tracking script

Test Connection

php bin/console blogstudio:test

API Keys

BlogStudio uses two types of keys:

  • API Key (api_key) — server-side only. Used to read articles, categories, and tags. Keep secret.
  • Public Key (public_key) — client-side safe. Used only for analytics tracking. Can be exposed in HTML.

License

MIT