contentdb/app/templates/packages/view.html

{% set query=package.name %}

{% extends "base.html" %}

{% block title %}
	{{ package.title }}
{% endblock %}

{% block headextra %}
	<meta name="og:title" content="{{ package.title }}"/>
	<meta name="og:description" content="{{ package.short_desc }}"/>
	<meta name="description" content="{{ package.short_desc }}"/>
	<meta name="og:url" content="{{ package.getDetailsURL(absolute=True) }}"/>
	{% if package.getMainScreenshotURL() %}
	<meta name="og:image" content="{{ package.getMainScreenshotURL(absolute=True) }}"/>
	{% endif %}
{% endblock %}

{% block container %}
	{% if not package.license.is_foss and not package.media_license.is_foss and package.type != package.type.TXP  %}
		{% set package_warning="Non-free code and media" %}
	{% elif not package.license.is_foss and package.type != package.type.TXP %}
		{% set package_warning="Non-free code" %}
	{% elif not package.media_license.is_foss %}
		{% set package_warning="Non-free media" %}
	{% endif %}
	{% set release = package.getDownloadRelease() %}

	<header class="jumbotron pb-3"
		style="background: linear-gradient(rgba(0, 0, 0, 0.4), rgba(0, 0, 0, 0.7)), url('{{ package.getMainScreenshotURL() }}');
			background-size: cover;
			background-repeat: no-repeat;
			background-position: center;">
		<div class="container">
			<h1 class="display-3">
				{{ package.title }}
			</h1>

			<p class="lead">
				{{ package.short_desc }}
			</p>

			<p>
				{% if package_warning %}
					<a class="badge badge-danger" href="/help/non_free/">
						<i class="fas fa-exclamation-circle" style="margin-right: 0.3em;"></i>
						{{ package_warning }}
					</a>
				{% endif %}
				{% for t in package.tags %}
					<a class="badge badge-primary"
						href="{{ url_for('packages.list_all', tag=t.name) }}">{{ t.title }}</a>
				{% endfor %}
			</p>

			<div class="info-row row" style="margin-top: 2rem;">
				<div class="btn-group-horizontal col">
					<a class="btn" href="{{ url_for('users.profile', username=package.author.username) }}">
						<i class="fas fa-user"></i>
						<span class="count">
							{{ package.author.display_name }}
						</span>
					</a>
					<a class="btn" rel="nofollow" href="{{ package.getDownloadURL() }}">
						<i class="fas fa-download"></i>
						<span class="count">{{ package.downloads }}</span>
					</a>
					<a class="btn" href="{{ url_for('threads.list_all', pid=package.id) }}">
						<i class="fas fa-comment-alt"></i>
						<span class="count">{{ threads | length }}</span>
					</a>
					{% if package.website %}
						<a class="btn" href="{{ package.website }}">
							<i class="fas fa-globe-europe"></i>
							<span class="count">{{ _("Website") }}</span>
						</a>
					{% endif %}
					{% if package.repo %}
						<a class="btn" href="{{ package.repo }}">
							<i class="fas fa-code"></i>
							<span class="count">{{ _("Source") }}</span>
						</a>
					{% endif %}
					{% if package.forums %}
						<a class="btn" href="https://forum.minetest.net/viewtopic.php?t={{ package.forums }}">
							<i class="fas fa-comments"></i>
							<span class="count">{{ _("Forums") }}</span>
						</a>
					{% endif %}
					{% if package.issueTracker %}
						<a class="btn" href="{{ package.issueTracker }}">
							<i class="fas fa-bug"></i>
							<span class="count">{{ _("Issue Tracker") }}</span>
						</a>
					{% endif %}
				</div>
				{% if release and (release.min_rel or release.max_rel) %}
					<div class="btn col-md-auto">
						<img src="https://www.minetest.net/media/icon.svg" style="max-height: 1.2em;">
						<span class="count">
							{% if release.min_rel and release.max_rel %}
								{{ _("%(min)s - %(max)s", min=release.min_rel.name, max=release.max_rel.name) }}
							{% elif release.min_rel %}
								{{ _("%(min)s and above", min=release.min_rel.name) }}
							{% elif release.max_rel %}
								{{ _("%(max)s and below", max=release.max_rel.name) }}
							{% endif %}
						</span>
					</div>
				{% endif %}
				<div class="btn-group-horizontal col-md-auto">
					{% if release %}
						<a class="btn btn-download btn_green" rel="nofollow"
								href="{{ package.getDownloadURL() }}">
							{{ _("Download") }}
						</a>
					{% else %}
						<i>
							{{ _("No downloads available") }}
						</i>
					{% endif %}
				</div>
			</div>
		</div>
	</header>

	<main class="container mt-4">
		{% if not package.approved %}
			<div class="alert alert-warning">
				<span class="icon_message"></span>
				{% if package.releases.count() == 0 %}
					<h4 class="alert-heading">Release Required</h4>
					{% if package.checkPerm(current_user, "MAKE_RELEASE") %}
						<p>You need to create a release before this package can be approved.</p>
						<p>
							A release is a single downloadable version of your {{ package.type.value | lower }}.
							You need to create releases even if you use a rolling release development cycle,
							as Minetest needs them to check for updates.
						</p>
						<a class="btn" href="{{ package.getCreateReleaseURL() }}">Create Release</a>
					{% else %}
						A release is required before this package can be approved.
					{% endif %}

				{% elif (package.type == package.type.GAME or package.type == package.type.TXP) and package.screenshots.count() == 0 %}
					You need to add at least one screenshot.

				{% elif topic_error_lvl == "danger" %}
					Please fix the below topic issue(s).

				{% elif "Other" in package.license.name or "Other" in package.media_license.name %}
					Please wait for the license to be added to CDB.

				{% else %}
					{% if package.screenshots.count() == 0 %}
						<b>You should add at least one screenshot, but this isn't required.</b><br />
					{% endif %}

					{% if not package.getDownloadRelease() %}
						Please wait for the release to be approved.
					{% elif package.checkPerm(current_user, "APPROVE_NEW") %}
						<form class="float-right"  method="post" action="{{ package.getApproveURL() }}">
							<input type="hidden" name="csrf_token" value="{{ csrf_token() }}" />
							<input class="btn btn-sm btn-warning" type="submit" value="Approve" />
						</form>
						You can now approve this package if you're ready.
					{% else %}
						Please wait for the package to be approved.
					{% endif %}
				{% endif %}
				<div style="clear: both;"></div>
			</div>

			{% if topic_error %}
				<div class="alert alert-{{ topic_error_lvl }}">
					<span class="icon_message"></span>
					{{ topic_error | safe }}
					<div style="clear: both;"></div>
				</div>
			{% endif %}

			{% if similar_topics %}
				<div class="alert alert-warning">
					Please make sure that this package has the right to
					the name '{{ package.name }}'.
					See the
					<a href="/policy_and_guidance/">Inclusion Policy</a>
					for more info.
				</div>
			{% endif %}

			{% if not review_thread and (package.author == current_user or package.checkPerm(current_user, "APPROVE_NEW")) %}
				<div class="alert alert-info">
					<a class="float-right btn btn-sm btn-info" href="{{ url_for('threads.new', pid=package.id, title='Package approval comments') }}">Open Thread</a>

					Privately ask a question or give feedback
					<div style="clear:both;"></div>
				</div>
			{% endif %}
		{% endif %}

		<aside class="float-right ml-4" style="width: 18rem;">
			<div class="card mb-4">
				<div class="card-header">
					Details
					<div class="btn-group float-right">
					{% if package.checkPerm(current_user, "EDIT_PACKAGE") %}
						<a class="btn btn-primary btn-sm ml-1" href="{{ package.getEditURL() }}"><i class="fas fa-edit"></i></a>
					{% endif %}
					{# {% if current_user.is_authenticated %}
						<a class="btn btn-primary btn-sm ml-1" href="{{ package.getCreateEditRequestURL() }}">Suggest Changes</a>
					{% endif %} #}
					{% if package.checkPerm(current_user, "DELETE_PACKAGE") or package.checkPerm(current_user, "UNAPPROVE_PACKAGE") %}
						<a class="btn btn-danger btn-sm ml-1" href="{{ package.getRemoveURL() }}"><i class="fas fa-trash"></i></a>
					{% endif %}
					</div>
				</div>

				{% if package_warning %}
					<div class="card-body">
						<div class="alert alert-danger">
							<a href="/help/non_free/" class="float-right">Info</a>
							<b>Warning:</b> {{ package_warning }}
						</div>
					</div>
				{% endif %}
				<table class="table">
					<tr>
						<td>Type</td>
						<td>{{ package.type.value }}</td>
					</tr>
					<tr>
						<td>Name</td>
						<td>{{ package.name }}</td>
					</tr>
					{% if package.provides %}
					<tr>
						<td>Provides</td>
						<td>{% for meta in package.provides %}
							<a class="badge badge-primary"
							 href="{{ url_for('metapackages.view', name=meta.name) }}">{{ meta.name }}</a>
						{% endfor %}</td>
					</tr>
					{% endif %}
					<tr>
						<td>License</td>
						<td>
							{% if package.license == package.media_license %}
								{{ package.license.name }}
							{% elif package.type == package.type.TXP %}
								{{ package.media_license.name }}
							{% else %}
								{{ package.license.name }} for code,<br />
								{{ package.media_license.name }} for media.
							{% endif %}
						</td>
					</tr>
					<tr>
						<td>Added</td>
						<td>{{ package.created_at | datetime }}</td>
					</tr>
					<tr>
						<td>Maintainers</td>
						<td>
							{% if package.checkPerm(current_user, "EDIT_MAINTAINERS") %}
								<a class="btn btn-primary btn-sm ml-1 float-right" href="{{ package.getEditMaintainersURL() }}"><i class="fas fa-edit"></i></a>
							{% endif %}

							{% for user in package.maintainers %}
								<a class="badge badge-primary"
									href="{{ url_for('users.profile', username=user.username) }}">
									{{ user.display_name }}
								</a>
							{% endfor %}

							{% if current_user in package.maintainers and current_user != package.author %}
								<form class="mt-2"  method="post" action="{{ package.getRemoveSelfMaintainerURL() }}">
									<input type="hidden" name="csrf_token" value="{{ csrf_token() }}" />
									<input class="btn btn-sm btn-link p-0" type="submit" value="{{ _("Remove myself") }}" />
								</form>
							{% endif %}
						</td>
					</tr>
				</table>
			</div>

			{% if package.author.donate_url %}
				<div class="alert alert-secondary">
					Like {{ package.author.display_name }}'s work?
					<a href="{{ package.author.donate_url }}" rel="nofollow">Donate now!</a>
				</div>
			{% endif %}

			{% if package.type == package.type.MOD %}
				<div class="card my-4">
					<div class="card-header">Dependencies</div>
					<div class="card-body">
						<div class="card-subtitle mb-2 text-muted">{{ _("Required") }}</div>
						{% for dep in package.getSortedHardDependencies() %}
							{%- if dep.package %}
								<div					</div class="badge badge-primary"
										href="{{ dep.package.getDetailsURL() }}">
									{{ dep.package.title }} by {{ dep.package.author.display_name }}
							{% elif dep.meta_package %}
								<a class="badge badge-primary"
										href="{{ url_for('metapackages.view', name=dep.meta_package.name) }}">
									{{ dep.meta_package.name }}
							{% else %}
								{{ "Excepted package or meta_package in dep!" | throw }}
							{% endif %}</a>
						{% else %}
							<i>No required dependencies</i>
						{% endfor %}

						{% set optional_deps=package.getSortedOptionalDependencies() %}
						{% if optional_deps %}
    						<div class="card-subtitle my-2 text-muted">{{ _("Optional") }}</div>
							{% for dep in optional_deps %}
								{%- if dep.package %}
									<a class="badge badge-secondary"
											href="{{ dep.package.getDetailsURL() }}">
										{{ dep.package.title }} by {{ dep.package.author.display_name }}
								{% elif dep.meta_package %}
									<a class="badge badge-secondary"
											href="{{ url_for('metapackages.view', name=dep.meta_package.name) }}">
										{{ dep.meta_package.name }}
								{% else %}
									{{ "Excepted package or meta_package in dep!" | throw }}
								{% endif %}</a>
							{% endfor %}
						{% endif %}
					</div>
				</div>
			{% endif %}

			<div class="card my-4">
				<div class="card-header">
					Releases
					{% if package.checkPerm(current_user, "MAKE_RELEASE") %}
						<div class="btn-group float-right">
							<a class="btn btn-primary btn-sm ml-1" href="{{ package.getBulkReleaseURL() }}">
								<i class="fas fa-wrench"></i>
								{{ _("Bulk") }}
							</a>
							<a class="btn btn-primary btn-sm ml-1" href="{{ package.getCreateReleaseURL() }}"><i class="fas fa-plus"></i></a>
						</div>
					{% endif %}
				</div>
				<ul class="list-group list-group-flush">
					{% for rel in releases %}
						{% if rel.approved or package.checkPerm(current_user, "MAKE_RELEASE") or package.checkPerm(current_user, "APPROVE_RELEASE")  %}
							<li class="list-group-item">

								{% if package.checkPerm(current_user, "MAKE_RELEASE") or package.checkPerm(current_user, "APPROVE_RELEASE")  %}
									<a class="btn btn-sm btn-primary float-right" href="{{ rel.getEditURL() }}">Edit
									{% if not rel.task_id and not rel.approved and package.checkPerm(current_user, "APPROVE_RELEASE") %}
										/ Approve
									{% endif %}
									</a>
								{% endif %}

								{% if not rel.approved %}<i>{% endif %}

								<a href="{{ rel.getDownloadURL() }}" rel="nofollow">{{ rel.title }}</a>

								<span style="color:#ddd;">
									{% if rel.min_rel and rel.max_rel %}
										[MT {{ rel.min_rel.name }}-{{ rel.max_rel.name }}]
									{% elif rel.min_rel %}
										[MT {{ rel.min_rel.name }}+]
									{% elif rel.max_rel %}
										[MT &le;{{ rel.max_rel.name }}]
									{% endif %}
								</span>

								<br>

								<small style="color:#999;">
									{% if rel.commit_hash %}
											[{{ rel.commit_hash | truncate(5, end='') }}]
									{% endif %}

									created {{ rel.releaseDate | date }}.
								</small>
								{% if (package.checkPerm(current_user, "MAKE_RELEASE") or package.checkPerm(current_user, "APPROVE_RELEASE")) and rel.task_id %}
									<a href="{{ url_for('tasks.check', id=rel.task_id, r=package.getDetailsURL()) }}">Importing...</a>
								{% elif not rel.approved %}
									Waiting for approval.
								{% endif %}

								{% if not rel.approved %}</i>{% endif %}

							</li>
						{% endif %}
					{% else %}
						<li class="list-group-item">No releases available.</li>
					{% endfor %}
				</ul>
			</div>

			<div class="card my-4">
				<div class="card-header">
					{% if package.approved and package.checkPerm(current_user, "CREATE_THREAD") %}
						<div class="btn-group float-right">
							<a class="btn btn-primary btn-sm mx-1" href="{{ url_for('threads.new', pid=package.id) }}"><i class="fas fa-plus"></i></a>
						</div>
					{% endif %}
					Threads
				</div>
				<ul class="list-group list-group-flush">
					{% from "macros/threads.html" import render_threadlist %}
					{{ render_threadlist(threads, list_group=True) }}
				</ul>
			</div>

			{% if package.approved and package.checkPerm(current_user, "CREATE_THREAD") and current_user != package.author and not current_user.rank.atLeast(current_user.rank.EDITOR) %}
				<a class="float-right"
					href="{{ url_for('threads.new', pid=package.id) }}">
						Report a problem with this listing
				</a>
			{% endif %}
		</aside>

		{% if not package.approved and (package.author == current_user or package.checkPerm(current_user, "APPROVE_NEW")) %}
			{% if review_thread %}
				<h2>{% if review_thread.private %}&#x1f512;{% endif %} {{ review_thread.title }}</h2>
				{% if review_thread.private %}
					<p><i>
						This thread is only visible to the package owner and users of
						Editor rank or above.
					</i></p>
				{% endif %}

				{% from "macros/threads.html" import render_thread %}
				{{ render_thread(review_thread, current_user) }}
			{% endif %}
		{% endif %}

		<ul class="screenshot_list mb-4">
			{% for ss in package.screenshots %}
				{% if ss.approved or package.checkPerm(current_user, "ADD_SCREENSHOTS") %}
					<li>
						<a href="{% if package.checkPerm(current_user, 'ADD_SCREENSHOTS') %}{{ ss.getEditURL() }}{% else %}{{ ss.url }}{% endif %}">
							<img src="{{ ss.getThumbnailURL() }}" alt="{{ ss.title }}" />
						</a>
					</li>
				{% endif %}
			{% endfor %}
			{% if package.checkPerm(current_user, "EDIT_PACKAGE") %}
				<li>
					<a href="{{ package.getNewScreenshotURL() }}">
						<div class="fas fa-plus screenshot-add"></div>
					</a>
				</li>
			{% endif %}
		</ul>

		{{ package.desc | markdown }}

		<div style="clear: both;"></div>

		<h3>Ratings and Reviews</h3>

		{% from "macros/reviews.html" import render_reviews, render_review_form, render_review_preview %}
		{% if current_user.is_authenticated %}
			{% if has_review %}
				<p>
					<a class="btn btn-primary" href="{{ package.getReviewURL() }}">
						{{ _("Edit Review") }}
					</a>
				</p>
			{% elif current_user in package.maintainers %}
				<p>
					{{ _("You can't review your own package.") }}
				</p>
			{% else %}
				{{ render_review_form(package, current_user) }}
			{% endif %}
		{% else %}
			{{ render_review_preview(package) }}
		{% endif %}
		{{ render_reviews(package.reviews, current_user) }}

		{#
			{% if current_user.is_authenticated or requests %}
				<h3>Edit Requests</h3>

				<ul>
					{% for r in requests %}
						<li>
							<a href="{{ r.getURL() }}">{{ r.title }}</a>
							by
							<a href="{{ url_for('users.profile', username=r.author.username) }}">{{ r.author.display_name }}</a>
						</li>
					{% else %}
						<li>No edit requests have been made.</li>
					{% endfor %}
				</ul>
			{% endif %}
		#}

		{% if alternatives %}
			<h3>Related</h3>

			{% from "macros/packagegridtile.html" import render_pkggrid %}
			{{ render_pkggrid(alternatives) }}
		{% endif %}

		{% if similar_topics %}
			<h3>Similar Forum Topics</h3>
			<ul>
				{% for t in similar_topics %}
					<li>
						[{{ t.type.value }}]
						<a href="https://forum.minetest.net/viewtopic.php?t={{ t.topic_id }}">
							{{ t.title }} by {{ t.author.display_name }}
						</a>
						{% if t.wip %}[WIP]{% endif %}
					</li>
				{% endfor %}
			</ul>
		{% endif %}
	</main>
{% endblock %}