File: readme.md

Recommend this page to a friend!

readme.md

File:	`readme.md`
Role:	Documentation
Content type:	`text/markdown`
Description:	Documentation
Class:	Personal Generate a portfolio site
Author:	By Rodrigo Faustino
Last change:
Date:	Yesterday
Size:	`4,830 bytes`

Download

Portfolio Website

Este projeto � um site de portf�lio din�mico desenvolvido com PHP puro, utilizando o padr�o MVC cl�ssico e sem arquitetura REST. O objetivo do site � oferecer um layout moderno e funcional, onde o conte�do � gerenciado de forma din�mica por uma �rea administrativa, ideal para exibir projetos, habilidades e informa��es de contato.

? Tecnologias Utilizadas

O site desenvolvido com as seguintes tecnologias e ferramentas:

PHP Puro: Linguagem principal do backend, sem uso de frameworks, garantindo simplicidade e desempenho.
Padr�o MVC Cl�ssico: Estrutura do c�digo organizada em Modelos, Controladores e Views, facilitando a manuten��o e escalabilidade do projeto.
League\Plates: Biblioteca de templates para PHP, respons�vel por gerenciar e renderizar as Views de forma eficiente.
HTML5, CSS3 e W3.CSS: Para criar uma interface moderna e responsiva.
Font Awesome: Biblioteca de �cones para enriquecer a experi�ncia visual.
JavaScript (Vanilla): Para funcionalidades interativas b�sicas, como manipula��o de menus e anima��es.
Monol�tico: Toda a aplica��o (frontend e backend) � servida como um �nico sistema integrado, sem APIs REST ou microservi�os.

?? League\Plates\Engine

O League\Plates � uma biblioteca de templates leve e eficiente para PHP. Utilizamos essa ferramenta para separar a l�gica da apresenta��o, permitindo:

Heran�a de Templates: Reutiliza��o de estruturas HTML comuns, como cabe�alhos e rodap�s.
Passagem de Dados: Possibilidade de enviar vari�veis do controlador para as Views.
Modulariza��o: Separa��o de componentes (parciais) como menus, rodap�s e cabe�alhos.

Exemplo de Uso no Projeto

No projeto, utilizamos o League\Plates\Engine para renderizar templates de forma din�mica. Aqui est� um exemplo:

Configura��o da Engine no Backend:

use League\Plates\Engine;

class View
{
    public static function render($template, $data = [])
    {
        $engine = new Engine(__DIR__ . '/../views');
        echo $engine->render($template, $data);
    }
}

Template Principal (master.php)

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title><?= $title ?? 'Portfolio Website' ?></title>
    <link rel="stylesheet" href="/assets/css/styles.css">
</head>
<body>
    <header>
        <?= $this->insert('partials/header') ?>
    </header>
    <main>
        <?= $this->section('content') ?>
    </main>
    <footer>
        <?= $this->insert('partials/footer') ?>
    </footer>
</body>
</html>

Renderiza��o no Controlador

detalhe importante (sistema de templates) https://platesphp.com/

class Portifolio{
    public function index()
    {
        $projects = Project::all();
        View::render('portfolio', [
            'title' => 'My Portfolio',
            'projects' => $projects,
        ]);
    }
}

?? Funcionalidades

Menu Din�mico: Gerado com base em configura��es do backend. Filtros de Portf�lio: Filtragem de projetos por categoria (Design, Fotos, Arte, etc.). �rea de Contato: Formul�rio funcional para envio de mensagens. Layout Responsivo: Compat�vel com dispositivos m�veis e desktops. �rea Administrativa: Para gerenciar conte�do do portf�lio.

? Estrutura de Pastas

A organiza��o do projeto segue uma estrutura simples e eficiente:

project/
??? app/
?   ??? controllers/
?   ??? database/
?   ?   ??? models/
?   ?        ??? Model.php
?   ?   ??? Connection.php
?   ?   ??? Transaction.php
?   ??? models/
?   ??? views/
?       ??? admin/
?       ??? auth/
?       ??? pages/
?       ??? partial/
? 
??? vendor/
??? public/
?   ??? assets/
?      ??? css/
?      ??? js/
?      ??? images/
?   ??? index.php
??? .env

Pr�-requisitos e Instala��o

Clone o reposit�rio:

git clone https://github.com/faustinopsy/personal.git

Configure o ambiente no arquivo .env:

arquivo .env

STRIPE_KEY=token do striper se for receber dinhero
DATABASE_NAME=a01_teste
DATABASE_HOST=localhost
DATABASE_USER=root
DATABASE_PASSWORD=root123
BASE_URL=http://localhost:1230
EMAIL=conta de email
SENHA=senha para envio de email
APP_SECRET_KEY=53xy69