Penerbit - Panduan Instalasi

Panduan Instalasi Penerbit

Petunjuk lengkap untuk menginstal dan mengkonfigurasi module Publisher untuk XOOPS CMS.

Persyaratan Sistem

Persyaratan Minimum

Persyaratan	Versi	Catatan
XOOPS	2.5.10+	Platform CMS core
PHP	7.1+	PHP 8.x direkomendasikan
MySQL	5.7+	Server basis data
Server Web	Apache/Nginx	Dengan dukungan penulisan ulang

Ekstensi PHP

- PDO (PHP Data Objects)
- pdo_mysql or mysqli
- mb_string (multibyte strings)
- curl (for external content)
- json
- gd (image processing)

Ruang Disk

File module: ~5 MB
Direktori cache: disarankan 50+ MB
Unggah direktori: Sesuai kebutuhan konten

Daftar Periksa Pra-Instalasi

Sebelum menginstal Publisher, verifikasi:

core XOOPS diinstal dan dijalankan
Akun admin memiliki izin manajemen module
Cadangan basis data dibuat
Izin file memungkinkan akses tulis ke direktori /modules/
Batas memori PHP minimal 128 MB
Batas ukuran upload file sesuai (min 10 MB)

Langkah Instalasi

Langkah 1: Unduh Publisher

Opsi A: Dari GitHub (Disarankan)

# Navigate to modules directory
cd /path/to/xoops/htdocs/modules/

# Clone the repository
git clone https://github.com/XoopsModules25x/publisher.git

# Verify download
ls -la publisher/

Opsi B: Unduhan Manual

Kunjungi Rilis Penerbit GitHub
Download file .zip terbaru
Ekstrak ke modules/publisher/

Langkah 2: Tetapkan Izin File

# Set proper ownership
chown -R www-data:www-data /path/to/xoops/htdocs/modules/publisher

# Set directory permissions (755)
find publisher -type d -exec chmod 755 {} \;

# Set file permissions (644)
find publisher -type f -exec chmod 644 {} \;

# Make scripts executable
chmod 755 publisher/admin/index.php
chmod 755 publisher/index.php

Langkah 3: Instal melalui Admin XOOPS

Masuk ke Panel Admin XOOPS sebagai administrator
Navigasikan ke Sistem → module
Klik Instal module
Temukan Penerbit dalam daftar
Klik tombol Instal
Tunggu hingga instalasi selesai (menampilkan tabel database yang dibuat)

Installation Progress:
✓ Tables created
✓ Configuration initialized
✓ Permissions set
✓ Cache cleared
Installation Complete!

Pengaturan Awal

Langkah 1: Akses Admin Penerbit

Buka Panel Admin → module
Temukan module Penerbit
Klik tautan Admin
Anda sekarang berada di Administrasi Penerbit

Langkah 2: Konfigurasikan Preferensi module

Klik Preferensi di menu sebelah kiri
Konfigurasikan pengaturan dasar:

General Settings:
- Editor: Select your WYSIWYG editor
- Items per page: 10
- Show breadcrumb: Yes
- Allow comments: Yes
- Allow ratings: Yes

SEO Settings:
- SEO URLs: No (enable later if needed)
- URL rewriting: None

Upload Settings:
- Max upload size: 5 MB
- Allowed file types: jpg, png, gif, pdf, doc, docx

Klik Simpan Pengaturan

Langkah 3: Buat Kategori Pertama

Klik Kategori di menu sebelah kiri
Klik Tambahkan Kategori
Isi formulir:

Category Name: News
Description: Latest news and updates
Image: (optional) Upload category image
Parent Category: (leave blank for top-level)
Status: Enabled

Klik Simpan Kategori

Langkah 4: Verifikasi Instalasi

Periksa indikator ini:

graph TD
    A[Installation Check] -->|Database| B[✓ Tables exist]
    A -->|Files| C[✓ Folders writable]
    A -->|Admin| D[✓ Module visible]
    A -->|front-end| E[✓ Module displays]

Pemeriksaan Basis Data

mysql -u xoops_user -p xoops_database
mysql> SHOW TABLES LIKE 'publisher%';

# Should show tables:
# - publisher_categories
# - publisher_items
# - publisher_comments
# - publisher_files

Pemeriksaan Bagian Depan

Kunjungi beranda XOOPS Anda
Cari block Penerbit atau Berita
Harus menampilkan artikel terbaru

Konfigurasi Setelah Instalasi

Pemilihan Editor

Penerbit mendukung banyak editor WYSIWYG:

Penyunting	Kelebihan	Kontra
FCKeditor	Kaya fitur	Lebih tua, lebih besar
CKEditor	Standar modern	Kompleksitas konfigurasi
KecilMCE	Ringan	Fitur terbatas
Penyunting DHTML	Dasar	Sangat mendasar

Untuk mengganti editor:

Buka Preferensi
Gulir ke pengaturan Editor
Pilih dari dropdown
Simpan dan uji

Unggah Pengaturan Direktori

# Create upload directories
mkdir -p /path/to/xoops/uploads/publisher/
mkdir -p /path/to/xoops/uploads/publisher/categories/
mkdir -p /path/to/xoops/uploads/publisher/images/
mkdir -p /path/to/xoops/uploads/publisher/files/

# Set permissions
chmod 755 /path/to/xoops/uploads/publisher/
chmod 755 /path/to/xoops/uploads/publisher/*

Konfigurasikan Ukuran Gambar

Di Preferensi, atur ukuran thumbnail:

Category image size: 300 x 200 px
Article image size: 600 x 400 px
Thumbnail size: 150 x 100 px

Langkah Pasca Instalasi

1. Tetapkan Izin Grup

Buka Izin di menu admin
Konfigurasikan akses untuk grup:
- Anonim: Lihat saja
- Pengguna Terdaftar: Kirim artikel
- Editor: artikel Approve/edit
- Admin: Akses penuh

2. Konfigurasikan Visibilitas module

Buka block di admin XOOPS
Temukan block Penerbit:
- Penerbit - Artikel Terbaru
- Penerbit - Kategori
- Penerbit - Arsip
Konfigurasikan visibilitas block per halaman

3. Impor Konten Uji (Opsional)

Untuk pengujian, impor artikel sampel:

Buka Admin Penerbit → Impor
Pilih Contoh Konten
Klik Impor

4. Aktifkan URL SEO (Opsional)

Untuk URL yang mudah ditelusuri:

Buka Preferensi
Setel URL SEO: Ya
Aktifkan penulisan ulang .htaccess
Verifikasi file .htaccess ada di folder Publisher

# .htaccess example
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /modules/publisher/
    RewriteRule ^category/([0-9]+)-(.*)\.html$ index.php?op=showcategory&categoryid=$1 [L]
    RewriteRule ^article/([0-9]+)-(.*)\.html$ index.php?op=showitem&itemid=$1 [L]
</IfModule>

Mengatasi Masalah Instalasi

Masalah: module tidak muncul di admin

Solusi:

# Check file permissions
ls -la /path/to/xoops/modules/publisher/

# Check xoops_version.php exists
ls /path/to/xoops/modules/publisher/xoops_version.php

# Verify PHP syntax
php -l /path/to/xoops/modules/publisher/xoops_version.php

Masalah: Tabel database tidak dibuat

Solusi:

Periksa pengguna MySQL memiliki hak istimewa CREATE TABLE
Periksa log kesalahan basis data:
Terminal window
```
mysql> SHOW WARNINGS;
```

Impor SQL secara manual:

mysql -u user -p database < modules/publisher/sql/mysql.sql

Masalah: Pengunggahan file gagal

Solusi:

# Check directory exists and is writable
stat /path/to/xoops/uploads/publisher/

# Fix permissions
chmod 777 /path/to/xoops/uploads/publisher/

# Verify PHP settings
php -i | grep upload_max_filesize

Masalah: Kesalahan “Halaman tidak ditemukan”.

Solusi:

Periksa apakah file .htaccess ada
Pastikan Apache mod_rewrite diaktifkan:
Terminal window
```
a2enmod rewrite
systemctl restart apache2
```
Periksa AllowOverride All di konfigurasi Apache

Tingkatkan dari Versi Sebelumnya

Dari Penerbit 1.x ke 2.x

Cadangan instalasi saat ini:

cp -r modules/publisher/ modules/publisher-backup/
mysqldump -u user -p database > publisher-backup.sql

Unduh Penerbit 2.x

Menimpa file:

rm -rf modules/publisher/
unzip publisher-2.0.zip -d modules/

Jalankan pembaruan:
- Buka Admin → Penerbit → Perbarui
- Klik Perbarui Basis Data
- Tunggu sampai selesai
Verifikasi:
- Periksa semua artikel ditampilkan dengan benar
- Verifikasi izin utuh
- Uji unggahan file

Pertimbangan Keamanan

Izin Berkas

- Core files: 644 (readable by web server)
- Directories: 755 (browseable by web server)
- Upload directories: 755 or 777
- Config files: 600 (not readable by web)

Nonaktifkan Akses Langsung ke File Sensitif

Buat .htaccess di direktori unggahan:

<FilesMatch "\.(php|phtml|php3|php4|php5|phtml)$">
    Deny from all
</FilesMatch>

Keamanan Basis Data

# Use strong password
ALTER USER 'publisher_user'@'localhost' IDENTIFIED BY 'strong_password_here';

# Grant minimal permissions
GRANT SELECT, INSERT, UPDATE, DELETE ON publisher_db.* TO 'publisher_user'@'localhost';
FLUSH PRIVILEGES;

Daftar Periksa Verifikasi

Setelah instalasi, verifikasi:

Langkah Selanjutnya

Setelah instalasi berhasil:

Baca Panduan Konfigurasi Dasar
Buat Artikel pertama Anda
Atur Izin Grup
Tinjauan Manajemen Kategori

Dukungan & Sumber Daya

Masalah GitHub: Masalah Penerbit
Forum XOOPS: Dukungan Komunitas
GitHub Wiki: Bantuan Instalasi

#publisher #installation #setup #xoops #module #configuration