{"id":25187209,"url":"https://github.com/ahmedmeshref/alu_blog","last_synced_at":"2025-05-07T14:30:04.158Z","repository":{"id":49638630,"uuid":"244198487","full_name":"ahmedmeshref/ALU_Blog","owner":"ahmedmeshref","description":"ALU_Blog is an online platform built to connect all communities at ALU under one platform to share news and opportunities.","archived":false,"fork":false,"pushed_at":"2021-06-30T21:10:39.000Z","size":5194,"stargazers_count":5,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-31T11:01:36.582Z","etag":null,"topics":["css","flask","flask-sqlalchemy","html5","jinja2","postgresql","python"],"latest_commit_sha":null,"homepage":"https://alublog.herokuapp.com/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahmedmeshref.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-03-01T18:04:56.000Z","updated_at":"2022-08-17T21:07:18.000Z","dependencies_parsed_at":"2022-09-19T15:20:26.287Z","dependency_job_id":null,"html_url":"https://github.com/ahmedmeshref/ALU_Blog","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedmeshref%2FALU_Blog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedmeshref%2FALU_Blog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedmeshref%2FALU_Blog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedmeshref%2FALU_Blog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahmedmeshref","download_url":"https://codeload.github.com/ahmedmeshref/ALU_Blog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252895371,"owners_count":21821148,"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":["css","flask","flask-sqlalchemy","html5","jinja2","postgresql","python"],"created_at":"2025-02-09T19:45:14.298Z","updated_at":"2025-05-07T14:30:04.109Z","avatar_url":"https://github.com/ahmedmeshref.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ALU_Blog\n__Version 1.0.0__\n\nThe African Leadership University is growing with two communities, one in Rwanda and another in Mauritius. \nFrom an institutional level, both campuses might be well linked and growing together under one institution. \nBut, from the students' perspective, each community is separated and there doesn’t exist one platform that \nbrings both communities together to facilitate and encourage the process of communication between members, \nopportunities and experience sharing between students, … etc. ALU Blog platform is meant to be a joint to \nlink both communities together under one platform with all staff and students from both campuses together\n to share and discuss news, opportunities, issues, … etc.\n\n## Installation\n**Be sure to use the same version of the code as the version of the docs you're reading.** \nYou probably want the latest tagged version, but the default Git version is the master branch. ::\n\n```bash\n# clone the repository\n$ git clone https://github.com/ahmedmeshref/ALU_Blog.git \n# navigate to the directory of the downloaded folder\n$ cd ALU_Blog\n```\n\n**Setup your database**\n\nOpen SQL shell\n```bash\n# create a new database from sql shell\n$ CREATE DATABASE ALU_Blog;\n``` \n\n**Use the package manager [pip](https://pip.pypa.io/en/stable/) to install all required libraries.**\n\n```bash\n# install all required packages from the requirements file\n$ pip install -r requirements.txt\n```\n**Edit Configuration file**\n\nEdit the following attributes from the config file\n\n- SECRET_KEY = 'Use any random 16 characters'\n- SQLALCHEMY_DATABASE_URI = \"postgresql://UserName:Password@localhost:5432/ALU_Blog\"\n- MAIL_USERNAME = \"Your Gmail username\"\n- MAIL_PASSWORD = \"Your Gmail password\"\n\n\n**Run**\n```bash\n$ python app.py\n```\nOpen http://127.0.0.1:5000 in a browser.\n\n\n## Instructions\n- If you use the register page, then the system will create an end \nuser account\n- For super admin, register and then change your account to a super admin\nusing sql \n- To add admins, you need to be register as a super admin.\n\n## Deployment ``Heroku``\n\n\u003e To deploy the website on Heroku \n\n__Install guinicorn locally__\n```\n$ pip install gunicorn\n```\n__Install Heroku CLI__\n\nhttps://devcenter.heroku.com/articles/heroku-cli\n\n__Login via CLI__\n```\n$ heroku login\n```\n\n__Create app__\n```\n$ heroku create alublog\n```\n\n__Create database__\n```\n$ heroku addons:create heroku-postgresql:hobby-dev --app alublog\n```\n\n__Get URI__\n```\n$ heroku config --app alublog\n\n# set the BADATBASE_URI to the output \n```\n\n__Deploy with Git__\n```\n$ git add . \n$ git commit -m 'Final Deploy'\n$ heroku git:remote -a alublog\n$ git push heroku master\n```\n\n__Add table to remote database__\n```\n$ heroku run python\n$ from blog import db\n$ db.create_all()\n$ exit()\n```\n\n__Visit app__\n```\n# command will direct you to the website\n$ heroku open\n```\n\n## Built With\n\n* [Flask](https://flask.palletsprojects.com/en/1.1.x/) - The web framework used\n* [Postgresql](https://www.postgresql.org/) - Database management system\n* [JavaScript](https://devdocs.io/javascript/) - Used for async communication between the front-end and back-end\n* [Jinja2](https://jinja.palletsprojects.com/en/2.11.x/) - Used for creating templates \n* [Bootstrap](https://getbootstrap.com/) - Used for styling the html \n\n\n## Contributing\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\nPlease make sure to update tests as appropriate.\n\n## Authors\n* **Ahmed Meshref** - *Initial work* - [AhmedMeshref](https://github.com/ahmedmeshref)\n\n## License\n[MIT](https://choosealicense.com/licenses/mit/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmedmeshref%2Falu_blog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahmedmeshref%2Falu_blog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmedmeshref%2Falu_blog/lists"}