diff --git a/dash_labs/plugins/archive/pages_original.py b/dash_labs/plugins/archive/pages_original.py
new file mode 100644
index 0000000..73525c7
--- /dev/null
+++ b/dash_labs/plugins/archive/pages_original.py
@@ -0,0 +1,400 @@
+from dash import callback, Output, Input, html, dcc
+import dash
+import os
+import importlib
+from collections import OrderedDict
+import json
+import flask
+from os import listdir
+from os.path import isfile, join
+from textwrap import dedent
+from urllib.parse import parse_qs
+
+if not os.path.exists("pages"):
+ raise Exception("A folder called `pages` does not exist.")
+
+_ID_CONTENT = "_pages_plugin_content"
+_ID_LOCATION = "_pages_plugin_location"
+_ID_DUMMY = "_pages_plugin_dummy"
+
+page_container = html.Div(
+ [dcc.Location(id=_ID_LOCATION), html.Div(id=_ID_CONTENT), html.Div(id=_ID_DUMMY)]
+)
+
+
+def register_page(
+ module,
+ path=None,
+ name=None,
+ order=None,
+ title=None,
+ description=None,
+ image=None,
+ redirect_from=None,
+ layout=None,
+ **kwargs,
+):
+ """
+ Assigns the variables to `dash.page_registry` as an `OrderedDict`
+ (ordered by `order`).
+
+ `dash.page_registry` is used by `pages_plugin` to set up the layouts as
+ a multi-page Dash app. This includes the URL routing callbacks
+ (using `dcc.Location`) and the HTML templates to include title,
+ meta description, and the meta description image.
+
+ `dash.page_registry` can also be used by Dash developers to create the
+ page navigation links or by template authors.
+
+ - `module`:
+ The module path where this page's `layout` is defined. Often `__name__`.
+
+ - `path`:
+ URL Path, e.g. `/` or `/home-page`.
+ If not supplied, will be inferred from `module`,
+ e.g. `pages.weekly_analytics` to `/weekly-analytics`
+
+ - `name`:
+ The name of the link.
+ If not supplied, will be inferred from `module`,
+ e.g. `pages.weekly_analytics` to `Weekly analytics`
+
+ - `order`:
+ The order of the pages in `page_registry`.
+ If not supplied, then the filename is used and the page with path `/` has
+ order `0`
+
+ - `title`:
+ The name of the page . That is, what appears in the browser title.
+ If not supplied, will use the supplied `name` or will be inferred by module,
+ e.g. `pages.weekly_analytics` to `Weekly analytics`
+
+ - `description`:
+ The <meta type="description"></meta>.
+ If not supplied, then it will be the same as the title.
+
+ - `image`:
+ The meta description image used by social media platforms.
+ If not supplied, then it looks for the following images in `assets/`:
+ - A page specific image: `assets/<title>.<extension>` is used, e.g. `assets/weekly_analytics.png`
+ - A generic app image at `assets/app.<extension>`
+ - A logo at `assets/logo.<extension>`
+
+ - `redirect_from`:
+ A list of paths that should redirect to this page.
+ For example: `redirect_from=['/v2', '/v3']`
+
+ - `layout`:
+ The layout function or component for this page.
+ If not supplied, then looks for `layout` from within the supplied `module`.
+
+ - `**kwargs`:
+ Arbitrary keyword arguments that can be stored
+
+ ***
+
+ `page_registry` stores the original property that was passed in under
+ `supplied_<property>` and the coerced property under `<property>`.
+ For example, if this was called:
+ ```
+ register_page(
+ 'pages.historical_outlook',
+ name='Our historical view',
+ custom_key='custom value'
+ )
+ ```
+ Then this will appear in `page_registry`:
+ ```
+ OrderedDict([
+ (
+ 'pages.historical_outlook',
+ dict(
+ module='pages.historical_outlook',
+
+ supplied_path=None,
+ path='/historical-outlook',
+
+ supplied_name='Our historical view',
+ name='Our historical view',
+
+ supplied_title=None,
+ title='Our historical view'
+
+ supplied_description=None,
+ description='Our historical view',
+
+ supplied_order=None,
+ order=1,
+
+ supplied_layout=None,
+ layout=<function pages.historical_outlook.layout>,
+
+ custom_key='custom value'
+ )
+ ),
+ ])
+ ```
+
+ """
+ # COERCE
+ # - Set the order
+ # - Inferred paths
+ page = dict(
+ module=module,
+ supplied_path=path,
+ path=(path if path is not None else _filename_to_path(module)),
+ supplied_name=name,
+ name=(name if name is not None else _filename_to_name(module)),
+ )
+ page.update(
+ supplied_title=title,
+ title=(title if title is not None else page["name"]),
+ )
+ page.update(
+ supplied_description=description,
+ description=(description if description is not None else page["title"]),
+ order=order,
+ supplied_order=order,
+ supplied_layout=layout,
+ **kwargs,
+ )
+ page.update(
+ image=(image if image is not None else _infer_image(module)),
+ supplied_image=image,
+ )
+ page.update(redirect_from=redirect_from)
+
+ dash.page_registry[module] = page
+
+ if layout is not None:
+ # Override the layout found in the file set during `plug`
+ dash.page_registry[module]["layout"] = layout
+
+ # set home page order
+ order_supplied = any(p["supplied_order"] is not None for p in dash.page_registry.values())
+
+ for p in dash.page_registry.values():
+ p["order"] = 0 if p["path"] == "/" and not order_supplied else p["supplied_order"]
+
+ # sorted by order then by module name
+ page_registry_list = sorted(
+ dash.page_registry.values(),
+ key=lambda i: (str(i.get("order", i["module"])), i["module"]),
+ )
+
+ dash.page_registry = OrderedDict([(p["module"], p) for p in page_registry_list])
+
+dash.register_page = register_page
+
+
+def _infer_image(module):
+ """
+ Return:
+ - A page specific image: `assets/<title>.<extension>` is used, e.g. `assets/weekly_analytics.png`
+ - A generic app image at `assets/app.<extension>`
+ - A logo at `assets/logo.<extension>`
+ """
+ # TODO - Make sure we don't need to use __name__?
+ page_id = module.split(".")[-1]
+ files_in_assets = []
+ if os.path.exists("assets"):
+ files_in_assets = [f for f in listdir("assets") if isfile(join("assets", f))]
+ app_file = None
+ logo_file = None
+ for fn in files_in_assets:
+ fn_without_extension = fn.split(".")[0]
+ if fn_without_extension == page_id or fn_without_extension == page_id.replace(
+ "_", "-"
+ ):
+ return fn
+
+ if fn_without_extension == "app":
+ app_file = fn
+
+ if fn_without_extension == "logo":
+ logo_file = fn
+
+ if app_file:
+ return app_file
+
+ return logo_file
+
+
+def _filename_to_name(filename):
+ return filename.split(".")[-1].replace("_", " ").capitalize()
+
+
+def _filename_to_path(filename):
+ return filename.replace("_", "-").replace(".", "/").lower().split("pages")[-1]
+
+
+def plug(app):
+ # Import the pages so that the user doesn't have to.
+ # TODO - Do validate_layout in here too
+ dash.page_registry = OrderedDict()
+
+ # Updated from using glob.iglob to using os.walk to ensure that the function works for Windows users
+ for (root, dirs, files) in os.walk("pages"):
+ for file in files:
+ if file.startswith("_") or not file.endswith(".py"):
+ continue
+ page_filename = os.path.join(root, file).replace("\\", "/")
+ _, _, page_filename = page_filename.partition("pages/")
+ page_filename = page_filename.replace(".py", "").replace("/", ".")
+ page_module = importlib.import_module(f"pages.{page_filename}")
+
+ if f"pages.{page_filename}" in dash.page_registry:
+ dash.page_registry[f"pages.{page_filename}"]["layout"] = getattr(
+ page_module, "layout"
+ )
+
+ @app.server.before_first_request
+ def router():
+ @callback(
+ Output(_ID_CONTENT, "children"),
+ Input(_ID_LOCATION, "pathname"),
+ Input(_ID_LOCATION, "search"),
+ prevent_initial_call=True,
+ )
+ def update(pathname, search):
+ path_id = app.strip_relative_path(pathname)
+ query_parameters = _parse_query_string(search)
+ layout = None
+ for module in dash.page_registry:
+ page = dash.page_registry[module]
+ if path_id == app.strip_relative_path(page["path"]):
+ layout = page["layout"]
+
+ if layout is None:
+ if "pages.not_found_404" in dash.page_registry:
+ layout = dash.page_registry["pages.not_found_404"]["layout"]
+ else:
+ layout = html.H1("404")
+
+ if callable(layout):
+ print("Calling...")
+ print(query_parameters)
+ return layout(**query_parameters)
+ else:
+ return layout
+
+ # Set validation_layout and prefix component IDs and callbacks with module name
+ for module in dash.page_registry:
+ app.validation_layout = html.Div(
+ [
+ page["layout"]() if callable(page["layout"]) else page["layout"]
+ for page in dash.page_registry.values()
+ ]
+ + [app.layout]
+ )
+
+ # Update the page title on page navigation
+ path_to_title = {
+ page["path"]: page["title"] for page in dash.page_registry.values()
+ }
+ path_to_description = {
+ page["path"]: page["description"] for page in dash.page_registry.values()
+ }
+ path_to_image = {
+ page["path"]: page["image"] for page in dash.page_registry.values()
+ }
+
+ app.clientside_callback(
+ f"""
+ function(path) {{
+ document.title = {json.dumps(path_to_title)}[path] || 'Dash'
+ }}
+ """,
+ Output(_ID_DUMMY, "children"),
+ Input(_ID_LOCATION, "pathname"),
+ )
+
+ # Set index HTML for the meta description and page title on page load
+ def interpolate_index(**kwargs):
+ image = path_to_image.get(flask.request.path, "")
+ if image:
+ image = app.get_asset_url(image)
+
+ return dedent(
+ """
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>{title}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {metas}
+ {favicon}
+ {css}
+
+
+ {app_entry}
+
+
+