kaubuntu.re/README.md

# Kaubuntu.re - Plateforme Multimédia

Une plateforme multimédia conçue pour diffuser du contenu à partir d'une instance PeerTube.

## Description

Kaubuntu.re est une interface web responsive qui permet de consulter et rechercher des vidéos hébergées sur une instance PeerTube. La plateforme est conçue pour être légère, facilement déployable sur un serveur mutualisé, et optimisée pour les appareils mobiles et desktop.

## Fonctionnalités

- Affichage des vidéos à la une et récentes
- Navigation par catégories
- Lecture de vidéos
- Recherche de contenu
- Interface responsive (mobile et desktop)
- Intégration avec une instance PeerTube

## Technologies utilisées

- HTML5
- CSS3 avec Media Queries pour le responsive design
- PHP pour le backend
- JavaScript pour les interactions côté client
- Bibliothèques externes via CDN:
  - Font Awesome (icônes)
  - jQuery

## Structure du projet

```
├── css/
│   ├── styles.css
│   ├── video-page.css
│   ├── categories.css
│   └── search.css
├── img/
│   ├── categories/
│   ├── video-thumbnails/
│   └── channels/
├── js/
│   └── main.js
├── includes/
│   ├── header.php
│   ├── footer.php
│   ├── mobile-menu.php
│   ├── featured-videos.php
│   ├── recent-videos.php
│   └── categories.php
├── index.php
├── video.php
├── categories.php
├── search.php
└── README.md
```

## Installation

1. Clonez ce dépôt
2. Configurez votre serveur web (Apache, Nginx, etc.) pour pointer vers le répertoire racine

## Configuration

Le site utilise un système de configuration en deux parties :
- `includes/config.php` : La configuration de base (versionnée)
- `includes/config.local.php` : Votre configuration locale (non versionnée)

Pour configurer votre environnement local :

1. Copiez le fichier d'exemple vers le fichier local :
   ```
   cp includes/config.local.php.sample includes/config.local.php
   ```

2. Modifiez `includes/config.local.php` selon vos besoins :
   - URL de l'instance PeerTube
   - Clé API
   - Catégories à afficher
   - Nombre de vidéos par section
   - etc.

Les modifications apportées à `config.local.php` ne seront pas suivies par Git, ce qui vous permet de personnaliser votre instance sans affecter le code source principal.

## Personnalisation des catégories

Pour personnaliser les catégories affichées sur la page d'accueil, modifiez la constante `PRIORITY_CATEGORIES` dans votre fichier `config.local.php` :

```php
define('PRIORITY_CATEGORIES', [
    11 => 'Actualité & Politique',
    14 => 'Activisme',
    15 => 'Science & Technologie',
    1 => 'Musique',
    // Ajoutez d'autres catégories selon vos besoins
]);
```

- Les clés sont les IDs des catégories dans PeerTube
- Les valeurs sont les noms personnalisés que vous souhaitez afficher
- L'ordre dans le tableau détermine l'ordre d'affichage sur la page

## Personnalisation

Vous pouvez personnaliser l'apparence de la plateforme en modifiant les fichiers CSS dans le dossier `css/`. Pour changer le logo et les couleurs principales:

1. Remplacez le fichier `img/logo.png` par votre propre logo
2. Modifiez les couleurs dans `css/styles.css`

## Déploiement

Pour déployer sur un serveur mutualisé:

1. Assurez-vous que votre hébergeur supporte PHP (version 7.0 minimum recommandée)
2. Transférez tous les fichiers via FTP dans le répertoire racine de votre site
3. Vérifiez que les permissions des fichiers sont correctement définies (644 pour les fichiers, 755 pour les dossiers)
4. Configurez votre domaine pour pointer vers le dossier où vous avez installé l'application

## Développement

Si vous souhaitez contribuer au développement:

1. Créez une branche pour vos modifications: `git checkout -b ma-nouvelle-fonctionnalité`
2. Committez vos changements: `git commit -m 'Ajout d'une nouvelle fonctionnalité'`
3. Poussez vers la branche: `git push origin ma-nouvelle-fonctionnalité`
4. Soumettez une pull request

## Licence

Ce projet est sous licence [MIT](LICENSE).

## Contact

Pour toute question ou suggestion, veuillez nous contacter à [contact@kaubuntu.re](mailto:contact@kaubuntu.re).