{"id":18386265,"url":"https://github.com/bethropolis/suplike-social-website","last_synced_at":"2025-04-07T00:33:03.503Z","repository":{"id":41889397,"uuid":"315542988","full_name":"bethropolis/suplike-social-website","owner":"bethropolis","description":"a full self-hosted social network, easy to setup, backend API, Moderation, Admin dashboard, Developer console, bots, plugins and more. ","archived":false,"fork":false,"pushed_at":"2024-04-16T06:26:55.000Z","size":22164,"stargazers_count":17,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-16T08:34:39.789Z","etag":null,"topics":["bootstrap4","php","pwa","self-hosted","social","social-media","social-network","social-network-api","social-website","suplike","web-application","xampp"],"latest_commit_sha":null,"homepage":"https://bethro.alwaysdata.net","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bethropolis.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-11-24T06:46:39.000Z","updated_at":"2024-01-07T18:20:04.000Z","dependencies_parsed_at":"2023-10-15T18:54:22.988Z","dependency_job_id":"97b7c539-b663-4271-b82e-a6bcb835e57b","html_url":"https://github.com/bethropolis/suplike-social-website","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bethropolis%2Fsuplike-social-website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bethropolis%2Fsuplike-social-website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bethropolis%2Fsuplike-social-website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bethropolis%2Fsuplike-social-website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bethropolis","download_url":"https://codeload.github.com/bethropolis/suplike-social-website/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223267744,"owners_count":17116697,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap4","php","pwa","self-hosted","social","social-media","social-network","social-network-api","social-website","suplike","web-application","xampp"],"created_at":"2024-11-06T01:21:15.653Z","updated_at":"2025-04-07T00:33:03.488Z","avatar_url":"https://github.com/bethropolis.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"![logo](img/suplike.png)\n\n# hello welcome to suplike\n\n\n![suplike](https://img.shields.io/badge/project-suplike%20%F0%9F%92%9C-%236c5ce7)\n[![github](https://badgen.net/badge/icon/github?icon=github\u0026label)](https://github.com/bethropolis/suplike-social-website)\n![watch](https://img.shields.io/github/stars/bethropolis/suplike-social-website.svg)\n[![CodeFactor](https://www.codefactor.io/repository/github/bethropolis/suplike-social-website/badge)](https://www.codefactor.io/repository/github/bethropolis/suplike-social-website)\n![code](https://badgen.net/github/license/micromatch/micromatch)\n\n\u003cp\u003e\n suplike social is a feature rich fully open source social network.\u003cbr /\u003e\n\n\n it's made using \u003cb\u003e PHP/HTML/JS/CSS\u003c/b\u003e \u003cbr /\u003e\n  \n\nit's easy to install and [setup](#installation);\n\n\n\n# Table of Contents\n\n- [hello welcome to suplike](#hello-welcome-to-suplike)\n- [Table of Contents](#table-of-contents)\n- [getting started](#getting-started)\n  - [Installation](#installation)\n      - [Requirements](#requirements)\n    - [Installation Steps](#installation-steps)\n  - [setup and configure database](#setup-and-configure-database)\n    - [using the GUI](#using-the-gui)\n    - [incase GUI doesn't work](#incase-gui-doesnt-work)\n  - [Components](#components)\n      - [Languages](#languages)\n      - [Development Environment](#development-environment)\n      - [DBMS (optional)](#dbms-optional)\n- [versions](#versions)\n- [features](#features)\n  - [Mobile UI](#mobile-ui)\n  - [live messaging/chat system (whole new look)](#live-messagingchat-system-whole-new-look)\n  - [home page](#home-page)\n  - [profile page](#profile-page)\n  - [login/signup system](#loginsignup-system)\n  - [search page](#search-page)\n  - [following page](#following-page)\n  - [image and text post](#image-and-text-post)\n  - [like \\\u0026 follow system](#like--follow-system)\n  - [Developer Page](#developer-page)\n  - [other user pages](#other-user-pages)\n  - [Admin dashboard](#admin-dashboard)\n    - [you can do the following on the dashboard](#you-can-do-the-following-on-the-dashboard)\n- [inspiration](#inspiration)\n- [behind it all](#behind-it-all)\n- [License](#license)\n\n\n\n# getting started\n\n## Installation\n\n#### Requirements\n\n- PHP\n- Apache server\n- MySQL Database\n- phpMyAdmin (optional)\n\n\u003e All of these requirements can be completed at once by simply installing a server stack like `Wamp` or `Xampp` etc.\n\n### Installation Steps\n\n1. Download the latest release file.\n  \n  | File                                                                                                                          | Description                | Size   |\n  | ----------------------------------------------------------------------------------------------------------------------------- | -------------------------- | ------ |\n  | [v1.5.1 zip file](https://github.com/bethropolis/suplike-social-website/releases/download/1.5.1/compressed-suplike-v1.5.1.zip)| Latest release zip file    | 1.4 MB |\n  | [v1.5.1 tar file](https://github.com/bethropolis/suplike-social-website/releases/download/1.5.1/compressed-suplike-v1.5.1.tar)| Latest release tar.gz file | 3.0 MB |\n  | [v1.5.1 installer-script.php](https://github.com/bethropolis/suplike-social-website/releases/download/1.5.1/installer-script.php)| installer script        | 2 kB   |\n\n\n unzip the file and extract all the files into your `htdocs` or `www` directory depending on what you are using. (installer script does this automatically)\n   \u003e I recommend renaming the extracted folder to `suplike` (the url will be shorter).\n\n\n2. if you choose to use the installer script then first you need to download the script into your server folder then run the following command.\n\n```bash\n  php installer-script.php\n```\n\n\u003cbr/\u003e\n\n3. you can clone the repository to your `htdocs` or `www` folder. \n\n```bash\n  git clone https://github.com/bethropolis/suplike-social-website.git suplike\n```\n\n\u003e now you are ready to setup.\n\n## setup and configure database\n\n### using the GUI\n\nthe GUI is a nicer interface which will automatically setup the database and create admin account for you easily.\n\n![GUI](_githubasserts/gui.png)\n\u003cbr\u003e\nThe GUI should open by default on the first time you run the app. If it doesn't then on the browser navigate to `{HOST_URL}/suplike/inc/setup/`.\n\non the GUI you insert the credentials to your database and admin account after which you will automatically be logged in as admin.\n\n\n\n\u003e please note in the url, replace `suplike` with what you named the folder or the folders name (also remove if the app is on the root directory).\n\u003e \u003cbr\u003e\n\n### incase GUI doesn't work\n\n1. Edit the `inc/setup/setup.suplike.json` and `inc/setup/env.php` file and set the value of `\"setup\"` to `false` then reopen the GUI in your browser again.\n\n2. Do it Manually, create a database `suplike` and Import the `suplike.sql` file in the `sql` folder into phpMyAdmin. There is no need for any change in the .sql file. Next, change the following part of code below in the  `inc/setup/env.php`  to the respective database credentials.\n\n```php\n if (!defined('DB_DATABASE'))        define('DB_DATABASE', 'suplike');\n if (!defined('DB_HOST'))            define('DB_HOST','localhost');\n if (!defined('DB_USERNAME'))        define('DB_USERNAME', 'root');\n if (!defined('DB_PASSWORD'))        define('DB_PASSWORD', '');\n if (!defined('DB_PORT'))            define('DB_PORT',3306);\n```\n\n\u003e you'll also manually have to change you account to admin account in the database.\n\n## Components\n\n#### Languages\n\n```\nPHP 8.0+\nSQL 14.0+\nJavaScript ES 6\nHTML5\nCSS3\n```\n\n#### Development Environment\n\n```\napache 2.4+\nMYSQL 9.0+\n```\n\n#### DBMS (optional)\n\n```\nphpMyAdmin 5.0+\n```\n\n\n# versions\n\ncheck `HISTORY.md` or [releases](https://github.com/bethropolis/suplike-social-website/releases)\n\n\u003cp\u003e\n  more improvements will continue to be done to this project please stay and watch 👀.\n\u003c/p\u003e\n\n# features\n\n\n## Mobile UI\n\n![Alt text](_githubasserts/mobile.png)\n\nThe app is mobile friendly and responsive.\nthe app's themes can easily be changed\n\n## live messaging/chat system (whole new look)\n\u003cdetails open\u003e\n\u003csummary\u003eread more\u003c/summary\u003e\n\n![Alt text](_githubasserts/messages.png)\n\nin previous version, one of the issues was that the messaging page was just\na page. Live messaging was not well supported and you could not choose who to chat with until\nyou clicked message on their profile page. But in the new version, the entire code was re writen and the\nwhole of that is gone, you can chat with the people you follow\nand it is more mobile responsive than previous and the only client page that uses Vuejs.\n\u003c/details\u003e\n\n\n\n\n## home page\n\u003cdetails open\u003e\n\u003csummary\u003eread more\u003c/summary\u003e\n\n![Alt text](_githubasserts/10.png)\nthe home page is the main page where you can see post from some of the people you follow\nand the first page you will land on after authentication.\n\u003c/details\u003e\n\n## profile page \n\u003cdetails  open\u003e\n\u003csummary\u003eread more\u003c/summary\u003e\n\n![Alt text](_githubasserts/3.png) \naccess to your profile page and other users profile page.\n\u003c/details\u003e\n\n\n## login/signup system\n\u003cdetails  open\u003e\n\u003csummary\u003eread more\u003c/summary\u003e\n\n ![Alt text](_githubasserts/7.png)\nyou will have login or sign up to full use the app features.\n\u003c/details\u003e\n\n## search page\n\u003cdetails  open\u003e\n\u003csummary\u003eread more\u003c/summary\u003e\n\n![Alt text](_githubasserts/6.png)\n\nthe search page is where you can search for users for now.\n\n\u003c/details\u003e\n\n\n## following page\n\u003cdetails  open\u003e\n\u003csummary\u003eread more\u003c/summary\u003e\n\n![Alt text](_githubasserts/4.png)\n\nThe following page is where you can vue the users you follow (for now);\n\n\u003c/details\u003e\n\n\n\n\n\n## image and text post\n\nyou can currently only post either an image or text\nlikely more in new versions to come.\n\n\n## like \u0026 follow system\n\nyou can like a post or unlike it, comment and share are still not functional but the\nlike system is fully working together with the follow system and\nbothare perfect and most secure.\n\n## Developer Page\nThe Developer Page empowers you to create API keys and Bots, which can be utilized on the `/api/v1` endpoint. These tools allow you to extend the functionality, incorporate additional features, and enhance the user experience.\n\n![Alt text](_githubasserts/dev.png)\n \n\n\n## other user pages\nother pages include comments page, post page, settings page, topics page, stories page and notifications page.\n\n## Plugins (beta feature)\nwith plugins you can extend the functionality of the app and add more features to the app.\n\n\nthe plugin ui is on the admin dashboard. \n\n\n\n## Admin dashboard\n\u003cdetails  open\u003e\n\u003csummary\u003eread more\u003c/summary\u003e\n\n![Alt text](_githubasserts/dashboard.png)\nThe Admin Dashboard allows you to see analytics and perform moderation functions\u003cbr\u003e\n\n### you can do the following on the dashboard\n\n- see post,visits,activities analytics\n- moderate\n- install/uninstall plugins\n- see new users and old users\n- users online\n- edit default app theme, name and configurations\n- view the app logs\n- email configuration\n- api configurations\n- Plugin support.\n\n\n\n\u003c/details\u003e\n\n\n\n# inspiration\n\nmy biggest inspiration to make this app was was the [KLIK social website](https://github.com/msaad1999/KLiK-SocialMediaWebsite) on github, thank you [msaad1999](https://github.com/msaad1999) for making an amazing project.\n\n\n# behind it all\n\nHi, I am bethuel. This is a favourite project of mine that I really enjoy making, I made it 3 years ago as a way to help me learn programming.\n hope you like it.\n\n\nmore versions are to come check `HISTORY.md` for more. \u003cbr/\u003e\nif you like to contribute please don't mind sending a pull request I will\ncheck it out, all ideas aloud.\n\n \u003cimg src=\"./_githubasserts/myicon.jpg\" width=\"100px\"\u003e\n\n[bethropolis](https://github.com/bethropolis)\n\n# License\n\nit is licensed under my favourate License [MIT license](https://mit-license.org/) _(do what you want :)_.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbethropolis%2Fsuplike-social-website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbethropolis%2Fsuplike-social-website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbethropolis%2Fsuplike-social-website/lists"}