Welcome to TRAVEL EXPERIENCES! Have you ever visited a place you just have to tell everyone about? Or maybe you just want some inspiration on where to travel? Travel Experiences page is just for you. On this page you have the bragging rights and you are welcome to explore others' experiences.

Contents:

• UX (user experience)
  • Idea
  • Research and preparations
  • Wireframes
  • User stories
  • Design choices
    • Fonts
    • Colours
    • Icons
• Features
• Features left to implement
• Technologies used
• Testing
  • Bugs during development
  • User stories Testing
• Deployment
• Credits
  • Content
  • Acknowledgments and thank you's
• Disclaimer

The idea behind this project was to create a page where people can exchange their travel experiences. From grand adventures to little tips and tricks on where to dine, or a hidden spot that's not so crowded and yet a must visit. The scope of this project is to introduce the visitors to new locations for travel, and let registered users contribute to the ever-growing base of reviews.

The purpose of this page is to be an extension of a future project called Portals to Paradise, which is a page for a travel agency. On Travel experiences, any person can post a review of a place they visited as long as they are registered on the page. This way, visitors and registered users can get an inside view of a place they want to visit. The benefits of this page are:

• visitors and users can get hands on recommendations from people who already visited the place.
• by separating the two pages, it doesn't look like an ad. People are more drawn to social networks than a company trying to push its product. Even as a link, the connection to the Portals to Paradise is perfectly placed.
• a travel agency can sort through the user input and decide which travel arrangements to set up and advertise.
• thanks to a modern looking and inviting page which uses Materialize, users are drawn to contribute to the growing base of user experiences.

The first view on the page reveals experiences from random users to showcase the page and give the users an idea of how the page works. From there on, the page is intuitive and simple to use. Even if a visitor has trouble with the page, an about link is accessible from the always visible header. There's a floating icon where visitors can login, and if they are already logged in, it expands on click and gives them the option to log out, access their own profile or add a new experience in 2 clicks.

I chose to make this project because of the following:

• I like to travel.
• by separating this page from the travel agency page, people are more comfortable sharing their experiences than on some private company page.
• it creates a feeling of a social network seeing other people and exchanging experiences.
• the sense of satisfaction when contributing to the community and having control over your content.
• making an advertising page that isn't an advert and is actually giving to the users and visitors.
• useful data for the agency so they can have info on which arrangements to work on.

After visiting this page, users will be encouraged to join the community, have a better idea about the place they want to visit or maybe they would like to contribute.

Backt to top

Before starting this project, some research and these steps were taken:

• looking for a topic and inspiration on the internet, starting with Code Institute's peer-code-review on Slack
• pages I came across on the internet were sites of companies that paid a professional to write them an article. There's nothing wrong with that, but they give me an impression of an advert which I'm trying to avoid. Ads are becoming more and more intrusive and aggressive. Another reason is, if something's "ad shaped", it was paid to present information in a certain way so there's a bit of scepticism for me. However, these sites gave me some ideas how to structure my own.
• other sites were either a blog from individuals or a group within a bigger social media page.
• blogs - as they are sites of individuals. A small number of people have a decent exposure while others have to fight for it. Not to mention the variety of styles found on different pages. On Travel Experiences, everyone is a part of the community and it's easier to find info as everything is uniformed. Users have the liberty to create and modify their own content.
• Social media pages - they have a uniform look, nice UI, a sense of community, but their UI is suited for a general purpose. On my page, all the information is about traveling and the UI is tailored for it.
• from this, I decided on the following:
  • the page has to have a sense of community
  • the UI needs to serve the purpose of traveling
  • uniform and appealing look
  • ease of navigation and control of your own content
• next, mockups were generated to have an idea of how the page will look like on different platforms. You can find them in the folder Wireframes

After the initial idea, I decided to make a couple of sketches and make wireframes for different platforms to have an idea of how the page will look like on different platforms. Software used for generating mockups was Balsamiq. You can find all the wireframes in the wireframes folder.

After finishing the project, some of the design and features were changed:

• show x entries dropdown with pagination for card container has been removed. The center part was imagined as a scroll container where only 6 experiences were supposed to be shown. Due to time constrains, I decided to leave it as a feature left to implement.
• from experiences, the map container was removed as it would take too long to implement. It was also left for future features.

Backt to top

For users:

1. As a new visitor to the page, I want to be able to find inspiration for my next holiday.
2. As a person who wants to travel to Spain in the Summer, I want to find more information on Barcelona so I can plan with what kind of clothes to wear (going to the beach and to the fancy restaurant is not the same).
3. As a person who is interested in traveling to Mumbai, I want to read more from someone who has already been there.
4. As a user of this page, I want to be able to add and modify my own content so I can present it to others.
5. As a special needs person, I want to be able to contact the user who has been to Mt. Rushmore so I can find out how wheelchair accessible the place is.

For business:

1. As a company who owns the travel agency, I want to find places where people want to travel the most so I can make more popular travel arrangements
2. As a Hotel owner, I want to know if my Hotel was mentioned, so I can improve on my services or add new ones.
3. As a tourist information centre of the city of Zadar, I want to know if anyone has mentioned the city of Zadar, so we can improve on our event offers and advertising.

Backt to top

As I haven't found many examples of what I'm trying to accomplish, I decided to go with subtle colours with small touches of intense ones for certain focus areas. These focus areas are usually navigational elements. For inspiration, I used milestone projects from Code Institute's Slack channel #peer-code-review.

The following fonts were chosen:

• Permanent Marker - this font is used for titles only (h1). I wanted to use a smooth, curvy, italic font that associated with the feeling of being relaxed as this page is about relaxation and having a good time. It may look a bit rough around the edges, but it's supposed to be leisurely and like it's had enough of rules - at least for a duration of holidays.
• Oxygen - this font was used for everything else. Its lightness, as the name suggests, should give a light note to the whole page. Combining bold and regular styles with different sizes, I can differentiate accents from plain text.
• Traveling Typewriter - used only as names for form entries (Location, Travel arrangements,...) to associate with writing a diary. For credits, see credits
• Calibri - a backup font if others fail to load.

I decided to go with minimalism and a few colours. The only thing that will have accents in colour is text in navbars, floating icons and icons at the bottom of the page. Also, pictures posted by users will add some colour.

Icons were used from a FontAwesome page.

Backt to top

As per the initial idea, UI has to have a uniform and appealing look, be easy to navigate and control your own content. For this reason, multi-page concept was implemented. Thanks to Flask framework, I used templates to cut down on repetitive tasks like header and footer for the page with links to the travel agency page.

• first look at the page needs to invoke intuitiveness. Looking at some examples, I found some features I want to achieve:
  • not to overburden the first look with too much information.
  • present the core of the page and when a new visitor scrolls down the page, it reveals more features.
  • ease of navigation as more info for each experience has a "Read more..." link.
  • all of the links in the header (navbar) are always accessible (fixed position), user tools are always accessible.
  • search bar is on the home page
• About page that explains the UI and features
• search bar
• ability to sort the experiences by country, user and recommendation
• page dedicated to a single experience where people can read about it in more detail
• CRUD functionality: all registered users can Create, Read, Update and Delete content they created
• admin account to remove content that is not suitable for the page and users who are violating the rules of acceptable behaviour. Admin will not have the option to modify the users content at any point - only to delete.
• on every page there is a link to a travel agency page so people can get travel arrangements whenever they choose.
• header image is offering different features while slides change and lead to respectable addresses
• floating icon that gives direct access to user tools
• Users can create and delete their account
• Image hosting will be handled by a third-party provider. Users will have the option to upload pictures to that service as current storage capacities aren't adequate for a large number of images.

Due to time constrains, some of the features were left out so the page can be fully functional within the deadline. Afterwards, the following features can be added:

• More in-depth user profile page: email, date of birth, location,... This was left out as GDPR requires to inform the users how the data is handled. Incorporating GDPR compliance would take more time, so the users are defined only by user name and password.
• A maps container so the location of the experience can be seen.
• Voting system - registered users will be able to add their vote to the experience they find motivating, inspiring, well written, ... This can be used for users to filter out best and worst experiences other people had and either look for a travel arrangement for ones they like, or change their plans. The travel company can use this system to make travel arrangements based on the highest voted experiences.
• Communication between users - On each experience description there will be an option to contact the user who created the experience. Only registered users will have this option. Also, this will also be used if admin has to delete some content and let the user know what they did wrong.
• Delete user with all experiences. Most people just forget about their profile all together, so the admin account is here to delete their experiences. Deleting all experiences would require more time to implement, but within the scope of this project, this will suffice.

Backt to top

• HTML5
• CSS3
• JavaScript
• JSON
• Python

• JQuerry
• Flask 1.1.2
• Pymongo 3.10.1
• Jinja2 2.11.2
• Cloudinary 1.21.0
• Git
• Materialize
• Google fonts
• Font Awesome
• Heroku
• GitHub
• MongoDB
• Balsamiq
• VS Code
• W3C Markup
• W3C CSS
• jshint

Backt to top

• Test links to all pages
• Test errors by typing in random page redirects
• Try to access the user area without signing in
• Test filtering dropdowns
• Test searching
• Test Read more...
• Test account registration
• Test create new experience forms
• Test add / del experiences
• Test add image
• Test update experience
• Test delete experience
• Test log out
• Test sign in
• Test admin page

While testing on various screen sizes on desktop pc, I noticed that close to screen size breaks, some elements don't look visually appealing. For that reason, I removed certain elements you can see in wireframes.

Also screen sizes below 350px don't look visually appealing. I didn't address this as screens of these sizes are rare.

On iPad Mini with Safary, I've noticed that edit button in profile page has strange colour effect, but the button itself is working fine.

Backt to top

List of bugs found:

• Description: wrong country displayed in home page

  • How I found it: after submitting a new experience and comming back to the home page, country name was a number instead of full name
  • What went wrong: dropdown menu had value field which overwrote the country name
  • Resolution: renamed value to country_id later replaced the country dropdown menu with Country selector with flags (see credits below)

• Description: Page crashed after clicking on Add experience button

  • How I found it: after implementing the filter to show only users experiences in their profile
  • What went wrong: cancel button which redirected to profile page, didn't have username to refer to
  • Resolution: added user name for the call in the button

• Description: Odd text appeared on the left side if datamod template was used

  • How I found it: found it after clicking on Read more..., addxp and editxp
  • What went wrong: if/elif/else loop
  • Resolution: removed if/elif/else loop and set block form in datamod. This way each page that has to add, edit and show experiences has it's own form

• Description: Page kept crashing because there was no cloud_name

  • How I found it: after clicking on New experience
  • What went wrong: cloudinary.config wasn't set properly
  • Resolution: added clodinary.config to app.py

• Description: Page kept crashing after clicking on submit button after experience was edited

  • How I found it: after submitting changes to experience
  • What went wrong: in app.py update request had parameter of update_one instead of update
  • Resolution: removed _one from request

• Description: When testing image upload, browser kept notifying about form resubmission. This resulted in repeated image uploads

  • How I found it: when working on the image upload function
  • What went wrong: browser kept uploading the image each time Confirm form resubmission displayed
  • Resolution: added upload_result = None to imageupload function before post method

• Description: Button for New didn't work on homepage

  • How I found it: After editing image processing pages
  • What went wrong: element of type button had an anchor link which didn't work
  • Resolution: converted button element into anchor element with class of btn

• Description: Error after updating the experience

  • How I found it: After editing the experience and submitting it
  • What went wrong: editxp() function had unnecessary variables in brackets
  • Resolution: Removed imagelink and public_id from brackets and also variables of the same name within the function. Also added enctype="multipart/form-data" to the form in editxp.html

• Description: After loging in and going to My Profile page, experiences were shown from all users with ability to add and delete them

  • How I found it: By loging in and going to My profile page
  • What went wrong: While deleting commented out code, I accidentally deleted for loop in profile.html that filters experiences by user {% if session.user|lower == experience.created_by|lower %}
  • Resolution: Went back to Github to compare the code and restored the missing parts. Learned that Flask ignores HTML comment markers for its own code.

Backt to top

For users:

1. As a new visitor to the page, I want to be able to find an inspiration for my next holiday.
   • This is fulfilled with just arriving on this page as there are experiences from people presented right on the home page. If this isn't enough, there is a search bar right below the banner image.
2. As a person who wants to travel to Spain in the Summer, I want to find more information on Barcelona so I can plan with what kind of clothes to wear (going to the beach and to the fancy restaurant is not the same).
   • User entries cover their own experiences and a visitor will find something they are looking for. One of the future features will be messaging between users so they can register and send a message with a direct question.
3. As a person who is interested in traveling to India, I want to read more from someone who has already been there.
   • If a solution from a previous user story doesn't work, it is highly likely that someone has already been to India and they can use the search feature to read through the experiences or even filter them by country
4. As a user of this page, I want to be able to add and modify my own content so I can present it to others.
   • this is possible due to MongoDB as all entries are saved there so they can be shared with others and details edited afterwards. Some entries cannot be left empty even when editing.
5. As a special needs person, I want to be able to contact the user who has been to Mt. Rushmore so I can find out how wheelchair accessible the place is.
   • User story 2 answer applies here too: when messaging gets implemented and after registering/logging in, user will be able to contact another user and ask a direct question.

For business:

1. As a company who owns the travel agency, I want to find places where people want to travel the most so I can make more popular travel arrangements
   • There isn't yet a filter that can sort the countries by most visited, but one of the future implementations is a voting system. Subsequently, there will be a feature to sort the experiences by how much votes they have.
2. As a Hotel owner, I want to know if my Hotel was mentioned, so I can improve on my services or add new ones.
   • Using the search tool, anyone can search through the data base and find the term they are looking for.
3. As a tourist information centre of the city of Zadar, I want to know if anyone has mentioned the city of Zadar, so we can improve on our event offers and advertising.
   • With the search engine, anyone can filter out a desired keyword and read through the experiences that contain this keyword.

Backt to top

The repository for this project is hosted on GitHub and uses Heroku to serve the site to the world wide web. If you would like to contribute to this project you would need to first have some sort of online code editor like Gitpod or local such as VS Code. Also you will need some version control software like Git. For Git, you will also need a GitHub account.

In order to contribute to this repository, you will need to have the following installed:

• Python 3.8.3 or higher
• Git version control
• Code editor - Gitpod or VS Code are recommended

There are a number of steps required to deploy a local version of this project.

• At the top of the repository click on the Code button and select Download zip
• Copy the path to the repo "https://github.com/Vlad-404/travel_experiences"
• Navigate to the folder where you would like to make a copy of this repository - "c:\My Documents\MyRepo..." and save.
• Start VS Code and click on "File -> Open Folder..."
• Navigate to the downloaded files "c:\My Documents\MyRepo..." and click on "Select Folder"
• If you don't have your environment set up, please refer to the VS Code documentation
• Install all the dependencies by typing in the terminal: pip3 install -r requirements.txt
• If you add or update any new packages to the project use pip freeze --local > requirements.txt to update the requirements.txt file with the new dependencies.

You will need to setup the following environment variables on your system.

Note: you will need to add these environment variable to your GitHub repo in "env.py" and Heroku in "settings -> config vars"

Backt to top

The easiest way to deploy the project to Heroku is to set your connect method to GitHub and link the repository master branch. If you set the project up for automatic deploys, it will deploy once the master branch is updated.

Back to top

Travel Experiences site was developed on GitPod and VS code, using GitHub and Heroku to host the repository. As GitHub pages cannot host dynamic pages, for this purpose I used Heroku.

When deploying Travel Experiences using Heroku, the following steps were taken:

Linking the Heroku and GitHub:

• Log in to Heroku and GitHub
• Make sure you have admin privileges on GitHub
• Go to Heroku and select Travel Experiences app
• Click on Deploy and in Deployment method, select GitHub(Connect to GitHub)
• Select repository to connect to
• Enter repo name in the empty field and click on search. Be sure your repo exists on GitHub and that you typed it in correctly.
• When repo shows click on "Connect"
• Your Heroku app will be synchronised each time you "git push"
• Travel Experiences are now live on Heroku. To run the site, click on "Open App" at the top

Backt to top

Traveling Typewritter font made by Carl Krull from http://www.onlinewebfonts.com oNline Web Fonts is licensed by CC BY 3.0.

During development, you will notice users of name test01,test02,... These were my test accounts with which I tested the functionality of the site. Images in these experiences belong to me. Images from other users belong to their respective owners.

• Huge thank you to Tim Nelson (tim_ci) from Code Institute for redoing flask mini project videos. I used his validateMaterializeSelect(); function to make the country field mandatory. You can find it in script.js.
• CI student by the name of Frozenaught whose site Homechopped served as an inspiration to my project.
• Code for coutry selector dropdown in addxp.html and editxp.html used from mrmarkfrench and his Country selector project. More info here.
• Code for dynamic image preview for image upload taken from Webtrickshome

Backt to top

This page was built for educational purposes and all resources were used under fair usage and/or under free licence! If you find any content that violates the copyrights, please contact me on vmijat21@gmail.com

Thank you for visiting my page and I hope you'll have fun sharing your Travel Experiences.

Backt to top