Agora is a Web Application project for the "Web Programming" exam for Univaq(IT).
Agora is a Social Network that utilizes PHP, Doctrine ORM and Smarty.
This app would is intended as a project to lean how to design web applications, using the principles of the MVC Pattern and show the potential of our team in the engineering field.
Agorà is a Social Network Web Application, in which users can share their experience, mood, hobby, thoughts and much more. The "Agora" in the Ancient Greek city was a central public space. It is the best representation of a city-state's response to accomodate the social and the political order of the polis. We took inspiration from this for our application. Every user can create Post and enrich it with photos. But as everythings in the life, there is competition: Top 3 Users (users with the most follower) will be VIP Users.
Installation on local server requirements:
- Install xampp (XAMPP Download) on your machine (inlcluding php)
- Install composer(Composer Download) on your machine
-
Download the git repository;
-
Move the repositoy under
htdocs/folder in Xampp and rename the folderAgora -
Now you need to install Doctrine ORM, to do that you need to open terminal in the folder of your application (that will be in
xampp/htdocs/Agora) and runcomposer installin the prompt -
Once you installed DoctrineORM, you need to modify some code in
vendor/folder; invendor/doctrine/orm/src/Configuration.php' at line 170 approximately there is a function callednewDefaultAnnotationDriver`. You have to modify it like this:
public function newDefaultAnnotationDriver($paths = [], $useSimpleAnnotationReader = false, bool $reportFieldsWhereDeclared = false)
{
Deprecation::trigger(
'doctrine/orm',
'https://github.com/doctrine/orm/pull/9443',
'%s is deprecated, call %s::createDefaultAnnotationDriver() instead.',
__METHOD__,
ORMSetup::class
);
if (! class_exists(AnnotationReader::class)) {
throw new LogicException(
'The annotation metadata driver cannot be enabled because the "doctrine/annotations" library'
. ' is not installed. Please run "composer require doctrine/annotations" or choose a different'
. ' metadata driver.'
);
}
$reader = new AnnotationReader();
if (class_exists(ArrayCache::class) && class_exists(CachedReader::class)) {
$reader = new CachedReader($reader, new ArrayCache());
}
return new AnnotationDriver(
$reader,
(array) $paths,
$reportFieldsWhereDeclared
);
}-
In the application you can find a folder called
config, in this folder locate a file calledconfig.phpand change the parameters according to your xampp and mysql settings -
Now it's all setup open your browser and digit in the URL
localhost/Agoraand enjoy the application -
Doctrine Usage And App Info For Doctrine usage there is a
README.mdfile in theconfigfolder -
For Linux Users Only To make the application work on your terminal you must enable write, read and execute permissions on all the files present in the application. I recommend using
chmod -R a+rwe path-to-Agora-directorycommand to eneable all the permission.Check that all files inside 7717 the folders have all permissions enabled. If they don't have them you can use the previous command directly on the affected folders. Check especially if the folder (and files) found inlibs/Smarty/templates_chave the right permission. Once you set all the permissions everything should work.
This application contains two instances of the "Agora" app: one that uses ORM technologies and one that uses standard SQL. In the config folder you can find the guide on how to switch between apps.
This app also has the "Moderator View". In the root folder you will find a file called admin.php: this file allows you to add a moderator in the application (of course you can change the parameters as you like, and you have to run the script). Once you have added a moderator, to access the moderator view, you have to access the page localhost/Agora/Moderator/login and enter the credentials you have set.
Among the technologies used there are also those related to WebSockets. These add extra features to the application, such as seeing how many users are online or the real-time location of an online user and much more. To enable these features you need to run the websocket_server.php script and leave it in the background. Since the application is installed locally, to take advantage of these features, one way is to run Agora on two different browsers with two different users and test the various features.