MyAnimeList Indonesia

Proyek ini merupakan replika dari website yang sudah ada bernama MyAnimeList.net yang saya buat menggunakan bahasa pemrograman Python dan web framework Django.

Latar Belakang

Proyek ini saya buat untuk tugas perkuliahan mobile programming. Sebenarnya platform aplikasi ini nantinya tidak berjalan atau berbentuk sebagai aplikasi web. Namun karena sempat mengalami miskomunikasi, jadi proyek ini tidak selesai sampai pada akhir kuliah mobile programming. Dan sekarang proyek aplikasi ini saya lanjutkan sendiri diluar kuliah, hanya sebagai portofolio proyek pribadi saja.

DISCLAIMER

TERKADANG JIKA ANDA MENCOBA PROYEK INI PADA LAPTOP ATAU KOMPUTER YANG BERBEDA TERDAPAT PESAN ERROR SETELAH MENJALANKAN SERVER. DAN JUGA TERKADANG MUNCUL PESAN ERROR JIKA DI PUBLISH KE SUATU WEB HOSTING. MAKA DARI ITU HARAP PERHATIKAN DENGAN SEKSAMA PESAN DAN KODE ERROR YANG MUNCUL. APABILA TIDAK SANGGUP MENYELESAIKAN ERROR, ANDA BISA MEMBACA DOKUMENTASI RESMI DJANGO ATAU MENCARI KODE ERROR PADA GOOGLE UNTUK MENYELESAIKAN PERMASALAHAN. PESAN DAN KODE ERROR YANG MUNCUL TERKADANG BERBEDA, JADI CARILAH DI INTERNET YANG SESUAI DENGAN APA YANG ANDA ALAMI.

Instalasi

Untuk ikut berkolaborasi mengembangkan proyek ini, silahkan lakukan git clone atau download menjadi zip pada halaman Github. Pastikan jika kamu juga sudah menginstal Python versi 3 di komputer atau laptopmu.

Siapkan Workspace

Buat direktori bernama anime-indo pada drive yang kamu inginkan (misalnya C, D, atau E pada OS Windows). OS lainnya bisa menyesuaikan saja dimana biasanya menaruh file pribadi dan proyek.

Dibawah ini adalah contoh struktur direktori milik saya

D:\mobile_development\anime-indonesia|____animelist\
                                     |____api\
                                     |____artikel\
                                     |____backup\
                                     |____Env\
                                     |____myanimelist\
                                     |____statics\
                                     |____templates\
                                     |____.gitignore
                                     |____manages.py
                                     |____Readme.md
                                     |____requirements.txt

Setelahnya kamu bisa melakukan pull menggunakan git pull, atau mengekstrak file zip jika kamu download menjadi zip. Tempatkan pada direktori anime-indo yang sudah dibuat.

Virtual Environment Python

Setelah sudah mendownload project, kamu perlu membuat virtual enviroment Python untuk menginstal modul yang dibutuhkan termasuk web framework Django. Dibawah ini caranya :

Buat virtual environment melalui terminal / cmd
```
D:\mobile_development\anime-indonesia> python -m venv Env
```
Maka akan muncul suatu folder bernama Env di dalam workspace kita anime-indonesia

Aktifkan mode virtual environment dengan perintah seperti ini

# Sebelum di aktifkan
D:\mobile_development\anime-indonesia> Env\Scripts\activate

# Setelah di aktifkan
(Env) D:\mobile_development\anime-indonesia>

Selanjutnya adalah menginstal modul Python yang sesuai untuk proyek ini. Supaya kita bisa menginstal bersamaan, maka pastikan file bernama requirements.txt ada di dalam folder ini.
Ketikkan perintah ini untuk mulai menginstal modul Python
```
pip install -r requirements.txt
```

Jika sudah selesai dan tidak mendapati pesan Error, selanjutnya periksa modul yang terinstal dengan perintah pip list maka akan tampil seperti ini

 Package             Version
 ------------------- ---------
 asgiref             3.6.0
 certifi             2022.12.7
 charset-normalizer  3.0.1
 dj-database-url     1.2.0
 Django              3.2.18
 django-cors-headers 3.14.0
 django-filter       22.1
 django-guardian     2.4.0
 djangorestframework 3.14.0
 idna                3.4
 Markdown            3.4.1
 mysqlclient         2.1.1
 pip                 23.0.1
 Pygments            2.14.0
 python-dotenv       1.0.0
 pytz                2022.7.1
 requests            2.28.2
 setuptools          63.2.0
 sqlparse            0.4.3
 urllib3             1.26.14

Instalasi selesai

Sebelum Menjalankan Proyek

Setelah menyelesaikan tahap instalasi, proyek ini masih belum bisa dijalankan. Ada beberapa konfigurasi yang perlu di setel sebelum menjalankan server Django, jika tidak maka proyek akan menampilkan error. Ikuti tahapan di bawah ini dengan seksama.

Membuat file environment (.env)

Buat suatu file bernama .env untuk menyimpan variabel yang dibutuhkan untuk menjalankan server Django dan DBMS MySQL. Disini saya menggunakan MySQL dari aplikasi XAMPP. Jika anda belum familiar dengan penggunaan XAMPP dan cara menginstal XAMPP Control Panel, silahkan ikuti tutorial ini. Untuk mendownload XAMPP, sikahkan kunjungi website berikut ini.

Sebelum mulai, saya akan tunjukkan bagaimana struktur folder dan juga dimana harus menyimpan file .env pada sintaks di bawah ini

(Env) D:\mobile_development\anime-indonesia|____animelist\
                                           |____api\
                                           |____artikel\
                                           |____backup\
                                           |____Env\
                                           |____myanimelist\
                                                |____.env
                                                |____asgi.py
                                                |____settings.py
                                                |____urls.py
                                                |____views.py
                                                |____wsgi.py
                                           |____statics\
                                           |____templates\
                                           |____.gitignore
                                           |____manages.py
                                           |____Readme.md
                                           |____requirements.txt

Kemudian isi file .env dengan sintaks seperti dibawah ini.

# Konfigurasi untuk Django
SECRET_KEY = "SECRET_KEY"
DEBUG = true
ALLOWED_HOSTS = ["localhost", "127.0.0.1"]

# Konfigurasi untuk MySQL
DB_NAME = "anime_indo"
DB_USER = "root" # ini adalah super user bawaan MySQL XAMPP
DB_PASS = "" # Kosongkan saja jika anda tidak set password
DB_HOST = "localhost"
DB_PORT = 3306 # Ini adalah port default untuk MySQL

Berikutnya anda harus melakukan generate secret key supaya data seperti user account dan admin account terenkripsi pada database. Jika anda tidak melakukan generate secret key, maka server akan menampilkan error. Silahkan gunakan perintah dibawah ini untuk mengenerate secret key

# 1. Masuk ke dalam Python Django shell

(Env) D:\mobile_development\anime-indonesia> django-admin shell
Python 3.10.7 (tags/v3.10.7:6cc6b13, Sep  5 2022, 14:08:36) [MSC v.1933 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>>

# 2. Kemudian ketik seperti ini

>>> from django.core.management.utils import get_random_secret_key

# 3. Tampilkan fungsi get_random_secret_key

>>> print(get_random_secret_key())

Setelah anda mendapatkan secret key berupa kombinasi angka, huruf dan karakter spesial, copy ke dalam file .env pada variabel SECRET_KEY dengan diapit tanda kutip dua.

Next Step (will be update next time)

Social Media

Jika ingin berdiskusi atau berkolaborasi untuk melanjutkan proyek ini bisa menghubungi saya, atau sekedar mampir pada sosmed-sosmed milik saya di :

Maulanawesome5/anime_indonesia