marphy / blogstudio-bundle
Symfony bundle for integrating BlogStudio blog management
Package info
github.com/marphy-sk/blogstudio-symfony
Type:symfony-bundle
pkg:composer/marphy/blogstudio-bundle
v0.1.0
2026-03-27 10:06 UTC
Requires
- php: >=8.2
- symfony/cache: ^7.2
- symfony/config: ^7.2
- symfony/dependency-injection: ^7.2
- symfony/http-client: ^7.2
Requires (Dev)
- phpunit/phpunit: ^11.0
- symfony/twig-bundle: ^7.2
Suggests
- symfony/twig-bundle: Required for Twig functions (blogstudio_articles, blogstudio_tracker, etc.)
Provides
None
Conflicts
None
Replaces
None
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