Eizport

Descrição

O Eizport dá a Ferramentas → Exportar uma tela nova, construída como as telas mais recentes do painel do WordPress, e estende o Importador do WordPress. Prefere a tela Exportar do WordPress intocada? Uma configuração move a nova para um item próprio em Ferramentas; outra traz de volta a tela Exportar clássica com as mesmas escolhas adicionadas.

A tela Exportar

Construída com DataViews e DataForm, ela usa as habilidades do plugin:

• Uma só lista: os tipos de conteúdo, Anexos e Opções. Marque o que exportar; sem nada marcado, todo o conteúdo é exportado.
• Itens num painel lateral: os itens de cada tipo com pesquisa, filtros e uma caixa de seleção por item; o que você marca entra na exportação na hora, e um filtro Seleção mostra os escolhidos. Os itens mostram suas funções (Página inicial, Página de posts, Página da loja…).
• Opções: uma a uma num painel lateral (Básicas sugeridas). As configurações que apontam para os itens escolhidos (página inicial, página de posts, página de política de privacidade, ícone do site, páginas do WooCommerce) são sugeridas na linha Opções e vão com a exportação assim que ela é marcada.
• O arquivo num painel acima da lista, resumido numa linha até ser aberto: formato (WXR XML, ou WXRZ assim que arquivos de mídia ou configurações vão junto, ou um .zip do Playground), nome do arquivo, arquivos de mídia, temas e plugins do Playground.
• Salvar como padrão, Redefinir e Limpar padrões: inicie com as mesmas escolhas da próxima vez (as suas ou as do site), ou volte a elas.

Em Ferramentas → Importar → WordPress

• Pacotes .wxrz e .zip (e arquivos WXR compactados com gzip) são aceitos, com seus arquivos de mídia e de conteúdo.
• O importador fica com o visual da tela Exportar — um cabeçalho com o botão principal da etapa, as etapas em cartões, um botão de arquivo no idioma do painel — a não ser que Configurações → Geral desative isso.

Na tela clássica de Ferramentas → Exportar

• Vários tipos de conteúdo de uma vez: marque páginas e produtos, por exemplo, sem posts — ou mantenha “Todo o conteúdo”. Posts, páginas, mídia, produtos e outros tipos de post personalizados.
• Por filtros ou por seleção, por tipo: os filtros do WordPress para posts, páginas e mídia; para produtos e outros tipos de post personalizados, filtros do mesmo tipo (datas, status, autor e cada taxonomia, como as categorias de produtos). Ou marque os itens exatos numa lista (uma árvore para páginas), com uma caixa para filtrá-la. Os itens selecionados trazem seus anexos e seus descendentes de outros tipos, como as variações de um produto; as avaliações de produtos vêm com o produto delas.
• Pacote (.wxrz, ou .zip): baixe um só arquivo compactado com o WXR e, opcionalmente, mais. Sem ele, a exportação é o arquivo .xml de sempre do WordPress, com o nome de sempre.
• Mídia usada no conteúdo: os itens exportados trazem a mídia anexada e as imagens destacadas deles, como o WordPress faz, e também as imagens, galerias, coberturas e arquivos que o conteúdo deles usa sem estarem anexados (Configurações → Exportar → “Só mídia anexada” desativa isso).
• Salvar estas escolhas como padrão, e iniciar com elas da próxima vez.

Opções do pacote

• Nome do arquivo: à sua escolha; se ficar vazio, é o <site name>.WordPress.<date> de sempre do WordPress.
• Incluir mídia: os arquivos dos anexos exportados (imagens, PDFs…), para que o importador não os baixe do site antigo.
• Conteúdo como arquivos .html (ativado por padrão, em Configurações → Exportar): o conteúdo de cada post no seu próprio arquivo post_content/<slug>.html em vez de dentro do WXR — fácil de ler, editar e manter sob controle de versão.
• Incluir configurações: grupos de opções (Básicas, sugeridas; Leitura, Geral, Links permanentes, Discussão, Mídia, página de privacidade, personalizações do tema, páginas do WooCommerce) e qualquer outra opção pelo nome, num options.json. Quando a página inicial ou a página de posts é exportada, elas podem ser definidas como tais na importação. Os IDs nas configurações (página inicial, logo, menus…) são mapeados para os itens importados. URLs do site, o e-mail do administrador, chaves, plugins ativos, funções e transients nunca são exportados.
• Incluir um blueprint do Playground: o arquivo baixado vira um .zip pronto para o WordPress Playground: blueprint.json, o WXR simples (.xml), os arquivos de mídia e de conteúdo (conforme marcado acima) e os temas e plugins que você marcar que não estão no diretório do WordPress.org (um tema descendente traz o tema ascendente; os do diretório são instalados de lá, na versão que este site tem). O Playground os instala, ativa o tema e importa o conteúdo. Depois de baixar, a tela mostra o comando que o executa (npx @wp-playground/cli@latest server --blueprint=./<file>.zip).
• Manter uma cópia para abrir por link: com o blueprint, uma cópia do .zip fica no site por um tempo (um dia por padrão), e um link a abre no playground.wordpress.net.

Configurações, a partir da linha do plugin em Plugins (construídas com DataViews e DataForm)

• Geral: substituir Ferramentas → Exportar (ativado por padrão; desativado, a tela Exportar do WordPress fica como está e a nova fica em Ferramentas → Eizport), ou usar a tela Exportar clássica; de quem são os padrões salvos (de cada usuário ou do site) e como limpá-los; por quanto tempo as cópias são mantidas (1 hora, 12 horas, 1 dia, 1 semana ou até serem excluídas).
• Exportar: só mídia anexada; quando as configurações vinculadas vão junto (quando itens são marcados, na exportação, ambos, nunca); pacotes como .zip em vez de .wxrz; conteúdo como arquivos .html.
• Cópias: as cópias guardadas (pacotes, arquivos WXR e arquivos .zip do Playground), listadas como na Biblioteca de mídia — pesquisar, ordenar, abrir no Playground, copiar o link, baixar, importar e excluir uma, várias ou todas.

No Importador do WordPress

Envie um pacote .wxrz (ou .zip) como qualquer arquivo WXR. Os arquivos dos anexos são tirados do pacote, então nada é baixado do site antigo, que nem precisa estar on-line. Anexos, tamanhos de imagem e imagens destacadas são criados pelo importador como sempre. Os arquivos de conteúdo são postos de volta no WXR antes de a importação iniciar. Arquivos WXR compactados com gzip (.xml.gz) também são aceitos.

O formato .wxrz

Um arquivo .wxrz é um arquivo tar compactado com gzip:

• manifest.json — versão do formato, o nome do arquivo WXR e a qual URL de anexo cada arquivo de mídia pertence;
• o arquivo WXR;
• uploads/… — os arquivos dos anexos, nas mesmas pastas do site que exportou;
• post_content/<slug>.html — o conteúdo dos posts, quando exportado como arquivos;
• options.json — configurações, definidas quando a importação termina.

Você pode abri-lo com qualquer ferramenta que leia arquivos .tar.gz. Com Configurações → Exportar → “Pacote como .zip”, os pacotes são arquivos .zip comuns com as mesmas entradas, que qualquer computador abre.

Habilidades

A mesma exportação e importação, para agentes de IA e scripts, pela Abilities API do WordPress (/wp-json/wp-abilities/v1/abilities/<name>/run, e como ferramentas com o MCP Adapter):

• eizport/get-export-options — o que pode ser exportado: tipos de conteúdo com seus termos, status e contagens, grupos de configurações, temas e plugins, a página inicial e a página de posts.
• eizport/get-items — uma página de itens de um tipo (pesquisa, ordenação, os mesmos filtros da exportação), para escolher o que exportar.
• eizport/get-options — as opções do site uma a uma (pesquisa, group, páginas), com o tamanho e se retêm IDs de posts; as opções que nunca são exportadas ficam de fora.
• eizport/export — exporta para uma cópia temporária (um pacote .wxrz ou .zip, o .xml simples do WordPress com bundle: false, ou um .zip do Playground com blueprint) e retorna o link dela: types (tipo de post => ids ou filters), media, media_used, post_content, zip, options (groups, names, front_pages, linked ou all), blueprint (themes, plugins), filename.
• eizport/get-export-defaults, eizport/save-export-defaults e eizport/clear-export-defaults — as escolhas salvas como padrão (as do site precisam de manage_options).
• eizport/get-copies — as cópias guardadas, com os links e a validade delas.
• eizport/delete-copies — exclui cópias por names, ou all.
• eizport/import — importa uma copy guardada neste site, ou um attachment_id de um arquivo .wxrz, .zip ou .xml, com mídia e configurações.
• eizport/get-settings e eizport/update-settings — as configurações do plugin (veja Configurações acima); manage_options.

Elas seguem as mesmas regras das telas: a capacidade export para exportar e para as cópias, import para importar. Só uma exportação roda por solicitação.

Para desenvolvedores

• eizport_post_content — filtra o conteúdo que um item importado recebe de um pacote ($content, $item com id, type e slug originais, $dir).
• eizport_wxrz_max_bytes — o maior tamanho que um .wxrz pode atingir descompactado na importação (padrão 512 MB).
• eizport_playground_blueprint — filtra o blueprint de um .zip do Playground ($blueprint, $wxr_name).
• eizport_linked_options — opções que apontam para um post, com a função que dão a ele: option => array( 'label' => 'Shop page', 'with' => array( … ), 'when' => array( option => value ) ). Elas recebem o ID do post importado na importação, aparecem nos itens e vão junto com eles.
• eizport_option_groups — os grupos de opções oferecidos (key => array( 'label' => 'Name: what it holds', 'options' => array( … ) )).
• eizport_denied_options — mais opções que nunca são exportadas (chaves, tokens ou números de versão de um plugin); as do próprio WordPress não podem ser removidas.
• eizport_media_used — anexos que um post usa além do conteúdo dele ($used, $post), como uma galeria de produto.
• eizport_register_compat — ação, depois que todos os plugins carregam, em que as compatibilidades se conectam a esses filtros. A do WooCommerce vem com o plugin (includes/compat/woocommerce.php: páginas, um grupo, opções de versão, galerias de produtos); um plugin pode substituí-la pela sua própria: remove_action( 'eizport_register_compat', 'Eizport\Compat\WooCommerce\register' );.
• eizport_post_id_options — opções que retêm um ID de post (por padrão, as opções vinculadas), mapeadas para o post importado na importação.
• eizport_selection_limit — quantos itens cada lista “Por seleção” mostra (padrão 1000, os mais recentes).
• eizport_copy_lifetime — quanto tempo dura uma cópia do Playground, em segundos (padrão: o escolhido nas configurações; 0 mantém as cópias até serem excluídas).
• wp eizport import <file> — comando WP-CLI que importa um .wxrz (ou .xml.gz, ou .xml) com o Importador do WordPress, anexos incluídos.

Serviços externos

O Eizport não executa um serviço próprio e não envia nada para os autores dele. Alguns recursos dependem de serviços do WordPress.org, como o próprio WordPress, ou de links que você escolhe abrir:

• API de plugins e temas do WordPress.org (api.wordpress.org). Quando você gera um .zip do Playground, o Eizport pede ao WordPress as informações de atualização que ele já guarda sobre os seus plugins e temas, para saber quais vêm do diretório: esses são instalados de lá em vez de copiados para o .zip. Se o WordPress ainda não conhece algum deles, ele faz a verificação de atualizações de sempre, que envia a lista de plugins e temas instalados com as versões deles, as versões do WordPress e do PHP, o idioma do site e o endereço dele. No outro site, um plugin exportado “como plugin” pergunta à mesma API se o Eizport está no diretório, quando a tela dele é aberta e o Eizport não está instalado: a solicitação leva o nome “eizport” e o que o WordPress envia em toda solicitação desse tipo (a versão dele, o idioma e o endereço do site). Política de privacidade do WordPress.org: https://wordpress.org/about/privacy/
• Downloads do WordPress.org (downloads.wordpress.org). “Instalar agora” instala o Eizport ou o Importador do WordPress de lá, pelo próprio instalador do WordPress, só quando você clica. Dentro do WordPress Playground, o blueprint também instala de lá os plugins e temas do diretório, nas versões que o seu site tem. Mesma política de privacidade.
• WordPress Playground (playground.wordpress.net), um projeto do WordPress.org que executa o WordPress no navegador: https://wordpress.org/playground/. “Abrir no WordPress Playground” o abre no seu navegador, só quando você clica, com o link de uma cópia guardada no seu site; o Playground então baixa esse .zip, com o conteúdo que você exportou, do seu site para o seu navegador. O endereço $schema no blueprint.json é só uma referência para editores; nada é solicitado a ele. Mesma política de privacidade.
• O site de onde o conteúdo veio. Como o Importador do WordPress, uma importação baixa dos endereços originais os arquivos de mídia para os quais um WXR simples aponta, ou que um pacote não inclui. Os arquivos que um pacote inclui são servidos pelo seu próprio servidor.
• GitHub (github.com/eizport/eizport). Quando o Eizport não está instalado, um plugin exportado “como plugin” também mostra um link “Baixar o Eizport” para os lançamentos dele lá; nada é enviado, a não ser que você clique nele. Termos: https://docs.github.com/en/site-policy/github-terms/github-terms-of-service — privacidade: https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement