BLOG NO SEU SITE: kit PHP do JornalBox (versão 1.0)
===================================================

O JornalBox escreve e guarda as matérias. Este kit mostra essas matérias no blog do
seu site, com o visual do seu site, lendo pela API.

Documentação completa: https://jornalbox.com.br/funcionalidades/blog-no-seu-site#documentacao


INSTALAR (5 minutos)
--------------------
1. No painel do JornalBox, abra Configurações > Site ou só API, marque
   "Só a API, no blog do meu site", preencha a "Página do blog" com o endereço
   desta pasta no seu site e salve. Copie a chave.
   (Nesse modo não há site no JornalBox: o endereço de lá passa a mandar os
   leitores para o seu blog, e Temas e Layout somem do painel. Sem custo a mais.)
2. Envie a pasta "blog" deste kit para a raiz do seu site (fica seusite.com.br/blog).
3. Abra blog/config.php e preencha: a chave, o endereço da pasta e o nome do site.
4. Troque blog/topo.php e blog/rodape.php pelo topo e rodapé do seu site. No topo,
   mantenha "<?= $head ?>" dentro do <head>: é o que leva título e SEO de cada página.
5. Abra seusite.com.br/blog. Pronto.

Funciona também em subdomínio (blog.seusite.com.br): envie o conteúdo da pasta
"blog" para a raiz do subdomínio e use esse endereço em url_blog.
Envie seusite.com.br/blog/sitemap.xml no Google Search Console.


ARQUIVOS
--------
blog/config.php           sua chave e endereços
blog/jornalbox-blog.php   biblioteca (não precisa mexer)
blog/index.php            endereços: /blog, /blog/<matéria>, /blog/categoria/<slug>,
                          /blog/busca?q=, /blog/sitemap.xml
blog/modelos/lista.php    HTML da lista de matérias (mude à vontade)
blog/modelos/post.php     HTML da matéria (mude à vontade)
blog/blog.css             visual mínimo; apague se for usar o CSS do seu site
blog/topo.php, rodape.php topo e rodapé do seu site
blog/cache/               respostas guardadas (precisa ser gravável pelo PHP)


REQUISITOS
----------
PHP 7.4 ou mais novo, com cURL (ou allow_url_fopen ligado) e mod_rewrite (Apache).
Em Nginx, mande /blog/* para /blog/index.php:
    location /blog/ { try_files $uri /blog/index.php?$query_string; }


USAR SÓ A BIBLIOTECA (sem as páginas prontas)
---------------------------------------------
    require 'blog/jornalbox-blog.php';
    $jb = new JornalBoxBlog(['chave' => 'SUA_CHAVE', 'url_blog' => 'https://seusite.com.br/blog']);
    $ultimas = $jb->posts(['por_pagina' => 3]);      // ex.: 3 últimas na página inicial
    foreach ($ultimas['posts'] as $p) {
        echo '<a href="' . $jb->link($p['slug']) . '">' . $jb->e($p['titulo']) . '</a>';
    }


DÚVIDAS
-------
Central de ajuda: https://jornalbox.com.br/ajuda/blog-no-seu-site-api
WhatsApp: +55 (62) 99461-4120 · contato@jornalbox.com.br
