Research Overview Page

Relevant source files

The following files were used as context for generating this wiki page:

• research/overview.php
• apps/js/iite_components.js
• apps/translations.json
• themes/css/design.css
• iite/overview.php
• index.php
• apps/pages.php

The research/overview.php file acts as the server-side entry point for the "Research and Development" overview page. Its primary responsibility is to set the page's HTML title and orchestrate the rendering of the page content by including the appropriate PHTML template files. It follows a standard PHP output buffering pattern seen across other pages in the application, such as iite/overview.php.

The page is integrated into the site's main navigation structure, with its corresponding text labels managed through a central JSON file for internationalization. However, client-side JavaScript indicates that the navigation link to this section is currently a placeholder.

Page Rendering Flow

The server-side logic for rendering the research overview page is straightforward. It uses PHP's output buffering to capture the HTML generated by a specific view template and injects it into a global site layout.

Sources: research/overview.php, index.php:17-19

The diagram below illustrates the server-side rendering process initiated by a request to research/overview.php.

Key Steps

1. Title Definition: The page's <title> tag is hardcoded to "The Research | Institute Itech™". Unlike other pages (e.g., iite/overview.php), it does not use the t() translation function for the title.
   Sources: research/overview.php:3, iite/overview.php:11
2. Content Inclusion: The primary content for the page is generated by the themes/apps/research/overview.phtml template.
   Sources: research/overview.php:7
3. Layout Wrapping: The generated content is then passed to the main site layout file, themes/components/statics/layout.phtml, which provides the common header, footer, and navigation structure.
   Sources: research/overview.php:11

Navigation and Client-Side Routing

The "Research and Development" section is a primary category in the website's main navigation bar. The navigation structure and associated text are defined in apps/translations.json.

Sources: apps/translations.json:200-204

User Navigation Sequence

The following diagram shows the sequence of events when a user interacts with the "research" link in the navigation bar.

The client-side JavaScript in iite_components.js handles clicks on navigation elements. Currently, the handler for the research page is configured to navigate to #, effectively making it a dead link that does not load a new page.

// File: apps/js/iite_components.js

pages.forEach(page => {
    page.addEventListener('click', () => {
        // ... other cases
        } else if (page.dataset.page === 'research') {
            location.href = "#";
        } 
        // ... other cases
    });
});

Sources: apps/js/iite_components.js:5-13

Research Navigation Menu Items

The apps/translations.json file defines the text for the primary "Research" navigation tab and its associated sub-menu items for multiple languages.

Translation Key	English Text	Description
navbar_primary_research	research and development	The main navigation tab label.
navbar_secondary_ricerca_sviluppo_generale	General Research	Sub-menu item for general research.
navbar_secondary_ricerca_sviluppo_sanitaria	Health Research	Sub-menu item for health research.
navbar_secondary_ricerca_sviluppo_tecnologica	Technological Research	Sub-menu item for technological research.
navbar_secondary_ricerca_sviluppo_avanzata	Advanced Research	Sub-menu item for advanced research.
navbar_secondary_ricerca_sviluppo_generale_dev	General Development	Sub-menu item for general development.
navbar_secondary_ricerca_sviluppo_sociale	Social Development	Sub-menu item for social development.
navbar_secondary_ricerca_sviluppo_urbano	Urban Development	Sub-menu item for urban development.
navbar_secondary_ricerca_sviluppo_etica_autonomia	Ethics & Research Autonomy	Sub-menu item for ethics and autonomy.
navbar_secondary_ricerca_sviluppo_opportunita_giovani	Youth Opportunities	Sub-menu item for youth opportunities.
navbar_secondary_ricerca_sviluppo_ricerca_etica	Ethical Research	Sub-menu item for ethical research.

Sources: apps/translations.json:200-254

The styling for the research menu dropdown is defined in themes/css/design.css under the .researchamenu class.

Sources: themes/css/design.css:201

Summary of Related Files

The table below summarizes the roles of the files involved in rendering and interacting with the Research Overview page.

File Path	Role
research/overview.php	Main PHP entry point. Sets page title and manages the rendering pipeline.
apps/js/iite_components.js	Contains client-side logic for navigation. Defines the click behavior for the "research" link.
apps/translations.json	Stores all internationalized text strings, including navigation labels for the research section.
themes/css/design.css	Provides specific CSS styles for the navigation menus, including the research dropdown.
apps/pages.php	Defines page titles for the translation system, though not used by research/overview.php.
index.php	Provides the generic page loading structure and translation functions used by other pages.

Sources: research/overview.php, apps/js/iite_components.js, apps/translations.json, themes/css/design.css, apps/pages.php, index.php