Meridio - File Hosting Social Media(July 2017)

Meridio is a filehosting and filesharing platform with an inbuilt messaging/chatting application.

Meridio - A Walkthrough

Merídio(Greek-Share) is a free Filehosting platform where users can host their own repositories of files/videos/images etc and thus make it available for download by any of the registered members of the website.The key aim is to create a network of users who can host items in their repositories and allow other people to access the repository contents and also download stuff from others repositories.Merídio also has an inbuilt chat feature where you can add friends via requests and chat with your friends.

Signup and Login Page

Meridio prompts you for some user details for sign up. These are the starting steps in the creation of a user profile. Once the user signs up they can login and use the features as when they like.If the user doesnt remember their password forgot password prompts a new system generated password to be sent to the user on their registered email.

Profile Page

The profile page has 4 navigational tabs which allow the user to switch between managing their personal info, managing their network of friends and managing the files that they have uploaded to their repositories.

Personal Information

This interface allows the user to modify their profile information and their avatar.

Uploading files to repository and removing current files

User can use the Materials tab to upload files to the repository using the Share button. This interface also consists of a list of the files currently hosted.The user can remove any file required by using the remove button(remove button not visible in the photo illustration)

Managing friend requests sent and recieved

The Request tab allows the user to view all the incoming friend requests and sent friend requests and manage these requests.

View all Friends

The last tab of the profile section the Network tab allows the user to see all of their current friends.

Ping:The Meridio Chat Application

On the top navigation panel the Ping tab takes the user to the chat application where the user can. The user can chat with any friend and the most recent chats are pulled to the top automatically. The search bar allows the user to search any of their networks.The search returns a list of closely matched usernames among the user's current networks.

The Sharing Zone and Repository Structure

The sharing zone contains all the repositories present on the website.The user can click on any of the repositories or use the go to panel to directly go to any repository.

Repository internal structure

Each repository has a list of all the files uploaded by the owner of that repository along with information such as the total number of downloads and views tagged along with each file. Each file list element has a preview and a download button. The preview button directs the user to a new page where the preview of the file(music,images,pdfs,vidoes etc) is generated. The download button downloads that file. Each repository also has a button Send Request to send a friend request from the user to the owner of the repository the user is currently browsing.

Thats about it all to get you started with meridio,the free file hosting social media.

Technologies used

1. Django Framework
   
2. Bootstrap
   
3. Python
   
4. JavaScript/JQuery
   

Libraries Used

1. Bootstrap
   
2. Typed.js and animate.css for animations
   

How to contribute?

Cloning the repo

• Go to the repository you want to clone and click on fork.
• Copy the URL from your forked repo by going to the 'Clone and Download' option.
• Run git/terminal and execute the follwing to clone the repository to your local machine and navigate to the project folder

$ git clone <THE COPIED URL>
$ cd <PATH TO THE PROJECT>

Adding ,Deleting and Editing files

• Make the necessary changes to project folder. You can add files to the directory and can also edit/delete existing files.
• Add the files edited/added using the add command

$ git add <Name of file added/edited>

• You can also add all files in a single go by using

$ git add .

• You can verify that your files will be added when you commit by checking the status of the current stage

$ git status

• We are ready to commit. Note that the commit action only commits to your local repository.

$ git commit -m "MESSAGE you want"

• Now we are ready to push

 $ git push <Remote Repositor eg. Origin> <BRANCH eg. master>

Creating a pull request

• On GitHub, navigate to the main page of the repository.
• To the right of the Branch menu, click New pull request.
• On the next page, click compare across forks.
• Type a title and description for your pull request.
• Click Create pull request.
  Now you are done.Happy Contribution!!!

Installation guide

Cloning the repo

• Run git/terminal and execute the follwing to clone the repository to your local machine and navigate to the project folder

$ git clone https://github.com/NJACKWinterOfCode/Meridio.git
$ cd Meridio

Installing and activating virtual environment

• Install local environment on your local machine by typing the following in terminal/command prompt

$ pip install virtualenv

Activation of virtual environment on Windows

• In command prompt type the following to activate the virtual environment

 $ mkvirtualenv my_project

• If you restart the command prompt to run virtual environment again type

 $ workon my_project

Activation of virtual environment on linux/Mac

• Create a virtual environment for a project

$ cd my_project_folder
$ virtualenv my_project

• To begin the virtual environment activate it using the following command

$ source my_project/bin/activate

Install Dependencies

• To install files required to run the project execute the following command

$ pip install -r requirements.txt 

Run the project

• To run the project finally type

$ python manage.py runserver

You are done.Cheers!!!