Mundo phpBB

Código: Selecionar todos

---
title: Introdução
taxonomy:
    category: docs
---

# Mundo phpBB Workspace

O **Mundo phpBB Workspace** é uma IDE (Ambiente de Desenvolvimento Integrado) embutida diretamente no seu fórum phpBB. Ela foi projetada para administradores que precisam editar extensões, arquivos de estilo ou scripts do servidor sem a necessidade de clientes FTP externos.

## Principais Recursos
* **Gestão de Projetos:** Organize seus arquivos por módulos ou extensões.
* **Editor Profissional:** Baseado no Ace Editor (mesmo do VS Code) com tema Monokai.
* **Upload Recursivo:** Arraste pastas inteiras do seu PC para o servidor.
* **Busca Global:** Encontre e substitua termos em todos os arquivos de um projeto de uma só vez.
* **Diff Wizard:** Gere códigos de comparação coloridos para postar no fórum.

! **Segurança Máxima:** Por padrão, apenas usuários com privilégios de **Fundador (Founder)** podem acessar a IDE.

Código: Selecionar todos

---
title: Instalação e Ativação
---

# Instalação

Para instalar a extensão, siga os passos abaixo:

1. **Upload:** Envie a pasta `mundophpbb` para o diretório `ext/` do seu fórum.
2. **Ativação:** Vá ao Painel de Administração (ACP) > Personalizar > Gerenciar Extensões. Procure por **Mundo phpBB Workspace** e clique em Ativar.
3. **Limpeza:** Sempre que realizar uma atualização de versão, limpe o cache do fórum no painel principal do ACP.

## Requisitos de Banco de Dados
Para suporte total a **Emojis** e caracteres especiais em seus arquivos, certifique-se de que seu banco de dados MySQL utiliza a codificação `utf8mb4`. A extensão tentará realizar essa conversão automaticamente durante a instalação.

Código: Selecionar todos

---
title: Gerenciando Projetos
---

# Projetos

Os projetos funcionam como "Pastas Raiz" para organizar seu trabalho.

### Criar Novo Projeto
Clique no botão **+ Novo Projeto** na parte inferior da sidebar. Um nome amigável ajudará você a identificar qual extensão ou estilo está editando.

### Baixar Projeto (ZIP)
Ao lado do nome do projeto, existe um ícone de **Download**. Clique nele para gerar um arquivo `.zip` contendo todos os arquivos e subpastas do projeto, ideal para backups rápidos ou distribuição.

### Excluir Projeto
O ícone de **Lixeira** remove o projeto e todos os arquivos vinculados a ele no banco de dados. 
!! Cuidado: Esta ação é irreversível.

Código: Selecionar todos

---
title: Arquivos e Upload Recursivo
---

# Manipulação de Arquivos

### Novo Arquivo
Dentro de um projeto, use o ícone **+** para criar arquivos. O Workspace possui um sistema de *Boilerplate*:
* Se criar um arquivo `.php`, ele já inicia com `<?php`.
* Se criar um `.py`, inicia com a codificação UTF-8.

### Upload Recursivo (Arrastar e Soltar)
Esta é uma das funções mais poderosas da IDE. Você pode selecionar uma pasta inteira no seu computador (ex: uma extensão completa) e arrastá-la sobre o título do projeto. 
* O sistema irá recriar todas as subpastas automaticamente.
* Arquivos existentes com o mesmo nome serão atualizados.

### Filtro de Sidebar
No topo da sidebar, há um campo de busca rápida. Digite o nome de um arquivo para filtrá-lo instantaneamente entre todos os seus projetos. As pastas que contêm o arquivo serão expandidas automaticamente.

Código: Selecionar todos

---
title: O Editor de Código
---

# Ace Editor

O coração da nossa IDE é o Ace Editor, configurado para alta performance.

### Indicador de Alterações (*)
Sempre que você modificar um arquivo e não salvar, um **asterisco (*)** aparecerá ao lado do nome do arquivo na sidebar e o texto ficará em itálico. Isso indica que há trabalho pendente de salvamento.

### Atalhos Úteis
* **Ctrl + S (ou Cmd + S):** Salva o arquivo atual instantaneamente via AJAX.
* **Ctrl + F:** Busca interna no arquivo aberto.
* **Tab:** Indentação inteligente de 4 espaços.

### Salvamento Blindado
O sistema de salvamento utiliza transações SQL. Se houver um erro de conexão ou caractere inválido, o sistema cancela a operação para evitar que o arquivo no banco de dados fique corrompido ou "cortado".

Código: Selecionar todos

---
title: Ferramentas Avançadas
---

# Ferramentas de Produtividade

### Busca e Substituição Global
Ao clicar na lupa ao lado do projeto, você abre o modal de substituição em massa.
1. Se houver um arquivo aberto, você pode optar por substituir apenas nele.
2. Se nenhum arquivo estiver selecionado, a substituição ocorrerá em **todos** os arquivos do projeto simultaneamente.

### Diff Wizard (Gerador de Patches)
Ferramenta essencial para quem dá suporte no fórum.
1. Clique em **Diff Tool**.
2. Selecione o arquivo Original e o arquivo Modificado.
3. Clique em Gerar.
O sistema abrirá uma janela com o código em formato BBCode `[diff]`. Basta copiar e colar no seu post para que os usuários vejam as alterações coloridas (verde para adições, vermelho para remoções).