IDG-2013 - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #llm #golang #go #machine-learning #deep-learning #docker #nodejs #awesome-list #security #pytorch #mcp #open-source

IDG-2013

(★ 87)

Portal padrão em CMS Joomla, versão 3.8.10

파일 탐색기

최종 버전 다운로드 (.zip)

파일 수가 많아 일부만 표시됩니다. 전체 파일은 위 다운로드 버튼으로 확인해 주세요.

- - configuration.php
  - docker-entrypoint.sh
  - Dockerfile
  - populate-sample.php
- - helpsites.xml
- - defines.php
.babelrc
.dockerignore
.editorconfig
.gitignore
.php-cs-fixer.dist.php
.prettierrc
LICENSE.txt
README.md
README.txt

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/joomlagovbr/IDG-2013

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd IDG-2013

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker compose --profile prod up --build -d

compose 설정 파일에 정의된 서비스들을 대상으로 명령을 실행합니다.

docker compose --profile dev up --build

compose 설정 파일에 정의된 서비스들을 대상으로 명령을 실행합니다.

dockerfile: ./.docker/php/Dockerfile

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Portal padrão em CMS Joomla 3.9.6

Se tiverem dificuldades, podem entrar em contato: <tiagovtg@gmail.com>

## Sobre esta versão

O Joomla 3.9.6 é recomendado para versões do PHP 5.3.10+. Melhor usando PHP 7.2.+

_Atualização somente do Tema_ pode ser feito separadamente por esse outro [repositório do Bernado](https://github.com/dioubernardo/pip-joomla).

### Acompanhe as atualizações do projeto

Participe do grupo do google chamado [Joomla! e-Gov](https://groups.google.com/forum/?hl=pt-BR#!forum/joomla-e-gov-br) para se manter informado sobre o Portal Padrão em CMS Joomla. As atualizações não possuem data programada e ocorrem de acordo com a disponibilidade dos voluntários participantes.

### Atenção

Este projeto visa ser um _quickstart_ para iniciar projetos próprios de portais padrão em CMS Joomla, e atende as principais especificações e módulos recomendados pela Presidência da República, mas não esgota todos os módulos e recomendações citadas nos manuais.

Os voluntários deste grupo não se responsabilizam pela incorreta utilização deste pacote, bem como pela incorreta configuração do servidor de produção, no que se refere
a quesitos segurança e performance.

Recomenda-se a utilização de ambiente LAMP (Linux, Apache, MySQL, PHP), configurado para ambientes de produção de governo, o que implica configurações severas de permissões de pasta, restrições de acesso ao diretório /administrator, realização de BACKUPS, dentre outras boas práticas.

ESTE PROJETO É RECOMENDADO PARA PROFISSIONAIS COM EXPERIÊNCIA NA UTILIZAÇÃO DO CMS JOOMLA.

## Configuração inicial

Não é mais necessário alterar o arquivo configuration.php manualmente.

O instalador padrão do CMS Joomla! 3.x foi customizado para configurar uma instalação padrão do CMS Joomla! com componentes, módulos, template e conteúdo de exemplo do Portal Padrão.

## Problemas na instalação

Se tiver problemas na instalação e travar no meio, tente alterar as variaveis de ambiente do PHP
Arquivo:
php.ini

Alterações:
max_execution_time=600
;(valor padrão 30, alterado para 600)

max_input_time=1200
;(valor padrão 60, alterado para 1200)

max_input_vars = 6000
;padrão linha comentada, descomentar esta linha
;(valor padrão 1000, alterado para 6000)

memory_limit=1280M
;(valor padrão 128M, alterado para 1280M)

Não precisa de aumentar tanto, mas pode ir testando se quiser, exemplo, memoria padrão é 128M, pode ir subindo 256M,512M, 1024M

Se tiverem dificuldades, podem entrar em contato: <tiagovtg@gmail.com>

## Utilizando Docker

> **ATENÇÃO:** Essa abordagem tem a finalidade de demonstração e desenvolvimento. Os arquivos disponibilizados são exemplos, avalie segurança, melhores práticas e configurações específicas sempre que forem ser utilizados em produção.

É possível utilizar Docker para servir o portal, para isso foram incluídos exemplos de configuração.

### Preparando o ambiente

Instale as ferramentas necessárias:

- [Docker](https://docs.docker.com/get-docker/)
- [Docker Compose](https://docs.docker.com/compose/install/).

Para Windows 10 versão 2004 ou superior e Windows 11

- [WSL](https://docs.microsoft.com/pt-br/windows/wsl/install)

### Como rodar?

Utiliza-se o `docker compose` para orquestrar os serviços da aplicação.

Existem dois arquivos de exemplos de configuração:

- docker-compose.yml: Este arquivo contém instruções para instalação de um portal padrão Joomla, com a configuração inicial sendo realizada pela plataforma.
- docker-compose.override.yml: Este arquivo contém instruções que sobrescrevem dados para uso em desenvolvimento. Ele configura um portal com dados preexistentes automaticamente, além de possuir um serviço com NPM para executar o Gulp.

```bash
docker compose --profile prod up --build -d
```

Rodar o comando acima, informando o profile `prod`, garante que apenas contêineres responsáveis por publicar nosso site estejam disponíveis.

Para servir localmente, em ambiente de desenvolvimento e habilitando o HotReload através do task runner Gulp, execute:

```bash
docker compose --profile dev up --build
```

A opção `-d` ou `--detach` foi omitida propositalmente para acompanharmos as saídas do Gulp.

Se você estiver usando um sistema operacional Unix-like (Linux, MacOS, WSL), talvez você precise ajustar as permissões dos arquivos. Para tanto, siga a orientação a seguir:

Por padrão, o id do usuário dentro da imagem **Docker** é definido para `1000`. Você pode alterar esse comportamento através de argumentos de build definidos no arquivo de configuração do **docker-composer**. Para isso, abra o terminal e identifique o seu `id` de usuário com o comando `id -u`. Em seguida, edite ou crie um arquivo de configuração do docker-compose conforme o exemplo abaixo:

```yaml
services:
  app:
    container_name: joomlagov-webapp
    build:
      context: .
      dockerfile: ./.docker/php/Dockerfile
      args:
        UID: 1000
   ...
```

### Arquivos de configuração

Crie um arquivo .env na raiz do projeto e informe as variáveis de ambiente para que os serviços sejam ativados corretamente.

| Variável             | Descrição                                                                                            |
| -------------------- | ---------------------------------------------------------------------------------------------------- |
| JOOMLA_DB_HOST       | Host da base de dados. Pode ser o serviço `db` disponível no docker-compose ou outro host.           |
| JOOMLA_DB_USER       | Usuário para acesso à base de dados.                                                                 |
| JOOMLA_DB_PASSWORD   | Trata-se da senha de root para acesso à base de dados. Sem esta não será possível acessar o serviço. |
| JOOMLA_DB_NAME       | Nome da base de dados. Usado apenas na publicação automática de exemplo.                             |
| JOOMLA_DB_PREFIX     | Prefixo de tabela na base de dados. Usado apenas na publicação automática de exemplo.                |
| JOOMLA_ROOT_USERNAME | Super usuário do Joomla. Usado apenas na publicação automática de exemplo.                           |
| JOOMLA_ROOT_PASSWORD | Senha do super usuário do Joomla. Usado apenas na publicação automática de exemplo.                  |

Veja um exemplo:

```env
JOOMLA_DB_HOST=db
JOOMLA_DB_USER=root
JOOMLA_DB_PASSWORD=brasil
JOOMLA_DB_NAME=joomlagovdb
JOOMLA_DB_PREFIX=xmx0n_
JOOMLA_ROOT_USERNAME=joomlagov
JOOMLA_ROOT_PASSWORD=brasil
```

### Serviços disponíveis

| Serviço    | Descrição                            | Acesso                  | Disponibilidade (perfis) |
| ---------- | ------------------------------------ | ----------------------- | ------------------------ |
| webapp     | Portal Web                           | <http://localhost>      | prod, dev                |
| db         | Servidor de banco de dados           |                         | prod, dev                |
| phpmyadmin | Portal Gerenciador do banco de dados | <http://localhost:8080> | prod, dev                |
| npm        | Task runner                          | <http://localhost:3000> | dev                      |

**ATENÇÃO:** Utilize o banco de dados em contêiner em produção com cautela, há sérios riscos de perda dados.

## Documentação

Confira a documentação disponível até o momento no repositório provisório [https://github.com/joomlagovbr/documentacao](https://github.com/joomlagovbr/documentacao).

### Links diretos

- [Manual Template Portal Padrão, vr. 0.1](https://github.com/joomlagovbr/documentacao/raw/master/pdf/1.%20Manual%20Portal%20Padrao.pdf) - (as imagens são baseadas na versão Joomla 2.5, mas os princípios de alteração são os mesmos para a versão 3.3)
- [Como criar uma manchete de página inicial ou editoria](https://github.com/joomlagovbr/documentacao/raw/master/pdf/2.%20Pagina%20Inicial%20-%20Criar%20manchete.pdf)
- [Posições de template do projeto Portal Padrão (importante)](https://github.com/joomlagovbr/documentacao/raw/master/pdf/3.%20Posicoes%20de%20template%20do%20projeto%20portal%20padrao.pdf) - (as posições são geradas dinamicamente, através de uma lógica própria)

## Desenvolvimento

- [Comunidade Joomla Calango](http://www.joomlacalango.org/)