Skip to content

Web-Jose/Bulldog-Living

Repository files navigation

Bulldog-Living 🐾

Overview 🐶

Bulldog Living is a dedicated space on the Fresno State Student Housing website for showcasing articles related to events and activities within the housing community. This project aims to enhance the living experience of Fresno State students by providing an interactive and informative platform. Students can also download photos from events, fostering a sense of community.

Technologies & Tools 🛠️

  • Figma: Design mockups and UI/UX planning.
  • WordPress: Core CMS for content management and website structure.
  • Pods Framework: Custom post types and fields for dynamic content management.
  • Elementor: Page building and visual design aspects.
  • HTML, CSS, JavaScript, PHP: Front-end and back-end development for custom features and responsive design.

Features 📝

  • Custom Post Types: For managing and organizing articles and events.
  • Dynamic Content Display: Utilizing PHP for dynamic rendering of articles and event information.
  • Interactive Elements: JavaScript-powered carousel for showcasing recent articles.
  • Responsive Design: Ensures optimal viewing across various devices.

Project Files 📁

  • archive-bulldog_living.php: Main template file for the Bulldog Living section.
  • featured_articles.php: Displays the featured articles in a carousel.
  • subsequent_articles.php: Lists articles following the featured ones.
  • upcoming_events.php: Shows upcoming events from the events post type.
  • RA_events.php: Displays Resident Advisor (RA) events.

Getting Started 🚀

  • Clone the repository: git clone https://github.com/Web-Jose/Bulldog-Living.git
  • Navigate to your WordPress theme files and place in current theme directory.
  • Install required plugins (Pods Framework, Elementor) through the WordPress dashboard.
  • Create custom post types for articles and events using Pods Framework.
  • Verify the custom post types are correctly set up and displaying in the WordPress dashboard.
  • Create a new page and use Elementor to design it for the Bulldog Living archive.

Development Notes 📓

  • Custom Post Types: Created using the Pods Framework. Be familiar with Pods for extending or modifying custom post types.
  • Template Loops: PHP template loops are used for dynamically displaying articles. Understanding of PHP loops is essential for modifications.
  • JavaScript Carousel: Modifying the carousel may require JS knowledge, specifically relating to DOM manipulation and event handling.
  • CSS Modifications: For design changes, CSS files are located within the theme folder. Ensure responsive design principles are maintained.

Challenges & Solutions 🤔

  • Template Loops: Implementing a template loop for articles was initially challenging due to unfamiliarity. Resolved by researching and experimenting with different loop structures in PHP.

Contribution Guidelines 📄

  • Reporting Issues: Use GitHub Issues for reporting bugs or suggesting enhancements.
  • Submitting Pull Requests: Ensure changes are well-documented and tested on a local development environment before submitting.

Links 🔗

License 📜

This project is licensed under the MIT License - see the LICENSE.md file for details.