Editing Shared Resources for New PHP-Based Websites

<p class="alert alert-warning">The information in this article is deprecated.</p>

== Setup ==

* Remote Desktop to server
* IIS Manager > website > right click > Add Virtual Directory
** Alias: Same name as shared resource directory
** Physical Path: Location shared resource directory (<code>d:/inetpub/develop/littledamien/common_lib</code>)
** Connect As: Specific user > Windows account

== Resources ==

In order to be able to integrate these files using virtual directories on dev, it’s necessary that they reside in directories with unique names.

So PHP base classes for site content are in the shared directory <code>[COMMON_LIB]/_classes/content/</code> and derived classes representing site content are placed in <code>[APP_BASE_DIR]/_classes/site_content/</code>.
===PHP classes===
Located in <code>[COMMON_LIB]/_classes/</code>
*content
*database
*filters
*images
*keywords
*login
*navigation menu (?)
*utilities

=== JavaScript ===

Located in <code>[COMMON_LIB]/scripts/</code>
* Littled libraries
* JQuery form data plugin (handles binary data)
* JQuery scrolling plugin
* Twitter Bootstrap tooltips (CDN):<br />`<link href="//netdna.bootstrapcdn.com/twitter-bootstrap/2.3.2/css/bootstrap-combined.min.css" rel="stylesheet">`<br />`<script src="//netdna.bootstrapcdn.com/twitter-bootstrap/2.3.2/js/bootstrap.min.js"></script>`
* TinyMCE libraries

=== AJAX scripts ===

Located in <code>[COMMON_LIB]/_ajax/</code>
* Image and album utilities (edit, delete, upload, etc.)
* General utilities
** [[JQuery_Initialization_on_Listings_Pages#Inline_edits|Inline edits of names, dates, access, etc]]
** Resorting listings
** Editing keywords inline
** Update cache

===PHP template files===

Located in <code>[COMMON_LIB]/_templates/</code>
*Album and gallery listings, details, and pagination
*Image popup
*Keywords cell content
*Form elements for inline edits of discrete information (names, access, dates, keywords, etc.)
*Progress wheel
*Form elements for editing and deleting albums, galleries, and images
*Navigation elements
**Gallery page links
**Generalized listings page links
**CMS navigation
**Neighboring record links
**Page buttons (<code>single_listings_page_link.php</code>)

===CMS pages===

Located in <code>[COMMON_LIB]/hostmgr/</code>
*Site content properties CMS
*Requirements
**<code>site_sections</code> and <code>section_operations</code> tables
**“CMS Content Sections” record in <code>site_content</code> table with id 27.

===image directories===

*Image destination specified through content properties.
<syntaxhighlight lang="sql">
site_section.image_dir
</syntaxhighlight>
*Size variation locations:
**<code>[IMAGE_ROOT_DIR]/med/</code>
**<code>[IMAGE_ROOT_DIR]/mini/</code>

===images===

*<code>/images/process-wheel.png</code>
*<code>/images/buttons/edit-image.png</code>
*<code>/images/buttons/delete.png</code>

==PHP Config Settings==

*<code>APP_COMMON_DIR</code> – Base directory for shared resources<br />(This will be a different location on dev and production.)
*<code>COMMON_CLASS_DIR</code> – Location of shared PHP classes: <code>APP_COMMON_DIR + "_classes/"</code>
*<code>COMMON_TEMPLATE_DIR</code> – Location of shred PHP template files: <code>APP_COMMON_DIR + "_templates"</code>
*JavaScript can be accessed through virtual directories as if shared resources existed within the local web directory.

==Uploading to Production==
For each of the [[Shared Resources for New PHP-Based Websites#resources|resources]] listed above, upload files from <code>//littledamienii/develop/littledamien/common_lib</code>, integrating them into the website directories of on the production server.

[[Category:Project Documentation]] [[Category:CMS Documentation]] [[Category:Git]] [[Category:Web Development]]