div class="ui attached table segment"> 
@@ -0,0 +1,29 @@
1 
+from abc import ABC, abstractmethod
2 
+
3 
+class PostRepository(ABC):
4 
+
5 
+    @abstractmethod
6 
+    def list(self, page=1, per_page=10, order_by="-created"): pass
7 
+
8 
+    @abstractmethod
9 
+    def add(self, post): pass
10 
+
11 
+    @abstractmethod
12 
+    def get(self, post_id): pass
13 
+
14 
+    @abstractmethod
15 
+    def update(self, post):
16 
+        """Update an existing post."""
17 
+        pass
18 
+
19 
+    @abstractmethod
20 
+    def delete(self, post_id):
21 
+        """Delete a post by its ID."""
22 
+        pass
23 
+
24 
+
25 
+    @abstractmethod
26 
+    def search(self, query: str): pass
27 
+
28 
+    @abstractmethod
29 
+    def rate_post(self, post_id, user_id, rating: int): pass

+ 11 - 0
commu/interfaces/user_repository.py
Bestand weergeven 

@@ -0,0 +1,11 @@
1 
+from abc import ABC, abstractmethod
2 
+
3 
+class UserRepository(ABC):
4 
+    @abstractmethod
5 
+    def add(self, user): pass
6 
+
7 
+    @abstractmethod
8 
+    def get(self, user_id): pass
9 
+
10 
+    @abstractmethod
11 
+    def find_by_username(self, username): pass

+ 0 - 0
commu/tests/__init__.py
Bestand weergeven


BIN
commu/tests/__pycache__/__init__.cpython-310.pyc
Bestand weergeven


BIN
commu/tests/__pycache__/__init__.cpython-311.pyc
Bestand weergeven


BIN
commu/tests/__pycache__/test_post_repository.cpython-310-pytest-8.4.1.pyc
Bestand weergeven


BIN
commu/tests/__pycache__/test_post_repository.cpython-311.pyc
Bestand weergeven


BIN
commu/tests/__pycache__/test_post_service.cpython-310-pytest-8.4.1.pyc
Bestand weergeven


BIN
commu/tests/__pycache__/test_post_service.cpython-311.pyc
Bestand weergeven


BIN
commu/tests/__pycache__/test_user_service.cpython-310-pytest-8.4.1.pyc
Bestand weergeven


BIN
commu/tests/__pycache__/test_user_service.cpython-311.pyc
Bestand weergeven


+ 27 - 0
commu/tests/test_post_repository.py
Bestand weergeven 

@@ -0,0 +1,27 @@
1 
+from commu.infrastructure.memory_post_repository import InMemoryPostRepository
2 
+from commu.entities.post import Post
3 
+
4 
+def test_add_and_get_post():
5 
+    repo = InMemoryPostRepository()
6 
+    post = Post("user1", "content", images=["img.png"])
7 
+    repo.add(post)
8 
+    assert repo.get(post.id) == post
9 
+
10 
+def test_search():
11 
+    repo = InMemoryPostRepository()
12 
+    p1 = Post("u", "hello apple")
13 
+    p2 = Post("u", "banana orange")
14 
+    repo.add(p1)
15 
+    repo.add(p2)
16 
+    results = repo.search("apple")
17 
+    assert len(results) == 1 and results[0].id == p1.id
18 
+
19 
+def test_rate_post():
20 
+    repo = InMemoryPostRepository()
21 
+    p = Post("u", "rate me")
22 
+    repo.add(p)
23 
+    repo.rate_post(p.id, "userA", 3)
24 
+    repo.rate_post(p.id, "userB", 5)
25 
+    # userA updates rating
26 
+    repo.rate_post(p.id, "userA", 4)
27 
+    assert p.ratings == [("userB", 5), ("userA", 4)] or p.ratings == [("userA", 4), ("userB", 5)]

+ 57 - 0
commu/tests/test_post_service.py
Bestand weergeven 

@@ -0,0 +1,57 @@
1 
+import pytest
2 
+from commu.usecases.post_service import PostService
3 
+from commu.usecases.user_service import UserService
4 
+from commu.infrastructure.memory_user_repository import InMemoryUserRepository
5 
+from commu.infrastructure.memory_post_repository import InMemoryPostRepository
6 
+from commu.entities.user import UserRole
7 
+
8 
+@pytest.fixture
9 
+def setup_services():
10 
+    user_repo = InMemoryUserRepository()
11 
+    post_repo = InMemoryPostRepository()
12 
+    user_svc = UserService(user_repo)
13 
+    post_svc = PostService(post_repo, user_repo)
14 
+    admin = user_svc.register("admin", UserRole.ADMIN)
15 
+    user = user_svc.register("user", UserRole.USER)
16 
+    guest = user_svc.register("guest", UserRole.GUEST)
17 
+    return user_svc, post_svc, admin, user, guest
18 
+
19 
+def test_create_post(setup_services):
20 
+    user_svc, post_svc, admin, user, guest = setup_services
21 
+    post = post_svc.create_post(user.id, "My post", images=["a.jpg"])
22 
+    assert post.text == "My post"
23 
+    assert post.images == ["a.jpg"]
24 
+
25 
+def test_guest_cannot_create_post(setup_services):
26 
+    user_svc, post_svc, admin, user, guest = setup_services
27 
+    with pytest.raises(PermissionError):
28 
+        post_svc.create_post(guest.id, "forbidden")
29 
+
30 
+def test_search_posts(setup_services):
31 
+    user_svc, post_svc, admin, user, guest = setup_services
32 
+    post1 = post_svc.create_post(user.id, "Hello world")
33 
+    post2 = post_svc.create_post(user.id, "Another post")
34 
+    results = post_svc.search_posts("hello")
35 
+    assert len(results) == 1
36 
+    assert results[0].text == "Hello world"
37 
+
38 
+def test_rate_post(setup_services):
39 
+    user_svc, post_svc, admin, user, guest = setup_services
40 
+    post = post_svc.create_post(user.id, "My post")
41 
+    post_svc.rate_post(post.id, admin.id, 5)
42 
+    post_svc.rate_post(post.id, user.id, 4)
43 
+    assert abs(post.average_rating() - 4.5) < 1e-6
44 
+
45 
+def test_guest_cannot_rate(setup_services):
46 
+    user_svc, post_svc, admin, user, guest = setup_services
47 
+    post = post_svc.create_post(user.id, "Guest can't rate")
48 
+    with pytest.raises(PermissionError):
49 
+        post_svc.rate_post(post.id, guest.id, 5)
50 
+
51 
+def test_rating_bounds(setup_services):
52 
+    user_svc, post_svc, admin, user, guest = setup_services
53 
+    post = post_svc.create_post(user.id, "Test bounds")
54 
+    with pytest.raises(ValueError):
55 
+        post_svc.rate_post(post.id, admin.id, 0)
56 
+    with pytest.raises(ValueError):
57 
+        post_svc.rate_post(post.id, admin.id, 6)

+ 25 - 0
commu/tests/test_user_service.py
Bestand weergeven 

@@ -0,0 +1,25 @@
1 
+import pytest
2 
+from commu.usecases.user_service import UserService
3 
+from commu.infrastructure.memory_user_repository import InMemoryUserRepository
4 
+from commu.entities.user import UserRole
5 
+
6 
+def test_register_user():
7 
+    repo = InMemoryUserRepository()
8 
+    svc = UserService(repo)
9 
+    user = svc.register("testuser")
10 
+    assert user.username == "testuser"
11 
+    assert user.role == UserRole.USER
12 
+    assert repo.get(user.id) == user
13 
+
14 
+def test_register_admin():
15 
+    repo = InMemoryUserRepository()
16 
+    svc = UserService(repo)
17 
+    user = svc.register("adminuser", UserRole.ADMIN)
18 
+    assert user.role == UserRole.ADMIN
19 
+
20 
+def test_get_user():
21 
+    repo = InMemoryUserRepository()
22 
+    svc = UserService(repo)
23 
+    user = svc.register("abc")
24 
+    found = svc.get_user(user.id)
25 
+    assert found.username == "abc"

+ 0 - 0
commu/usecases/__init__.py
Bestand weergeven


BIN
commu/usecases/__pycache__/__init__.cpython-310.pyc
Bestand weergeven


BIN
commu/usecases/__pycache__/__init__.cpython-311.pyc
Bestand weergeven


BIN
commu/usecases/__pycache__/post_service.cpython-310.pyc
Bestand weergeven


BIN
commu/usecases/__pycache__/post_service.cpython-311.pyc
Bestand weergeven


BIN
commu/usecases/__pycache__/user_service.cpython-310.pyc
Bestand weergeven


BIN
commu/usecases/__pycache__/user_service.cpython-311.pyc
Bestand weergeven


+ 28 - 0
commu/usecases/post_service.py
Bestand weergeven 

@@ -0,0 +1,28 @@
1 
+from commu.entities.post import Post
2 
+from commu.entities.user import UserRole
3 
+
4 
+class PostService:
5 
+    def __init__(self, post_repo, user_repo):
6 
+        self.post_repo = post_repo
7 
+        self.user_repo = user_repo
8 
+
9 
+    def create_post(self, author_id, text, images=None, videos=None):
10 
+        user = self.user_repo.get(author_id)
11 
+        print(f"user = {user}")
12 
+        print(f"role = {user.role}")
13 
+        if not user or user.role == UserRole.GUEST:
14 
+            raise PermissionError("User does not have permission to create posts")
15 
+        post = Post(author_id, text, images, videos)
16 
+        self.post_repo.add(post)
17 
+        return post
18 
+
19 
+    def search_posts(self, query):
20 
+        return self.post_repo.search(query)
21 
+
22 
+    def rate_post(self, post_id, user_id, rating):
23 
+        user = self.user_repo.get(user_id)
24 
+        if not user or user.role == UserRole.GUEST:
25 
+            raise PermissionError("Guests cannot rate posts")
26 
+        if not (1 <= rating <= 5):
27 
+            raise ValueError("Rating must be between 1 and 5")
28 
+        self.post_repo.rate_post(post_id, user_id, rating)

+ 13 - 0
commu/usecases/user_service.py
Bestand weergeven 

@@ -0,0 +1,13 @@
1 
+from commu.entities.user import User, UserRole
2 
+
3 
+class UserService:
4 
+    def __init__(self, user_repo):
5 
+        self.user_repo = user_repo
6 
+
7 
+    def register(self, username, role=UserRole.USER):
8 
+        user = User(username, role)
9 
+        self.user_repo.add(user)
10 
+        return user
11 
+
12 
+    def get_user(self, user_id):
13 
+        return self.user_repo.get(user_id)

+ 0 - 0
core/__init__.py
Bestand weergeven


BIN
core/__pycache__/__init__.cpython-311.pyc
Bestand weergeven


BIN
core/__pycache__/admin.cpython-311.pyc
Bestand weergeven


BIN
core/__pycache__/apps.cpython-311.pyc
Bestand weergeven


BIN
core/__pycache__/models.cpython-311.pyc
Bestand weergeven


BIN
core/__pycache__/tests.cpython-311.pyc
Bestand weergeven


BIN
core/__pycache__/urls.cpython-311.pyc
Bestand weergeven


BIN
core/__pycache__/views.cpython-311.pyc
Bestand weergeven


+ 3 - 0
core/admin.py
Bestand weergeven 

@@ -0,0 +1,3 @@
1 
+from django.contrib import admin
2 
+
3 
+# Register your models here.

+ 6 - 0
core/apps.py
Bestand weergeven 

@@ -0,0 +1,6 @@
1 
+from django.apps import AppConfig
2 
+
3 
+
4 
+class CoreConfig(AppConfig):
5 
+    default_auto_field = 'django.db.models.BigAutoField'
6 
+    name = 'core'

+ 38 - 0
core/migrations/0001_initial.py
Bestand weergeven 

@@ -0,0 +1,38 @@
1 
+# Generated by Django 5.2.4 on 2025-08-03 16:36
2 
+
3 
+import django.db.models.deletion
4 
+from django.conf import settings
5 
+from django.db import migrations, models
6 
+
7 
+
8 
+class Migration(migrations.Migration):
9 
+
10 
+    initial = True
11 
+
12 
+    dependencies = [
13 
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
14 
+    ]
15 
+
16 
+    operations = [
17 
+        migrations.CreateModel(
18 
+            name='Post',
19 
+            fields=[
20 
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
21 
+                ('text', models.TextField()),
22 
+                ('images', models.JSONField(blank=True, default=list)),
23 
+                ('videos', models.JSONField(blank=True, default=list)),
24 
+                ('created', models.DateTimeField(auto_now_add=True)),
25 
+                ('author', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='posts', to=settings.AUTH_USER_MODEL)),
26 
+            ],
27 
+        ),
28 
+        migrations.CreateModel(
29 
+            name='PostRating',
30 
+            fields=[
31 
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
32 
+                ('rating', models.IntegerField()),
33 
+                ('created', models.DateTimeField(auto_now_add=True)),
34 
+                ('post', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='ratings', to='core.post')),
35 
+                ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL)),
36 
+            ],
37 
+        ),
38 
+    ]

+ 0 - 0
core/migrations/__init__.py
Bestand weergeven


BIN
core/migrations/__pycache__/0001_initial.cpython-311.pyc
Bestand weergeven


BIN
core/migrations/__pycache__/__init__.cpython-311.pyc
Bestand weergeven


+ 18 - 0
core/models.py
Bestand weergeven 

@@ -0,0 +1,18 @@
1 
+from django.db import models
2 
+from django.contrib.auth import get_user_model
3 
+
4 
+User = get_user_model()
5 
+
6 
+class Post(models.Model):
7 
+    author = models.ForeignKey(User, on_delete=models.CASCADE, related_name="posts")
8 
+    text = models.TextField()
9 
+    images = models.JSONField(default=list, blank=True)
10 
+    videos = models.JSONField(default=list, blank=True)
11 
+    created = models.DateTimeField(auto_now_add=True)
12 
+
13 
+class PostRating(models.Model):
14 
+    post = models.ForeignKey(Post, on_delete=models.CASCADE, related_name="ratings")
15 
+    user = models.ForeignKey(User, on_delete=models.CASCADE)
16 
+    rating = models.IntegerField()
17 
+    created = models.DateTimeField(auto_now_add=True)
18 
+

BIN
core/repositories/__pycache__/django_post_repository.cpython-311.pyc
Bestand weergeven


BIN
core/repositories/__pycache__/django_user_repository.cpython-311.pyc
Bestand weergeven


+ 112 - 0
core/repositories/django_post_repository.py
Bestand weergeven 

@@ -0,0 +1,112 @@
1 
+from commu.interfaces.post_repository import PostRepository
2 
+from core.models import Post, PostRating
3 
+from django.contrib.auth import get_user_model
4 
+
5 
+User = get_user_model()
6 
+
7 
+class DjangoPostRepository(PostRepository):
8 
+    def add(self, post):
9 
+        # post: commu.entities.post.Post
10 
+        try:
11 
+            author = User.objects.get(id=post.author_id)
12 
+        except User.DoesNotExist:
13 
+            raise ValueError("Author not found")
14 
+        obj = Post.objects.create(
15 
+            author=author,
16 
+            text=post.text,
17 
+            images=post.images,
18 
+            videos=post.videos,
19 
+        )
20 
+        post.id = str(obj.id)
21 
+        return post
22 
+
23 
+    def get(self, post_id):
24 
+        try:
25 
+            obj = Post.objects.get(id=post_id)
26 
+            from commu.entities.post import Post as DomainPost
27 
+            domain_post = DomainPost(
28 
+                author_id=str(obj.author.id),
29 
+                text=obj.text,
30 
+                images=obj.images,
31 
+                videos=obj.videos,
32 
+            )
33 
+            domain_post.id = str(obj.id)
34 
+            # Load ratings
35 
+            domain_post.ratings = [
36 
+                (str(r.user.id), r.rating)
37 
+                for r in obj.ratings.all()
38 
+            ]
39 
+            return domain_post
40 
+        except Post.DoesNotExist:
41 
+            return None
42 
+
43 
+    def search(self, query: str):
44 
+        qs = Post.objects.filter(text__icontains=query)
45 
+        from commu.entities.post import Post as DomainPost
46 
+        result = []
47 
+        for obj in qs:
48 
+            domain_post = DomainPost(
49 
+                author_id=str(obj.author.id),
50 
+                text=obj.text,
51 
+                images=obj.images,
52 
+                videos=obj.videos,
53 
+            )
54 
+            domain_post.id = str(obj.id)
55 
+            # Load ratings
56 
+            domain_post.ratings = [
57 
+                (str(r.user.id), r.rating)
58 
+                for r in obj.ratings.all()
59 
+            ]
60 
+            result.append(domain_post)
61 
+        return result
62 
+
63 
+    def rate_post(self, post_id, user_id, rating: int):
64 
+        try:
65 
+            post = Post.objects.get(id=post_id)
66 
+            user = User.objects.get(id=user_id)
67 
+        except (Post.DoesNotExist, User.DoesNotExist):
68 
+            raise ValueError("Post or user not found")
69 
+        # Remove old rating from user, if any
70 
+        PostRating.objects.filter(post=post, user=user).delete()
71 
+        # Create new rating
72 
+        PostRating.objects.create(post=post, user=user, rating=rating)
73 
+
74 
+    def delete(self, post_id):
75 
+        try:
76 
+            obj = Post.objects.get(id=post_id)
77 
+            obj.delete()
78 
+        except Post.DoesNotExist:
79 
+            raise ValueError("Post not found")
80 
+
81 
+    def list(self, page=1, per_page=10, order_by="-created"):
82 
+        qs = Post.objects.all().order_by(order_by)
83 
+        total = qs.count()
84 
+        start = (page - 1) * per_page
85 
+        end = start + per_page
86 
+        from commu.entities.post import Post as DomainPost
87 
+        posts = []
88 
+        for obj in qs[start:end]:
89 
+            domain_post = DomainPost(
90 
+                author_id=str(obj.author.id),
91 
+                text=obj.text,
92 
+                images=obj.images,
93 
+                videos=obj.videos,
94 
+            )
95 
+            domain_post.id = str(obj.id)
96 
+            domain_post.ratings = [
97 
+                (str(r.user.id), r.rating)
98 
+                for r in obj.ratings.all()
99 
+            ]
100 
+            posts.append(domain_post)
101 
+        return posts, total
102 
+
103 
+    def update(self, post):
104 
+        try:
105 
+            obj = Post.objects.get(id=post.id)
106 
+            obj.text = post.text
107 
+            obj.images = post.images
108 
+            obj.videos = post.videos
109 
+            obj.save()
110 
+            # Optionally update ratings (if part of update)
111 
+        except Post.DoesNotExist:
112 
+            raise ValueError("Post not found")

+ 55 - 0
core/repositories/django_user_repository.py
Bestand weergeven 

@@ -0,0 +1,55 @@
1 
+from commu.interfaces.user_repository import UserRepository
2 
+from django.contrib.auth.models import User as DjangoUser
3 
+
4 
+class DjangoUserRepository(UserRepository):
5 
+    def add(self, user):
6 
+        # user: commu.entities.user.User
7 
+        # Map role to Django flags
8 
+        is_staff = user.role.value in ("admin", "user") if hasattr(user.role, "value") else user.role in ("admin", "user")
9 
+        is_superuser = user.role.value == "admin" if hasattr(user.role, "value") else user.role == "admin"
10 
+        obj = DjangoUser.objects.create_user(
11 
+            username=user.username,
12 
+            password=None,  # You may set/generate a password as needed!
13 
+            is_staff=is_staff,
14 
+            is_superuser=is_superuser,
15 
+        )
16 
+        user.id = str(obj.id)
17 
+        return user
18 
+
19 
+    def get(self, user_id):
20 
+        try:
21 
+            obj = DjangoUser.objects.get(id=user_id)
22 
+            from commu.entities.user import User, UserRole
23 
+            role = self._role_from_django(obj)
24 
+            u = User(
25 
+                username=obj.username,
26 
+                role=role,
27 
+            )
28 
+            u.id = str(obj.id)
29 
+            return u
30 
+        except DjangoUser.DoesNotExist:
31 
+            return None
32 
+
33 
+    def find_by_username(self, username):
34 
+        try:
35 
+            obj = DjangoUser.objects.get(username=username)
36 
+            from commu.entities.user import User, UserRole
37 
+            role = self._role_from_django(obj)
38 
+            u = User(
39 
+                username=obj.username,
40 
+                role=role,
41 
+            )
42 
+            u.id = str(obj.id)
43 
+            return u
44 
+        except DjangoUser.DoesNotExist:
45 
+            return None
46 
+
47 
+    def _role_from_django(self, user_obj):
48 
+        from commu.entities.user import UserRole
49 
+        if user_obj.is_superuser:
50 
+            return UserRole.ADMIN
51 
+        elif user_obj.is_staff:
52 
+            return UserRole.USER
53 
+        else:
54 
+            return UserRole.GUEST
55 
+

+ 3 - 0
core/tests.py
Bestand weergeven 

@@ -0,0 +1,3 @@
1 
+from django.test import TestCase
2 
+
3 
+# Create your tests here.

+ 0 - 0
core/tests/__init__.py
Bestand weergeven


BIN
core/tests/__pycache__/__init__.cpython-311.pyc
Bestand weergeven


BIN
core/tests/__pycache__/test_post_service_django.cpython-311.pyc
Bestand weergeven


+ 60 - 0
core/tests/test_post_service_django.py
Bestand weergeven 

@@ -0,0 +1,60 @@
1 
+import pytest
2 
+from django.test import TestCase
3 
+from django.contrib.auth import get_user_model
4 
+
5 
+from commu.usecases.post_service import PostService
6 
+from commu.entities.user import UserRole
7 
+from core.repositories.django_post_repository import DjangoPostRepository
8 
+from core.repositories.django_user_repository import DjangoUserRepository
9 
+
10 
+User = get_user_model()
11 
+
12 
+class PostServiceIntegrationTest(TestCase):
13 
+
14 
+    def setUp(self):
15 
+        # Use Django's repositories
16 
+        self.user_repo = DjangoUserRepository()
17 
+        self.post_repo = DjangoPostRepository()
18 
+        self.service = PostService(self.post_repo, self.user_repo)
19 
+
20 
+        # Create some users using Django ORM
21 
+        self.admin = User.objects.create_user(username="admin", is_superuser=True, is_staff=True)
22 
+        self.user = User.objects.create_user(username="user", is_staff=True)
23 
+        self.guest = User.objects.create_user(username="guest")  # Not staff or superuser
24 
+
25 
+    def test_create_post_by_user(self):
26 
+        post = self.service.create_post(str(self.user.id), "Hello Django!", ["img1.png"], ["vid1.mp4"])
27 
+        assert post.text == "Hello Django!"
28 
+        assert post.images == ["img1.png"]
29 
+        assert post.videos == ["vid1.mp4"]
30 
+
31 
+    def test_guest_cannot_create_post(self):
32 
+        with self.assertRaises(PermissionError):
33 
+            self.service.create_post(str(self.guest.id), "Forbidden")
34 
+
35 
+    def test_search_posts(self):
36 
+        p1 = self.service.create_post(str(self.user.id), "First Django post")
37 
+        p2 = self.service.create_post(str(self.user.id), "Second hello world")
38 
+        results = self.service.search_posts("hello")
39 
+        assert len(results) == 1
40 
+        assert results[0].text == "Second hello world"
41 
+
42 
+    def test_rate_post(self):
43 
+        post = self.service.create_post(str(self.user.id), "Rate me Django!")
44 
+        self.service.rate_post(post.id, str(self.admin.id), 5)
45 
+        self.service.rate_post(post.id, str(self.user.id), 4)
46 
+        updated_post = self.post_repo.get(post.id)
47 
+        assert abs(updated_post.average_rating() - 4.5) < 1e-6
48 
+
49 
+    def test_guest_cannot_rate_post(self):
50 
+        post = self.service.create_post(str(self.user.id), "No guest rate")
51 
+        with self.assertRaises(PermissionError):
52 
+            self.service.rate_post(post.id, str(self.guest.id), 2)
53 
+
54 
+    def test_rating_bounds(self):
55 
+        post = self.service.create_post(str(self.user.id), "Bounds Django")
56 
+        with self.assertRaises(ValueError):
57 
+            self.service.rate_post(post.id, str(self.admin.id), 0)
58 
+        with self.assertRaises(ValueError):
59 
+            self.service.rate_post(post.id, str(self.admin.id), 6)
60 
+

+ 8 - 0
core/urls.py
Bestand weergeven 

@@ -0,0 +1,8 @@
1 
+from django.urls import path
2 
+from . import views
3 
+
4 
+urlpatterns = [
5 
+    path('posts/create/', views.create_post, name='create_post'),
6 
+    path('posts/search/', views.search_posts, name='search_posts'),
7 
+    path('posts/rate/', views.rate_post, name='rate_post'),
8 
+]

+ 69 - 0
core/views.py
Bestand weergeven 

@@ -0,0 +1,69 @@
1 
+import json
2 
+from django.http import JsonResponse, HttpResponseBadRequest
3 
+from django.views.decorators.csrf import csrf_exempt
4 
+from django.contrib.auth.decorators import login_required
5 
+from commu.usecases.post_service import PostService
6 
+from core.repositories.django_post_repository import DjangoPostRepository
7 
+from core.repositories.django_user_repository import DjangoUserRepository
8 
+
9 
+# Service setup (could be moved to app config for larger apps)
10 
+user_repo = DjangoUserRepository()
11 
+post_repo = DjangoPostRepository()
12 
+post_service = PostService(post_repo, user_repo)
13 
+
14 
+@csrf_exempt
15 
+@login_required
16 
+def create_post(request):
17 
+    if request.method != 'POST':
18 
+        return HttpResponseBadRequest("POST only")
19 
+    try:
20 
+        data = json.loads(request.body.decode())
21 
+        text = data.get("text")
22 
+        images = data.get("images", [])
23 
+        videos = data.get("videos", [])
24 
+        if not text:
25 
+            return JsonResponse({"error": "Missing post text"}, status=400)
26 
+        # Use logged-in Django user as author
27 
+        user_id = str(request.user.id)
28 
+        post = post_service.create_post(user_id, text, images, videos)
29 
+        return JsonResponse({
30 
+            "id": post.id,
31 
+            "text": post.text,
32 
+            "author_id": post.author_id,
33 
+            "images": post.images,
34 
+            "videos": post.videos
35 
+        })
36 
+    except Exception as e:
37 
+        return JsonResponse({"error": str(e)}, status=400)
38 
+
39 
+def search_posts(request):
40 
+    q = request.GET.get("q", "")
41 
+    results = post_service.search_posts(q)
42 
+    posts = [{
43 
+        "id": p.id,
44 
+        "text": p.text,
45 
+        "author_id": p.author_id,
46 
+        "images": p.images,
47 
+        "videos": p.videos,
48 
+        "avg_rating": p.average_rating()
49 
+    } for p in results]
50 
+    return JsonResponse({"results": posts})
51 
+
52 
+@csrf_exempt
53 
+@login_required
54 
+def rate_post(request):
55 
+    if request.method != 'POST':
56 
+        return HttpResponseBadRequest("POST only")
57 
+    try:
58 
+        data = json.loads(request.body.decode())
59 
+        post_id = data.get("post_id")
60 
+        rating = data.get("rating")
61 
+        if not post_id or rating is None:
62 
+            return JsonResponse({"error": "Missing post_id or rating"}, status=400)
63 
+        user_id = str(request.user.id)
64 
+        post_service.rate_post(post_id, user_id, int(rating))
65 
+        return JsonResponse({"ok": True})
66 
+    except Exception as e:
67 
+        return JsonResponse({"error": str(e)}, status=400)
68 
+
69 
+

+ 0 - 0
db.sqlite3
Bestand weergeven


+ 0 - 0
django_commu/__init__.py
Bestand weergeven


BIN
django_commu/__pycache__/__init__.cpython-311.pyc
Bestand weergeven


BIN
django_commu/__pycache__/settings.cpython-311.pyc
Bestand weergeven


BIN
django_commu/__pycache__/urls.cpython-311.pyc
Bestand weergeven


BIN
django_commu/__pycache__/wsgi.cpython-311.pyc
Bestand weergeven


+ 16 - 0
django_commu/asgi.py
Bestand weergeven 

@@ -0,0 +1,16 @@
1 
+"""
2 
+ASGI config for django_commu project.
3 
+
4 
+It exposes the ASGI callable as a module-level variable named ``application``.
5 
+
6 
+For more information on this file, see
7 
+https://docs.djangoproject.com/en/5.2/howto/deployment/asgi/
8 
+"""
9 
+
10 
+import os
11 
+
12 
+from django.core.asgi import get_asgi_application
13 
+
14 
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'django_commu.settings')
15 
+
16 
+application = get_asgi_application()

+ 128 - 0
django_commu/settings.py
Bestand weergeven 

@@ -0,0 +1,128 @@
1 
+"""
2 
+Django settings for django_commu project.
3 
+
4 
+Generated by 'django-admin startproject' using Django 5.2.4.
5 
+
6 
+For more information on this file, see
7 
+https://docs.djangoproject.com/en/5.2/topics/settings/
8 
+
9 
+For the full list of settings and their values, see
10 
+https://docs.djangoproject.com/en/5.2/ref/settings/
11 
+"""
12 
+
13 
+from pathlib import Path
14 
+import os
15 
+
16 
+# Build paths inside the project like this: BASE_DIR / 'subdir'.
17 
+BASE_DIR = Path(__file__).resolve().parent.parent
18 
+
19 
+
20 
+# Quick-start development settings - unsuitable for production
21 
+# See https://docs.djangoproject.com/en/5.2/howto/deployment/checklist/
22 
+
23 
+# SECURITY WARNING: keep the secret key used in production secret!
24 
+SECRET_KEY = 'django-insecure-c$ieo22nwe^v#*e$xlh@fath9*t+f8wtqrt9e!op9-ittc=b_x'
25 
+
26 
+# SECURITY WARNING: don't run with debug turned on in production!
27 
+DEBUG = True
28 
+
29 
+ALLOWED_HOSTS = []
30 
+
31 
+
32 
+# Application definition
33 
+
34 
+INSTALLED_APPS = [
35 
+    'django.contrib.admin',
36 
+    'django.contrib.auth',
37 
+    'django.contrib.contenttypes',
38 
+    'django.contrib.sessions',
39 
+    'django.contrib.messages',
40 
+    'django.contrib.staticfiles',
41 
+    'core',
42 
+]
43 
+
44 
+MIDDLEWARE = [
45 
+    'django.middleware.security.SecurityMiddleware',
46 
+    'django.contrib.sessions.middleware.SessionMiddleware',
47 
+    'django.middleware.common.CommonMiddleware',
48 
+    'django.middleware.csrf.CsrfViewMiddleware',
49 
+    'django.contrib.auth.middleware.AuthenticationMiddleware',
50 
+    'django.contrib.messages.middleware.MessageMiddleware',
51 
+    'django.middleware.clickjacking.XFrameOptionsMiddleware',
52 
+]
53 
+
54 
+ROOT_URLCONF = 'django_commu.urls'
55 
+
56 
+TEMPLATES = [
57 
+    {
58 
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
59 
+        'DIRS': [],
60 
+        'APP_DIRS': True,
61 
+        'OPTIONS': {
62 
+            'context_processors': [
63 
+                'django.template.context_processors.request',
64 
+                'django.contrib.auth.context_processors.auth',
65 
+                'django.contrib.messages.context_processors.messages',
66 
+            ],
67 
+        },
68 
+    },
69 
+]
70 
+
71 
+WSGI_APPLICATION = 'django_commu.wsgi.application'
72 
+
73 
+
74 
+# Database
75 
+# https://docs.djangoproject.com/en/5.2/ref/settings/#databases
76 
+
77 
+DATABASES = {
78 
+    'default': {
79 
+        'ENGINE': 'django.db.backends.postgresql',
80 
+        'NAME': os.getenv('DB_NAME', 'commudb'),
81 
+        'USER': os.getenv('DB_USER', 'commuuser'),
82 
+        'PASSWORD': os.getenv('DB_PASSWORD', 'commupass'),
83 
+        'HOST': os.getenv('DB_HOST', 'db'),
84 
+        'PORT': os.getenv('DB_PORT', '5432'),
85 
+    }
86 
+}
87 
+
88 
+
89 
+# Password validation
90 
+# https://docs.djangoproject.com/en/5.2/ref/settings/#auth-password-validators
91 
+
92 
+AUTH_PASSWORD_VALIDATORS = [
93 
+    {
94 
+        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
95 
+    },
96 
+    {
97 
+        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
98 
+    },
99 
+    {
100 
+        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
101 
+    },
102 
+    {
103 
+        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
104 
+    },
105 
+]
106 
+
107 
+
108 
+# Internationalization
109 
+# https://docs.djangoproject.com/en/5.2/topics/i18n/
110 
+
111 
+LANGUAGE_CODE = 'en-us'
112 
+
113 
+TIME_ZONE = 'UTC'
114 
+
115 
+USE_I18N = True
116 
+
117 
+USE_TZ = True
118 
+
119 
+
120 
+# Static files (CSS, JavaScript, Images)
121 
+# https://docs.djangoproject.com/en/5.2/howto/static-files/
122 
+
123 
+STATIC_URL = 'static/'
124 
+
125 
+# Default primary key field type
126 
+# https://docs.djangoproject.com/en/5.2/ref/settings/#default-auto-field
127 
+
128 
+DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'

+ 23 - 0
django_commu/urls.py
Bestand weergeven 

@@ -0,0 +1,23 @@
1 
+"""
2 
+URL configuration for django_commu project.
3 
+
4 
+The `urlpatterns` list routes URLs to views. For more information please see:
5 
+    https://docs.djangoproject.com/en/5.2/topics/http/urls/
6 
+Examples:
7 
+Function views
8 
+    1. Add an import:  from my_app import views
9 
+    2. Add a URL to urlpatterns:  path('', views.home, name='home')
10 
+Class-based views
11 
+    1. Add an import:  from other_app.views import Home
12 
+    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
13 
+Including another URLconf
14 
+    1. Import the include() function: from django.urls import include, path
15 
+    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
16 
+"""
17 
+from django.contrib import admin
18 
+from django.urls import path, include
19 
+
20 
+urlpatterns = [
21 
+    path('admin/', admin.site.urls),
22 
+    path('core/', include('core.urls')),
23 
+]

+ 16 - 0
django_commu/wsgi.py
Bestand weergeven 

@@ -0,0 +1,16 @@
1 
+"""
2 
+WSGI config for django_commu project.
3 
+
4 
+It exposes the WSGI callable as a module-level variable named ``application``.
5 
+
6 
+For more information on this file, see
7 
+https://docs.djangoproject.com/en/5.2/howto/deployment/wsgi/
8 
+"""
9 
+
10 
+import os
11 
+
12 
+from django.core.wsgi import get_wsgi_application
13 
+
14 
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'django_commu.settings')
15 
+
16 
+application = get_wsgi_application()

+ 40 - 0
docker-compose.yml
Bestand weergeven 

@@ -0,0 +1,40 @@
1 
+version: '3.9'
2 
+
3 
+services:
4 
+  db:
5 
+    image: postgres:16
6 
+    environment:
7 
+      POSTGRES_DB: commudb
8 
+      POSTGRES_USER: commuuser
9 
+      POSTGRES_PASSWORD: commupass
10 
+    ports:
11 
+      - "5432:5432"
12 
+    volumes:
13 
+      - postgres_data:/var/lib/postgresql/data
14 
+
15 
+  web:
16 
+    build:
17 
+      context: .
18 
+      args:
19 
+        UID: ${UID}
20 
+        GID: ${GID}
21 
+    user: "${UID}:${GID}"
22 
+    command: >
23 
+      sh -c "python manage.py runserver 0.0.0.0:8000"
24 
+    volumes:
25 
+      - .:/app
26 
+    working_dir: /app
27 
+    ports:
28 
+      - "8000:8000"
29 
+    depends_on:
30 
+      - db
31 
+    environment:
32 
+      - DEBUG=1
33 
+      - DB_NAME=commudb
34 
+      - DB_USER=commuuser
35 
+      - DB_PASSWORD=commupass
36 
+      - DB_HOST=db
37 
+      - DB_PORT=5432
38 
+
39 
+volumes:
40 
+  postgres_data:

+ 38 - 0
main.py
Bestand weergeven 

@@ -0,0 +1,38 @@
1 
+from commu.infrastructure.memory_user_repository import InMemoryUserRepository
2 
+from commu.infrastructure.memory_post_repository import InMemoryPostRepository
3 
+from commu.usecases.user_service import UserService
4 
+from commu.usecases.post_service import PostService
5 
+from commu.entities.user import UserRole
6 
+
7 
+def main():
8 
+    user_repo = InMemoryUserRepository()
9 
+    post_repo = InMemoryPostRepository()
10 
+    user_service = UserService(user_repo)
11 
+    post_service = PostService(post_repo, user_repo)
12 
+
13 
+    # Create users
14 
+    admin = user_service.register("alice", UserRole.ADMIN)
15 
+    user = user_service.register("bob", UserRole.USER)
16 
+    guest = user_service.register("guest", UserRole.GUEST)
17 
+
18 
+    # User creates post
19 
+    post = post_service.create_post(user.id, "Hello world!", images=["img1.png"], videos=["vid1.mp4"])
20 
+    print(f"Created Post: {post.text}, by {user.username}")
21 
+
22 
+    # Post search
23 
+    found = post_service.search_posts("hello")
24 
+    print(f"Found {len(found)} posts containing 'hello'.")
25 
+
26 
+    # Post rating
27 
+    post_service.rate_post(post.id, admin.id, 5)
28 
+    post_service.rate_post(post.id, user.id, 4)
29 
+    print(f"Average Rating: {post.average_rating()}")
30 
+
31 
+    # Guest tries to create post (should fail)
32 
+    try:
33 
+        post_service.create_post(guest.id, "I am a guest")
34 
+    except PermissionError as e:
35 
+        print("Guest cannot create post:", e)
36 
+
37 
+if __name__ == "__main__":
38 
+    main()

+ 22 - 0
manage.py
Bestand weergeven 

@@ -0,0 +1,22 @@
1 
+#!/usr/bin/env python
2 
+"""Django's command-line utility for administrative tasks."""
3 
+import os
4 
+import sys
5 
+
6 
+
7 
+def main():
8 
+    """Run administrative tasks."""
9 
+    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'django_commu.settings')
10 
+    try:
11 
+        from django.core.management import execute_from_command_line
12 
+    except ImportError as exc:
13 
+        raise ImportError(
14 
+            "Couldn't import Django. Are you sure it's installed and "
15 
+            "available on your PYTHONPATH environment variable? Did you "
16 
+            "forget to activate a virtual environment?"
17 
+        ) from exc
18 
+    execute_from_command_line(sys.argv)
19 
+
20 
+
21 
+if __name__ == '__main__':
22 
+    main()

+ 3 - 0
requirements.txt
Bestand weergeven 

@@ -0,0 +1,3 @@
1 
+pytest
2 
+Django>=4.2
3 
+psycopg2-binary

tum/whitesports - Gogs: Simplico Git Service
Home Verkennen Help
Inloggen
tum
/
whitesports
Volgen 1
Ster 0
Vork 0
Code Kwesties 0 Pull-aanvragen 0 Commits 4 Publicaties 0 Wiki

Geen omschrijving

Boom: f1bc928a71
Aftakkingen Labels
whitesports
/
app
/
wp-admin
/
includes
/
theme.php

theme.php 44KB
Geschiedenis Ruwe

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175 
  1. <?php
    2. 

  2. /**
    3. 

  3.  * WordPress Theme Administration API
    4. 

  4.  *
    5. 

  5.  * @package WordPress
    6. 

  6.  * @subpackage Administration
    7. 

  7.  */
    8. 

  8. 

  9. /**
    10. 

  10.  * Remove a theme
    11. 

  11.  *
    12. 

  12.  * @since 2.8.0
    13. 

  13.  *
    14. 

  14.  * @global WP_Filesystem_Base $wp_filesystem WordPress filesystem subclass.
    15. 

  15.  *
    16. 

  16.  * @param string $stylesheet Stylesheet of the theme to delete.
    17. 

  17.  * @param string $redirect   Redirect to page when complete.
    18. 

  18.  * @return bool|null|WP_Error True on success, false if `$stylesheet` is empty, WP_Error on failure.
    19. 

  19.  *                            Null if filesystem credentials are required to proceed.
    20. 

  20.  */
    21. 

  21. function delete_theme( $stylesheet, $redirect = '' ) {
    22. 

  22. 	global $wp_filesystem;
    23. 

  23. 

  24. 	if ( empty( $stylesheet ) ) {
    25. 

  25. 		return false;
    26. 

  26. 	}
    27. 

  27. 

  28. 	if ( empty( $redirect ) ) {
    29. 

  29. 		$redirect = wp_nonce_url( 'themes.php?action=delete&stylesheet=' . urlencode( $stylesheet ), 'delete-theme_' . $stylesheet );
    30. 

  30. 	}
    31. 

  31. 

  32. 	ob_start();
    33. 

  33. 	$credentials = request_filesystem_credentials( $redirect );
    34. 

  34. 	$data        = ob_get_clean();
    35. 

  35. 

  36. 	if ( false === $credentials ) {
    37. 

  37. 		if ( ! empty( $data ) ) {
    38. 

  38. 			require_once ABSPATH . 'wp-admin/admin-header.php';
    39. 

  39. 			echo $data;
    40. 

  40. 			require_once ABSPATH . 'wp-admin/admin-footer.php';
    41. 

  41. 			exit;
    42. 

  42. 		}
    43. 

  43. 		return;
    44. 

  44. 	}
    45. 

  45. 

  46. 	if ( ! WP_Filesystem( $credentials ) ) {
    47. 

  47. 		ob_start();
    48. 

  48. 		// Failed to connect. Error and request again.
    49. 

  49. 		request_filesystem_credentials( $redirect, '', true );
    50. 

  50. 		$data = ob_get_clean();
    51. 

  51. 

  52. 		if ( ! empty( $data ) ) {
    53. 

  53. 			require_once ABSPATH . 'wp-admin/admin-header.php';
    54. 

  54. 			echo $data;
    55. 

  55. 			require_once ABSPATH . 'wp-admin/admin-footer.php';
    56. 

  56. 			exit;
    57. 

  57. 		}
    58. 

  58. 		return;
    59. 

  59. 	}
    60. 

  60. 

  61. 	if ( ! is_object( $wp_filesystem ) ) {
    62. 

  62. 		return new WP_Error( 'fs_unavailable', __( 'Could not access filesystem.' ) );
    63. 

  63. 	}
    64. 

  64. 

  65. 	if ( is_wp_error( $wp_filesystem->errors ) && $wp_filesystem->errors->has_errors() ) {
    66. 

  66. 		return new WP_Error( 'fs_error', __( 'Filesystem error.' ), $wp_filesystem->errors );
    67. 

  67. 	}
    68. 

  68. 

  69. 	// Get the base plugin folder.
    70. 

  70. 	$themes_dir = $wp_filesystem->wp_themes_dir();
    71. 

  71. 	if ( empty( $themes_dir ) ) {
    72. 

  72. 		return new WP_Error( 'fs_no_themes_dir', __( 'Unable to locate WordPress theme directory.' ) );
    73. 

  73. 	}
    74. 

  74. 

  75. 	/**
    76. 

  76. 	 * Fires immediately before a theme deletion attempt.
    77. 

  77. 	 *
    78. 

  78. 	 * @since 5.8.0
    79. 

  79. 	 *
    80. 

  80. 	 * @param string $stylesheet Stylesheet of the theme to delete.
    81. 

  81. 	 */
    82. 

  82. 	do_action( 'delete_theme', $stylesheet );
    83. 

  83. 

  84. 	$themes_dir = trailingslashit( $themes_dir );
    85. 

  85. 	$theme_dir  = trailingslashit( $themes_dir . $stylesheet );
    86. 

  86. 	$deleted    = $wp_filesystem->delete( $theme_dir, true );
    87. 

  87. 

  88. 	/**
    89. 

  89. 	 * Fires immediately after a theme deletion attempt.
    90. 

  90. 	 *
    91. 

  91. 	 * @since 5.8.0
    92. 

  92. 	 *
    93. 

  93. 	 * @param string $stylesheet Stylesheet of the theme to delete.
    94. 

  94. 	 * @param bool   $deleted    Whether the theme deletion was successful.
    95. 

  95. 	 */
    96. 

  96. 	do_action( 'deleted_theme', $stylesheet, $deleted );
    97. 

  97. 

  98. 	if ( ! $deleted ) {
    99. 

  99. 		return new WP_Error(
    100. 

  100. 			'could_not_remove_theme',
    101. 

  101. 			/* translators: %s: Theme name. */
    102. 

  102. 			sprintf( __( 'Could not fully remove the theme %s.' ), $stylesheet )
    103. 

  103. 		);
    104. 

  104. 	}
    105. 

  105. 

  106. 	$theme_translations = wp_get_installed_translations( 'themes' );
    107. 

  107. 

  108. 	// Remove language files, silently.
    109. 

  109. 	if ( ! empty( $theme_translations[ $stylesheet ] ) ) {
    110. 

  110. 		$translations = $theme_translations[ $stylesheet ];
    111. 

  111. 

  112. 		foreach ( $translations as $translation => $data ) {
    113. 

  113. 			$wp_filesystem->delete( WP_LANG_DIR . '/themes/' . $stylesheet . '-' . $translation . '.po' );
    114. 

  114. 			$wp_filesystem->delete( WP_LANG_DIR . '/themes/' . $stylesheet . '-' . $translation . '.mo' );
    115. 

  115. 

  116. 			$json_translation_files = glob( WP_LANG_DIR . '/themes/' . $stylesheet . '-' . $translation . '-*.json' );
    117. 

  117. 			if ( $json_translation_files ) {
    118. 

  118. 				array_map( array( $wp_filesystem, 'delete' ), $json_translation_files );
    119. 

  119. 			}
    120. 

  120. 		}
    121. 

  121. 	}
    122. 

  122. 

  123. 	// Remove the theme from allowed themes on the network.
    124. 

  124. 	if ( is_multisite() ) {
    125. 

  125. 		WP_Theme::network_disable_theme( $stylesheet );
    126. 

  126. 	}
    127. 

  127. 

  128. 	// Force refresh of theme update information.
    129. 

  129. 	delete_site_transient( 'update_themes' );
    130. 

  130. 

  131. 	return true;
    132. 

  132. }
    133. 

  133. 

  134. /**
    135. 

  135.  * Gets the page templates available in this theme.
    136. 

  136.  *
    137. 

  137.  * @since 1.5.0
    138. 

  138.  * @since 4.7.0 Added the `$post_type` parameter.
    139. 

  139.  *
    140. 

  140.  * @param WP_Post|null $post      Optional. The post being edited, provided for context.
    141. 

  141.  * @param string       $post_type Optional. Post type to get the templates for. Default 'page'.
    142. 

  142.  * @return string[] Array of template file names keyed by the template header name.
    143. 

  143.  */
    144. 

  144. function get_page_templates( $post = null, $post_type = 'page' ) {
    145. 

  145. 	return array_flip( wp_get_theme()->get_page_templates( $post, $post_type ) );
    146. 

  146. }
    147. 

  147. 

  148. /**
    149. 

  149.  * Tidies a filename for url display by the theme editor.
    150. 

  150.  *
    151. 

  151.  * @since 2.9.0
    152. 

  152.  * @access private
    153. 

  153.  *
    154. 

  154.  * @param string $fullpath Full path to the theme file
    155. 

  155.  * @param string $containingfolder Path of the theme parent folder
    156. 

  156.  * @return string
    157. 

  157.  */
    158. 

  158. function _get_template_edit_filename( $fullpath, $containingfolder ) {
    159. 

  159. 	return str_replace( dirname( dirname( $containingfolder ) ), '', $fullpath );
    160. 

  160. }
    161. 

  161. 

  162. /**
    163. 

  163.  * Check if there is an update for a theme available.
    164. 

  164.  *
    165. 

  165.  * Will display link, if there is an update available.
    166. 

  166.  *
    167. 

  167.  * @since 2.7.0
    168. 

  168.  *
    169. 

  169.  * @see get_theme_update_available()
    170. 

  170.  *
    171. 

  171.  * @param WP_Theme $theme Theme data object.
    172. 

  172.  */
    173. 

  173. function theme_update_available( $theme ) {
    174. 

  174. 	echo get_theme_update_available( $theme );
    175. 

  175. }
    176. 

  176. 

  177. /**
    178. 

  178.  * Retrieve the update link if there is a theme update available.
    179. 

  179.  *
    180. 

  180.  * Will return a link if there is an update available.
    181. 

  181.  *
    182. 

  182.  * @since 3.8.0
    183. 

  183.  *
    184. 

  184.  * @param WP_Theme $theme WP_Theme object.
    185. 

  185.  * @return string|false HTML for the update link, or false if invalid info was passed.
    186. 

  186.  */
    187. 

  187. function get_theme_update_available( $theme ) {
    188. 

  188. 	static $themes_update = null;
    189. 

  189. 

  190. 	if ( ! current_user_can( 'update_themes' ) ) {
    191. 

  191. 		return false;
    192. 

  192. 	}
    193. 

  193. 

  194. 	if ( ! isset( $themes_update ) ) {
    195. 

  195. 		$themes_update = get_site_transient( 'update_themes' );
    196. 

  196. 	}
    197. 

  197. 

  198. 	if ( ! ( $theme instanceof WP_Theme ) ) {
    199. 

  199. 		return false;
    200. 

  200. 	}
    201. 

  201. 

  202. 	$stylesheet = $theme->get_stylesheet();
    203. 

  203. 

  204. 	$html = '';
    205. 

  205. 

  206. 	if ( isset( $themes_update->response[ $stylesheet ] ) ) {
    207. 

  207. 		$update      = $themes_update->response[ $stylesheet ];
    208. 

  208. 		$theme_name  = $theme->display( 'Name' );
    209. 

  209. 		$details_url = add_query_arg(
    210. 

  210. 			array(
    211. 

  211. 				'TB_iframe' => 'true',
    212. 

  212. 				'width'     => 1024,
    213. 

  213. 				'height'    => 800,
    214. 

  214. 			),
    215. 

  215. 			$update['url']
    216. 

  216. 		); // Theme browser inside WP? Replace this. Also, theme preview JS will override this on the available list.
    217. 

  217. 		$update_url  = wp_nonce_url( admin_url( 'update.php?action=upgrade-theme&amp;theme=' . urlencode( $stylesheet ) ), 'upgrade-theme_' . $stylesheet );
    218. 

  218. 

  219. 		if ( ! is_multisite() ) {
    220. 

  220. 			if ( ! current_user_can( 'update_themes' ) ) {
    221. 

  221. 				$html = sprintf(
    222. 

  222. 					/* translators: 1: Theme name, 2: Theme details URL, 3: Additional link attributes, 4: Version number. */
    223. 

  223. 					'<p><strong>' . __( 'There is a new version of %1$s available. <a href="%2$s" %3$s>View version %4$s details</a>.' ) . '</strong></p>',
    224. 

  224. 					$theme_name,
    225. 

  225. 					esc_url( $details_url ),
    226. 

  226. 					sprintf(
    227. 

  227. 						'class="thickbox open-plugin-details-modal" aria-label="%s"',
    228. 

  228. 						/* translators: 1: Theme name, 2: Version number. */
    229. 

  229. 						esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme_name, $update['new_version'] ) )
    230. 

  230. 					),
    231. 

  231. 					$update['new_version']
    232. 

  232. 				);
    233. 

  233. 			} elseif ( empty( $update['package'] ) ) {
    234. 

  234. 				$html = sprintf(
    235. 

  235. 					/* translators: 1: Theme name, 2: Theme details URL, 3: Additional link attributes, 4: Version number. */
    236. 

  236. 					'<p><strong>' . __( 'There is a new version of %1$s available. <a href="%2$s" %3$s>View version %4$s details</a>. <em>Automatic update is unavailable for this theme.</em>' ) . '</strong></p>',
    237. 

  237. 					$theme_name,
    238. 

  238. 					esc_url( $details_url ),
    239. 

  239. 					sprintf(
    240. 

  240. 						'class="thickbox open-plugin-details-modal" aria-label="%s"',
    241. 

  241. 						/* translators: 1: Theme name, 2: Version number. */
    242. 

  242. 						esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme_name, $update['new_version'] ) )
    243. 

  243. 					),
    244. 

  244. 					$update['new_version']
    245. 

  245. 				);
    246. 

  246. 			} else {
    247. 

  247. 				$html = sprintf(
    248. 

  248. 					/* translators: 1: Theme name, 2: Theme details URL, 3: Additional link attributes, 4: Version number, 5: Update URL, 6: Additional link attributes. */
    249. 

  249. 					'<p><strong>' . __( 'There is a new version of %1$s available. <a href="%2$s" %3$s>View version %4$s details</a> or <a href="%5$s" %6$s>update now</a>.' ) . '</strong></p>',
    250. 

  250. 					$theme_name,
    251. 

  251. 					esc_url( $details_url ),
    252. 

  252. 					sprintf(
    253. 

  253. 						'class="thickbox open-plugin-details-modal" aria-label="%s"',
    254. 

  254. 						/* translators: 1: Theme name, 2: Version number. */
    255. 

  255. 						esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme_name, $update['new_version'] ) )
    256. 

  256. 					),
    257. 

  257. 					$update['new_version'],
    258. 

  258. 					$update_url,
    259. 

  259. 					sprintf(
    260. 

  260. 						'aria-label="%s" id="update-theme" data-slug="%s"',
    261. 

  261. 						/* translators: %s: Theme name. */
    262. 

  262. 						esc_attr( sprintf( _x( 'Update %s now', 'theme' ), $theme_name ) ),
    263. 

  263. 						$stylesheet
    264. 

  264. 					)
    265. 

  265. 				);
    266. 

  266. 			}
    267. 

  267. 		}
    268. 

  268. 	}
    269. 

  269. 

  270. 	return $html;
    271. 

  271. }
    272. 

  272. 

  273. /**
    274. 

  274.  * Retrieve list of WordPress theme features (aka theme tags).
    275. 

  275.  *
    276. 

  276.  * @since 3.1.0
    277. 

  277.  * @since 3.2.0 Added 'Gray' color and 'Featured Image Header', 'Featured Images',
    278. 

  278.  *              'Full Width Template', and 'Post Formats' features.
    279. 

  279.  * @since 3.5.0 Added 'Flexible Header' feature.
    280. 

  280.  * @since 3.8.0 Renamed 'Width' filter to 'Layout'.
    281. 

  281.  * @since 3.8.0 Renamed 'Fixed Width' and 'Flexible Width' options
    282. 

  282.  *              to 'Fixed Layout' and 'Fluid Layout'.
    283. 

  283.  * @since 3.8.0 Added 'Accessibility Ready' feature and 'Responsive Layout' option.
    284. 

  284.  * @since 3.9.0 Combined 'Layout' and 'Columns' filters.
    285. 

  285.  * @since 4.6.0 Removed 'Colors' filter.
    286. 

  286.  * @since 4.6.0 Added 'Grid Layout' option.
    287. 

  287.  *              Removed 'Fixed Layout', 'Fluid Layout', and 'Responsive Layout' options.
    288. 

  288.  * @since 4.6.0 Added 'Custom Logo' and 'Footer Widgets' features.
    289. 

  289.  *              Removed 'Blavatar' feature.
    290. 

  290.  * @since 4.6.0 Added 'Blog', 'E-Commerce', 'Education', 'Entertainment', 'Food & Drink',
    291. 

  291.  *              'Holiday', 'News', 'Photography', and 'Portfolio' subjects.
    292. 

  292.  *              Removed 'Photoblogging' and 'Seasonal' subjects.
    293. 

  293.  * @since 4.9.0 Reordered the filters from 'Layout', 'Features', 'Subject'
    294. 

  294.  *              to 'Subject', 'Features', 'Layout'.
    295. 

  295.  * @since 4.9.0 Removed 'BuddyPress', 'Custom Menu', 'Flexible Header',
    296. 

  296.  *              'Front Page Posting', 'Microformats', 'RTL Language Support',
    297. 

  297.  *              'Threaded Comments', and 'Translation Ready' features.
    298. 

  298.  * @since 5.5.0 Added 'Block Editor Patterns', 'Block Editor Styles',
    299. 

  299.  *              and 'Full Site Editing' features.
    300. 

  300.  * @since 5.5.0 Added 'Wide Blocks' layout option.
    301. 

  301.  * @since 5.8.1 Added 'Template Editing' feature.
    302. 

  302.  *
    303. 

  303.  * @param bool $api Optional. Whether try to fetch tags from the WordPress.org API. Defaults to true.
    304. 

  304.  * @return array Array of features keyed by category with translations keyed by slug.
    305. 

  305.  */
    306. 

  306. function get_theme_feature_list( $api = true ) {
    307. 

  307. 	// Hard-coded list is used if API is not accessible.
    308. 

  308. 	$features = array(
    309. 

  309. 

  310. 		__( 'Subject' )  => array(
    311. 

  311. 			'blog'           => __( 'Blog' ),
    312. 

  312. 			'e-commerce'     => __( 'E-Commerce' ),
    313. 

  313. 			'education'      => __( 'Education' ),
    314. 

  314. 			'entertainment'  => __( 'Entertainment' ),
    315. 

  315. 			'food-and-drink' => __( 'Food & Drink' ),
    316. 

  316. 			'holiday'        => __( 'Holiday' ),
    317. 

  317. 			'news'           => __( 'News' ),
    318. 

  318. 			'photography'    => __( 'Photography' ),
    319. 

  319. 			'portfolio'      => __( 'Portfolio' ),
    320. 

  320. 		),
    321. 

  321. 

  322. 		__( 'Features' ) => array(
    323. 

  323. 			'accessibility-ready'   => __( 'Accessibility Ready' ),
    324. 

  324. 			'block-patterns'        => __( 'Block Editor Patterns' ),
    325. 

  325. 			'block-styles'          => __( 'Block Editor Styles' ),
    326. 

  326. 			'custom-background'     => __( 'Custom Background' ),
    327. 

  327. 			'custom-colors'         => __( 'Custom Colors' ),
    328. 

  328. 			'custom-header'         => __( 'Custom Header' ),
    329. 

  329. 			'custom-logo'           => __( 'Custom Logo' ),
    330. 

  330. 			'editor-style'          => __( 'Editor Style' ),
    331. 

  331. 			'featured-image-header' => __( 'Featured Image Header' ),
    332. 

  332. 			'featured-images'       => __( 'Featured Images' ),
    333. 

  333. 			'footer-widgets'        => __( 'Footer Widgets' ),
    334. 

  334. 			'full-site-editing'     => __( 'Full Site Editing' ),
    335. 

  335. 			'full-width-template'   => __( 'Full Width Template' ),
    336. 

  336. 			'post-formats'          => __( 'Post Formats' ),
    337. 

  337. 			'sticky-post'           => __( 'Sticky Post' ),
    338. 

  338. 			'template-editing'      => __( 'Template Editing' ),
    339. 

  339. 			'theme-options'         => __( 'Theme Options' ),
    340. 

  340. 		),
    341. 

  341. 

  342. 		__( 'Layout' )   => array(
    343. 

  343. 			'grid-layout'   => __( 'Grid Layout' ),
    344. 

  344. 			'one-column'    => __( 'One Column' ),
    345. 

  345. 			'two-columns'   => __( 'Two Columns' ),
    346. 

  346. 			'three-columns' => __( 'Three Columns' ),
    347. 

  347. 			'four-columns'  => __( 'Four Columns' ),
    348. 

  348. 			'left-sidebar'  => __( 'Left Sidebar' ),
    349. 

  349. 			'right-sidebar' => __( 'Right Sidebar' ),
    350. 

  350. 			'wide-blocks'   => __( 'Wide Blocks' ),
    351. 

  351. 		),
    352. 

  352. 

  353. 	);
    354. 

  354. 

  355. 	if ( ! $api || ! current_user_can( 'install_themes' ) ) {
    356. 

  356. 		return $features;
    357. 

  357. 	}
    358. 

  358. 

  359. 	$feature_list = get_site_transient( 'wporg_theme_feature_list' );
    360. 

  360. 	if ( ! $feature_list ) {
    361. 

  361. 		set_site_transient( 'wporg_theme_feature_list', array(), 3 * HOUR_IN_SECONDS );
    362. 

  362. 	}
    363. 

  363. 

  364. 	if ( ! $feature_list ) {
    365. 

  365. 		$feature_list = themes_api( 'feature_list', array() );
    366. 

  366. 		if ( is_wp_error( $feature_list ) ) {
    367. 

  367. 			return $features;
    368. 

  368. 		}
    369. 

  369. 	}
    370. 

  370. 

  371. 	if ( ! $feature_list ) {
    372. 

  372. 		return $features;
    373. 

  373. 	}
    374. 

  374. 

  375. 	set_site_transient( 'wporg_theme_feature_list', $feature_list, 3 * HOUR_IN_SECONDS );
    376. 

  376. 

  377. 	$category_translations = array(
    378. 

  378. 		'Layout'   => __( 'Layout' ),
    379. 

  379. 		'Features' => __( 'Features' ),
    380. 

  380. 		'Subject'  => __( 'Subject' ),
    381. 

  381. 	);
    382. 

  382. 

  383. 	$wporg_features = array();
    384. 

  384. 

  385. 	// Loop over the wp.org canonical list and apply translations.
    386. 

  386. 	foreach ( (array) $feature_list as $feature_category => $feature_items ) {
    387. 

  387. 		if ( isset( $category_translations[ $feature_category ] ) ) {
    388. 

  388. 			$feature_category = $category_translations[ $feature_category ];
    389. 

  389. 		}
    390. 

  390. 

  391. 		$wporg_features[ $feature_category ] = array();
    392. 

  392. 

  393. 		foreach ( $feature_items as $feature ) {
    394. 

  394. 			if ( isset( $features[ $feature_category ][ $feature ] ) ) {
    395. 

  395. 				$wporg_features[ $feature_category ][ $feature ] = $features[ $feature_category ][ $feature ];
    396. 

  396. 			} else {
    397. 

  397. 				$wporg_features[ $feature_category ][ $feature ] = $feature;
    398. 

  398. 			}
    399. 

  399. 		}
    400. 

  400. 	}
    401. 

  401. 

  402. 	return $wporg_features;
    403. 

  403. }
    404. 

  404. 

  405. /**
    406. 

  406.  * Retrieves theme installer pages from the WordPress.org Themes API.
    407. 

  407.  *
    408. 

  408.  * It is possible for a theme to override the Themes API result with three
    409. 

  409.  * filters. Assume this is for themes, which can extend on the Theme Info to
    410. 

  410.  * offer more choices. This is very powerful and must be used with care, when
    411. 

  411.  * overriding the filters.
    412. 

  412.  *
    413. 

  413.  * The first filter, {@see 'themes_api_args'}, is for the args and gives the action
    414. 

  414.  * as the second parameter. The hook for {@see 'themes_api_args'} must ensure that
    415. 

  415.  * an object is returned.
    416. 

  416.  *
    417. 

  417.  * The second filter, {@see 'themes_api'}, allows a plugin to override the WordPress.org
    418. 

  418.  * Theme API entirely. If `$action` is 'query_themes', 'theme_information', or 'feature_list',
    419. 

  419.  * an object MUST be passed. If `$action` is 'hot_tags', an array should be passed.
    420. 

  420.  *
    421. 

  421.  * Finally, the third filter, {@see 'themes_api_result'}, makes it possible to filter the
    422. 

  422.  * response object or array, depending on the `$action` type.
    423. 

  423.  *
    424. 

  424.  * Supported arguments per action:
    425. 

  425.  *
    426. 

  426.  * | Argument Name      | 'query_themes' | 'theme_information' | 'hot_tags' | 'feature_list'   |
    427. 

  427.  * | -------------------| :------------: | :-----------------: | :--------: | :--------------: |
    428. 

  428.  * | `$slug`            | No             |  Yes                | No         | No               |
    429. 

  429.  * | `$per_page`        | Yes            |  No                 | No         | No               |
    430. 

  430.  * | `$page`            | Yes            |  No                 | No         | No               |
    431. 

  431.  * | `$number`          | No             |  No                 | Yes        | No               |
    432. 

  432.  * | `$search`          | Yes            |  No                 | No         | No               |
    433. 

  433.  * | `$tag`             | Yes            |  No                 | No         | No               |
    434. 

  434.  * | `$author`          | Yes            |  No                 | No         | No               |
    435. 

  435.  * | `$user`            | Yes            |  No                 | No         | No               |
    436. 

  436.  * | `$browse`          | Yes            |  No                 | No         | No               |
    437. 

  437.  * | `$locale`          | Yes            |  Yes                | No         | No               |
    438. 

  438.  * | `$fields`          | Yes            |  Yes                | No         | No               |
    439. 

  439.  *
    440. 

  440.  * @since 2.8.0
    441. 

  441.  *
    442. 

  442.  * @param string       $action API action to perform: 'query_themes', 'theme_information',
    443. 

  443.  *                             'hot_tags' or 'feature_list'.
    444. 

  444.  * @param array|object $args   {
    445. 

  445.  *     Optional. Array or object of arguments to serialize for the Themes API.
    446. 

  446.  *
    447. 

  447.  *     @type string  $slug     The theme slug. Default empty.
    448. 

  448.  *     @type int     $per_page Number of themes per page. Default 24.
    449. 

  449.  *     @type int     $page     Number of current page. Default 1.
    450. 

  450.  *     @type int     $number   Number of tags to be queried.
    451. 

  451.  *     @type string  $search   A search term. Default empty.
    452. 

  452.  *     @type string  $tag      Tag to filter themes. Default empty.
    453. 

  453.  *     @type string  $author   Username of an author to filter themes. Default empty.
    454. 

  454.  *     @type string  $user     Username to query for their favorites. Default empty.
    455. 

  455.  *     @type string  $browse   Browse view: 'featured', 'popular', 'updated', 'favorites'.
    456. 

  456.  *     @type string  $locale   Locale to provide context-sensitive results. Default is the value of get_locale().
    457. 

  457.  *     @type array   $fields   {
    458. 

  458.  *         Array of fields which should or should not be returned.
    459. 

  459.  *
    460. 

  460.  *         @type bool $description        Whether to return the theme full description. Default false.
    461. 

  461.  *         @type bool $sections           Whether to return the theme readme sections: description, installation,
    462. 

  462.  *                                        FAQ, screenshots, other notes, and changelog. Default false.
    463. 

  463.  *         @type bool $rating             Whether to return the rating in percent and total number of ratings.
    464. 

  464.  *                                        Default false.
    465. 

  465.  *         @type bool $ratings            Whether to return the number of rating for each star (1-5). Default false.
    466. 

  466.  *         @type bool $downloaded         Whether to return the download count. Default false.
    467. 

  467.  *         @type bool $downloadlink       Whether to return the download link for the package. Default false.
    468. 

  468.  *         @type bool $last_updated       Whether to return the date of the last update. Default false.
    469. 

  469.  *         @type bool $tags               Whether to return the assigned tags. Default false.
    470. 

  470.  *         @type bool $homepage           Whether to return the theme homepage link. Default false.
    471. 

  471.  *         @type bool $screenshots        Whether to return the screenshots. Default false.
    472. 

  472.  *         @type int  $screenshot_count   Number of screenshots to return. Default 1.
    473. 

  473.  *         @type bool $screenshot_url     Whether to return the URL of the first screenshot. Default false.
    474. 

  474.  *         @type bool $photon_screenshots Whether to return the screenshots via Photon. Default false.
    475. 

  475.  *         @type bool $template           Whether to return the slug of the parent theme. Default false.
    476. 

  476.  *         @type bool $parent             Whether to return the slug, name and homepage of the parent theme. Default false.
    477. 

  477.  *         @type bool $versions           Whether to return the list of all available versions. Default false.
    478. 

  478.  *         @type bool $theme_url          Whether to return theme's URL. Default false.
    479. 

  479.  *         @type bool $extended_author    Whether to return nicename or nicename and display name. Default false.
    480. 

  480.  *     }
    481. 

  481.  * }
    482. 

  482.  * @return object|array|WP_Error Response object or array on success, WP_Error on failure. See the
    483. 

  483.  *         {@link https://developer.wordpress.org/reference/functions/themes_api/ function reference article}
    484. 

  484.  *         for more information on the make-up of possible return objects depending on the value of `$action`.
    485. 

  485.  */
    486. 

  486. function themes_api( $action, $args = array() ) {
    487. 

  487. 	// Include an unmodified $wp_version.
    488. 

  488. 	require ABSPATH . WPINC . '/version.php';
    489. 

  489. 

  490. 	if ( is_array( $args ) ) {
    491. 

  491. 		$args = (object) $args;
    492. 

  492. 	}
    493. 

  493. 

  494. 	if ( 'query_themes' === $action ) {
    495. 

  495. 		if ( ! isset( $args->per_page ) ) {
    496. 

  496. 			$args->per_page = 24;
    497. 

  497. 		}
    498. 

  498. 	}
    499. 

  499. 

  500. 	if ( ! isset( $args->locale ) ) {
    501. 

  501. 		$args->locale = get_user_locale();
    502. 

  502. 	}
    503. 

  503. 

  504. 	if ( ! isset( $args->wp_version ) ) {
    505. 

  505. 		$args->wp_version = substr( $wp_version, 0, 3 ); // x.y
    506. 

  506. 	}
    507. 

  507. 

  508. 	/**
    509. 

  509. 	 * Filters arguments used to query for installer pages from the WordPress.org Themes API.
    510. 

  510. 	 *
    511. 

  511. 	 * Important: An object MUST be returned to this filter.
    512. 

  512. 	 *
    513. 

  513. 	 * @since 2.8.0
    514. 

  514. 	 *
    515. 

  515. 	 * @param object $args   Arguments used to query for installer pages from the WordPress.org Themes API.
    516. 

  516. 	 * @param string $action Requested action. Likely values are 'theme_information',
    517. 

  517. 	 *                       'feature_list', or 'query_themes'.
    518. 

  518. 	 */
    519. 

  519. 	$args = apply_filters( 'themes_api_args', $args, $action );
    520. 

  520. 

  521. 	/**
    522. 

  522. 	 * Filters whether to override the WordPress.org Themes API.
    523. 

  523. 	 *
    524. 

  524. 	 * Passing a non-false value will effectively short-circuit the WordPress.org API request.
    525. 

  525. 	 *
    526. 

  526. 	 * If `$action` is 'query_themes', 'theme_information', or 'feature_list', an object MUST
    527. 

  527. 	 * be passed. If `$action` is 'hot_tags', an array should be passed.
    528. 

  528. 	 *
    529. 

  529. 	 * @since 2.8.0
    530. 

  530. 	 *
    531. 

  531. 	 * @param false|object|array $override Whether to override the WordPress.org Themes API. Default false.
    532. 

  532. 	 * @param string             $action   Requested action. Likely values are 'theme_information',
    533. 

  533. 	 *                                    'feature_list', or 'query_themes'.
    534. 

  534. 	 * @param object             $args     Arguments used to query for installer pages from the Themes API.
    535. 

  535. 	 */
    536. 

  536. 	$res = apply_filters( 'themes_api', false, $action, $args );
    537. 

  537. 

  538. 	if ( ! $res ) {
    539. 

  539. 		$url = 'http://api.wordpress.org/themes/info/1.2/';
    540. 

  540. 		$url = add_query_arg(
    541. 

  541. 			array(
    542. 

  542. 				'action'  => $action,
    543. 

  543. 				'request' => $args,
    544. 

  544. 			),
    545. 

  545. 			$url
    546. 

  546. 		);
    547. 

  547. 

  548. 		$http_url = $url;
    549. 

  549. 		$ssl      = wp_http_supports( array( 'ssl' ) );
    550. 

  550. 		if ( $ssl ) {
    551. 

  551. 			$url = set_url_scheme( $url, 'https' );
    552. 

  552. 		}
    553. 

  553. 

  554. 		$http_args = array(
    555. 

  555. 			'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url( '/' ),
    556. 

  556. 		);
    557. 

  557. 		$request   = wp_remote_get( $url, $http_args );
    558. 

  558. 

  559. 		if ( $ssl && is_wp_error( $request ) ) {
    560. 

  560. 			if ( ! wp_doing_ajax() ) {
    561. 

  561. 				trigger_error(
    562. 

  562. 					sprintf(
    563. 

  563. 						/* translators: %s: Support forums URL. */
    564. 

  564. 						__( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),
    565. 

  565. 						__( 'https://wordpress.org/support/forums/' )
    566. 

  566. 					) . ' ' . __( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ),
    567. 

  567. 					headers_sent() || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE
    568. 

  568. 				);
    569. 

  569. 			}
    570. 

  570. 			$request = wp_remote_get( $http_url, $http_args );
    571. 

  571. 		}
    572. 

  572. 

  573. 		if ( is_wp_error( $request ) ) {
    574. 

  574. 			$res = new WP_Error(
    575. 

  575. 				'themes_api_failed',
    576. 

  576. 				sprintf(
    577. 

  577. 					/* translators: %s: Support forums URL. */
    578. 

  578. 					__( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),
    579. 

  579. 					__( 'https://wordpress.org/support/forums/' )
    580. 

  580. 				),
    581. 

  581. 				$request->get_error_message()
    582. 

  582. 			);
    583. 

  583. 		} else {
    584. 

  584. 			$res = json_decode( wp_remote_retrieve_body( $request ), true );
    585. 

  585. 			if ( is_array( $res ) ) {
    586. 

  586. 				// Object casting is required in order to match the info/1.0 format.
    587. 

  587. 				$res = (object) $res;
    588. 

  588. 			} elseif ( null === $res ) {
    589. 

  589. 				$res = new WP_Error(
    590. 

  590. 					'themes_api_failed',
    591. 

  591. 					sprintf(
    592. 

  592. 						/* translators: %s: Support forums URL. */
    593. 

  593. 						__( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="%s">support forums</a>.' ),
    594. 

  594. 						__( 'https://wordpress.org/support/forums/' )
    595. 

  595. 					),
    596. 

  596. 					wp_remote_retrieve_body( $request )
    597. 

  597. 				);
    598. 

  598. 			}
    599. 

  599. 

  600. 			if ( isset( $res->error ) ) {
    601. 

  601. 				$res = new WP_Error( 'themes_api_failed', $res->error );
    602. 

  602. 			}
    603. 

  603. 		}
    604. 

  604. 

  605. 		// Back-compat for info/1.2 API, upgrade the theme objects in query_themes to objects.
    606. 

  606. 		if ( 'query_themes' === $action ) {
    607. 

  607. 			foreach ( $res->themes as $i => $theme ) {
    608. 

  608. 				$res->themes[ $i ] = (object) $theme;
    609. 

  609. 			}
    610. 

  610. 		}
    611. 

  611. 		// Back-compat for info/1.2 API, downgrade the feature_list result back to an array.
    612. 

  612. 		if ( 'feature_list' === $action ) {
    613. 

  613. 			$res = (array) $res;
    614. 

  614. 		}
    615. 

  615. 	}
    616. 

  616. 

  617. 	/**
    618. 

  618. 	 * Filters the returned WordPress.org Themes API response.
    619. 

  619. 	 *
    620. 

  620. 	 * @since 2.8.0
    621. 

  621. 	 *
    622. 

  622. 	 * @param array|object|WP_Error $res    WordPress.org Themes API response.
    623. 

  623. 	 * @param string                $action Requested action. Likely values are 'theme_information',
    624. 

  624. 	 *                                      'feature_list', or 'query_themes'.
    625. 

  625. 	 * @param object                $args   Arguments used to query for installer pages from the WordPress.org Themes API.
    626. 

  626. 	 */
    627. 

  627. 	return apply_filters( 'themes_api_result', $res, $action, $args );
    628. 

  628. }
    629. 

  629. 

  630. /**
    631. 

  631.  * Prepare themes for JavaScript.
    632. 

  632.  *
    633. 

  633.  * @since 3.8.0
    634. 

  634.  *
    635. 

  635.  * @param WP_Theme[] $themes Optional. Array of theme objects to prepare.
    636. 

  636.  *                           Defaults to all allowed themes.
    637. 

  637.  *
    638. 

  638.  * @return array An associative array of theme data, sorted by name.
    639. 

  639.  */
    640. 

  640. function wp_prepare_themes_for_js( $themes = null ) {
    641. 

  641. 	$current_theme = get_stylesheet();
    642. 

  642. 

  643. 	/**
    644. 

  644. 	 * Filters theme data before it is prepared for JavaScript.
    645. 

  645. 	 *
    646. 

  646. 	 * Passing a non-empty array will result in wp_prepare_themes_for_js() returning
    647. 

  647. 	 * early with that value instead.
    648. 

  648. 	 *
    649. 

  649. 	 * @since 4.2.0
    650. 

  650. 	 *
    651. 

  651. 	 * @param array           $prepared_themes An associative array of theme data. Default empty array.
    652. 

  652. 	 * @param WP_Theme[]|null $themes          An array of theme objects to prepare, if any.
    653. 

  653. 	 * @param string          $current_theme   The current theme slug.
    654. 

  654. 	 */
    655. 

  655. 	$prepared_themes = (array) apply_filters( 'pre_prepare_themes_for_js', array(), $themes, $current_theme );
    656. 

  656. 

  657. 	if ( ! empty( $prepared_themes ) ) {
    658. 

  658. 		return $prepared_themes;
    659. 

  659. 	}
    660. 

  660. 

  661. 	// Make sure the current theme is listed first.
    662. 

  662. 	$prepared_themes[ $current_theme ] = array();
    663. 

  663. 

  664. 	if ( null === $themes ) {
    665. 

  665. 		$themes = wp_get_themes( array( 'allowed' => true ) );
    666. 

  666. 		if ( ! isset( $themes[ $current_theme ] ) ) {
    667. 

  667. 			$themes[ $current_theme ] = wp_get_theme();
    668. 

  668. 		}
    669. 

  669. 	}
    670. 

  670. 

  671. 	$updates    = array();
    672. 

  672. 	$no_updates = array();
    673. 

  673. 	if ( ! is_multisite() && current_user_can( 'update_themes' ) ) {
    674. 

  674. 		$updates_transient = get_site_transient( 'update_themes' );
    675. 

  675. 		if ( isset( $updates_transient->response ) ) {
    676. 

  676. 			$updates = $updates_transient->response;
    677. 

  677. 		}
    678. 

  678. 		if ( isset( $updates_transient->no_update ) ) {
    679. 

  679. 			$no_updates = $updates_transient->no_update;
    680. 

  680. 		}
    681. 

  681. 	}
    682. 

  682. 

  683. 	WP_Theme::sort_by_name( $themes );
    684. 

  684. 

  685. 	$parents = array();
    686. 

  686. 

  687. 	$auto_updates = (array) get_site_option( 'auto_update_themes', array() );
    688. 

  688. 

  689. 	foreach ( $themes as $theme ) {
    690. 

  690. 		$slug         = $theme->get_stylesheet();
    691. 

  691. 		$encoded_slug = urlencode( $slug );
    692. 

  692. 

  693. 		$parent = false;
    694. 

  694. 		if ( $theme->parent() ) {
    695. 

  695. 			$parent           = $theme->parent();
    696. 

  696. 			$parents[ $slug ] = $parent->get_stylesheet();
    697. 

  697. 			$parent           = $parent->display( 'Name' );
    698. 

  698. 		}
    699. 

  699. 

  700. 		$customize_action = null;
    701. 

  701. 		if ( current_user_can( 'edit_theme_options' ) && current_user_can( 'customize' ) ) {
    702. 

  702. 			$customize_action = esc_url(
    703. 

  703. 				add_query_arg(
    704. 

  704. 					array(
    705. 

  705. 						'return' => urlencode( esc_url_raw( remove_query_arg( wp_removable_query_args(), wp_unslash( $_SERVER['REQUEST_URI'] ) ) ) ),
    706. 

  706. 					),
    707. 

  707. 					wp_customize_url( $slug )
    708. 

  708. 				)
    709. 

  709. 			);
    710. 

  710. 		}
    711. 

  711. 

  712. 		$update_requires_wp  = isset( $updates[ $slug ]['requires'] ) ? $updates[ $slug ]['requires'] : null;
    713. 

  713. 		$update_requires_php = isset( $updates[ $slug ]['requires_php'] ) ? $updates[ $slug ]['requires_php'] : null;
    714. 

  714. 

  715. 		$auto_update        = in_array( $slug, $auto_updates, true );
    716. 

  716. 		$auto_update_action = $auto_update ? 'disable-auto-update' : 'enable-auto-update';
    717. 

  717. 

  718. 		if ( isset( $updates[ $slug ] ) ) {
    719. 

  719. 			$auto_update_supported      = true;
    720. 

  720. 			$auto_update_filter_payload = (object) $updates[ $slug ];
    721. 

  721. 		} elseif ( isset( $no_updates[ $slug ] ) ) {
    722. 

  722. 			$auto_update_supported      = true;
    723. 

  723. 			$auto_update_filter_payload = (object) $no_updates[ $slug ];
    724. 

  724. 		} else {
    725. 

  725. 			$auto_update_supported = false;
    726. 

  726. 			/*
    727. 

  727. 			 * Create the expected payload for the auto_update_theme filter, this is the same data
    728. 

  728. 			 * as contained within $updates or $no_updates but used when the Theme is not known.
    729. 

  729. 			 */
    730. 

  730. 			$auto_update_filter_payload = (object) array(
    731. 

  731. 				'theme'        => $slug,
    732. 

  732. 				'new_version'  => $theme->get( 'Version' ),
    733. 

  733. 				'url'          => '',
    734. 

  734. 				'package'      => '',
    735. 

  735. 				'requires'     => $theme->get( 'RequiresWP' ),
    736. 

  736. 				'requires_php' => $theme->get( 'RequiresPHP' ),
    737. 

  737. 			);
    738. 

  738. 		}
    739. 

  739. 

  740. 		$auto_update_forced = wp_is_auto_update_forced_for_item( 'theme', null, $auto_update_filter_payload );
    741. 

  741. 

  742. 		$prepared_themes[ $slug ] = array(
    743. 

  743. 			'id'             => $slug,
    744. 

  744. 			'name'           => $theme->display( 'Name' ),
    745. 

  745. 			'screenshot'     => array( $theme->get_screenshot() ), // @todo Multiple screenshots.
    746. 

  746. 			'description'    => $theme->display( 'Description' ),
    747. 

  747. 			'author'         => $theme->display( 'Author', false, true ),
    748. 

  748. 			'authorAndUri'   => $theme->display( 'Author' ),
    749. 

  749. 			'tags'           => $theme->display( 'Tags' ),
    750. 

  750. 			'version'        => $theme->get( 'Version' ),
    751. 

  751. 			'compatibleWP'   => is_wp_version_compatible( $theme->get( 'RequiresWP' ) ),
    752. 

  752. 			'compatiblePHP'  => is_php_version_compatible( $theme->get( 'RequiresPHP' ) ),
    753. 

  753. 			'updateResponse' => array(
    754. 

  754. 				'compatibleWP'  => is_wp_version_compatible( $update_requires_wp ),
    755. 

  755. 				'compatiblePHP' => is_php_version_compatible( $update_requires_php ),
    756. 

  756. 			),
    757. 

  757. 			'parent'         => $parent,
    758. 

  758. 			'active'         => $slug === $current_theme,
    759. 

  759. 			'hasUpdate'      => isset( $updates[ $slug ] ),
    760. 

  760. 			'hasPackage'     => isset( $updates[ $slug ] ) && ! empty( $updates[ $slug ]['package'] ),
    761. 

  761. 			'update'         => get_theme_update_available( $theme ),
    762. 

  762. 			'autoupdate'     => array(
    763. 

  763. 				'enabled'   => $auto_update || $auto_update_forced,
    764. 

  764. 				'supported' => $auto_update_supported,
    765. 

  765. 				'forced'    => $auto_update_forced,
    766. 

  766. 			),
    767. 

  767. 			'actions'        => array(
    768. 

  768. 				'activate'   => current_user_can( 'switch_themes' ) ? wp_nonce_url( admin_url( 'themes.php?action=activate&amp;stylesheet=' . $encoded_slug ), 'switch-theme_' . $slug ) : null,
    769. 

  769. 				'customize'  => $customize_action,
    770. 

  770. 				'delete'     => ( ! is_multisite() && current_user_can( 'delete_themes' ) ) ? wp_nonce_url( admin_url( 'themes.php?action=delete&amp;stylesheet=' . $encoded_slug ), 'delete-theme_' . $slug ) : null,
    771. 

  771. 				'autoupdate' => wp_is_auto_update_enabled_for_type( 'theme' ) && ! is_multisite() && current_user_can( 'update_themes' )
    772. 

  772. 					? wp_nonce_url( admin_url( 'themes.php?action=' . $auto_update_action . '&amp;stylesheet=' . $encoded_slug ), 'updates' )
    773. 

  773. 					: null,
    774. 

  774. 			),
    775. 

  775. 		);
    776. 

  776. 	}
    777. 

  777. 

  778. 	// Remove 'delete' action if theme has an active child.
    779. 

  779. 	if ( ! empty( $parents ) && array_key_exists( $current_theme, $parents ) ) {
    780. 

  780. 		unset( $prepared_themes[ $parents[ $current_theme ] ]['actions']['delete'] );
    781. 

  781. 	}
    782. 

  782. 

  783. 	/**
    784. 

  784. 	 * Filters the themes prepared for JavaScript, for themes.php.
    785. 

  785. 	 *
    786. 

  786. 	 * Could be useful for changing the order, which is by name by default.
    787. 

  787. 	 *
    788. 

  788. 	 * @since 3.8.0
    789. 

  789. 	 *
    790. 

  790. 	 * @param array $prepared_themes Array of theme data.
    791. 

  791. 	 */
    792. 

  792. 	$prepared_themes = apply_filters( 'wp_prepare_themes_for_js', $prepared_themes );
    793. 

  793. 	$prepared_themes = array_values( $prepared_themes );
    794. 

  794. 	return array_filter( $prepared_themes );
    795. 

  795. }
    796. 

  796. 

  797. /**
    798. 

  798.  * Print JS templates for the theme-browsing UI in the Customizer.
    799. 

  799.  *
    800. 

  800.  * @since 4.2.0
    801. 

  801.  */
    802. 

  802. function customize_themes_print_templates() {
    803. 

  803. 	?>
    804. 

  804. 	<script type="text/html" id="tmpl-customize-themes-details-view">
    805. 

  805. 		<div class="theme-backdrop"></div>
    806. 

  806. 		<div class="theme-wrap wp-clearfix" role="document">
    807. 

  807. 			<div class="theme-header">
    808. 

  808. 				<button type="button" class="left dashicons dashicons-no"><span class="screen-reader-text"><?php _e( 'Show previous theme' ); ?></span></button>
    809. 

  809. 				<button type="button" class="right dashicons dashicons-no"><span class="screen-reader-text"><?php _e( 'Show next theme' ); ?></span></button>
    810. 

  810. 				<button type="button" class="close dashicons dashicons-no"><span class="screen-reader-text"><?php _e( 'Close details dialog' ); ?></span></button>
    811. 

  811. 			</div>
    812. 

  812. 			<div class="theme-about wp-clearfix">
    813. 

  813. 				<div class="theme-screenshots">
    814. 

  814. 				<# if ( data.screenshot && data.screenshot[0] ) { #>
    815. 

  815. 					<div class="screenshot"><img src="{{ data.screenshot[0] }}" alt="" /></div>
    816. 

  816. 				<# } else { #>
    817. 

  817. 					<div class="screenshot blank"></div>
    818. 

  818. 				<# } #>
    819. 

  819. 				</div>
    820. 

  820. 

  821. 				<div class="theme-info">
    822. 

  822. 					<# if ( data.active ) { #>
    823. 

  823. 						<span class="current-label"><?php _e( 'Current Theme' ); ?></span>
    824. 

  824. 					<# } #>
    825. 

  825. 					<h2 class="theme-name">{{{ data.name }}}<span class="theme-version">
    826. 

  826. 						<?php
    827. 

  827. 						/* translators: %s: Theme version. */
    828. 

  828. 						printf( __( 'Version: %s' ), '{{ data.version }}' );
    829. 

  829. 						?>
    830. 

  830. 					</span></h2>
    831. 

  831. 					<h3 class="theme-author">
    832. 

  832. 						<?php
    833. 

  833. 						/* translators: %s: Theme author link. */
    834. 

  834. 						printf( __( 'By %s' ), '{{{ data.authorAndUri }}}' );
    835. 

  835. 						?>
    836. 

  836. 					</h3>
    837. 

  837. 

  838. 					<# if ( data.stars && 0 != data.num_ratings ) { #>
    839. 

  839. 						<div class="theme-rating">
    840. 

  840. 							{{{ data.stars }}}
    841. 

  841. 							<a class="num-ratings" target="_blank" href="{{ data.reviews_url }}">
    842. 

  842. 								<?php
    843. 

  843. 								printf(
    844. 

  844. 									'%1$s <span class="screen-reader-text">%2$s</span>',
    845. 

  845. 									/* translators: %s: Number of ratings. */
    846. 

  846. 									sprintf( __( '(%s ratings)' ), '{{ data.num_ratings }}' ),
    847. 

  847. 									/* translators: Accessibility text. */
    848. 

  848. 									__( '(opens in a new tab)' )
    849. 

  849. 								);
    850. 

  850. 								?>
    851. 

  851. 							</a>
    852. 

  852. 						</div>
    853. 

  853. 					<# } #>
    854. 

  854. 

  855. 					<# if ( data.hasUpdate ) { #>
    856. 

  856. 						<# if ( data.updateResponse.compatibleWP && data.updateResponse.compatiblePHP ) { #>
    857. 

  857. 							<div class="notice notice-warning notice-alt notice-large" data-slug="{{ data.id }}">
    858. 

  858. 								<h3 class="notice-title"><?php _e( 'Update Available' ); ?></h3>
    859. 

  859. 								{{{ data.update }}}
    860. 

  860. 							</div>
    861. 

  861. 						<# } else { #>
    862. 

  862. 							<div class="notice notice-error notice-alt notice-large" data-slug="{{ data.id }}">
    863. 

  863. 								<h3 class="notice-title"><?php _e( 'Update Incompatible' ); ?></h3>
    864. 

  864. 								<p>
    865. 

  865. 									<# if ( ! data.updateResponse.compatibleWP && ! data.updateResponse.compatiblePHP ) { #>
    866. 

  866. 										<?php
    867. 

  867. 										printf(
    868. 

  868. 											/* translators: %s: Theme name. */
    869. 

  869. 											__( 'There is a new version of %s available, but it doesn&#8217;t work with your versions of WordPress and PHP.' ),
    870. 

  870. 											'{{{ data.name }}}'
    871. 

  871. 										);
    872. 

  872. 										if ( current_user_can( 'update_core' ) && current_user_can( 'update_php' ) ) {
    873. 

  873. 											printf(
    874. 

  874. 												/* translators: 1: URL to WordPress Updates screen, 2: URL to Update PHP page. */
    875. 

  875. 												' ' . __( '<a href="%1$s">Please update WordPress</a>, and then <a href="%2$s">learn more about updating PHP</a>.' ),
    876. 

  876. 												self_admin_url( 'update-core.php' ),
    877. 

  877. 												esc_url( wp_get_update_php_url() )
    878. 

  878. 											);
    879. 

  879. 											wp_update_php_annotation( '</p><p><em>', '</em>' );
    880. 

  880. 										} elseif ( current_user_can( 'update_core' ) ) {
    881. 

  881. 											printf(
    882. 

  882. 												/* translators: %s: URL to WordPress Updates screen. */
    883. 

  883. 												' ' . __( '<a href="%s">Please update WordPress</a>.' ),
    884. 

  884. 												self_admin_url( 'update-core.php' )
    885. 

  885. 											);
    886. 

  886. 										} elseif ( current_user_can( 'update_php' ) ) {
    887. 

  887. 											printf(
    888. 

  888. 												/* translators: %s: URL to Update PHP page. */
    889. 

  889. 												' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ),
    890. 

  890. 												esc_url( wp_get_update_php_url() )
    891. 

  891. 											);
    892. 

  892. 											wp_update_php_annotation( '</p><p><em>', '</em>' );
    893. 

  893. 										}
    894. 

  894. 										?>
    895. 

  895. 									<# } else if ( ! data.updateResponse.compatibleWP ) { #>
    896. 

  896. 										<?php
    897. 

  897. 										printf(
    898. 

  898. 											/* translators: %s: Theme name. */
    899. 

  899. 											__( 'There is a new version of %s available, but it doesn&#8217;t work with your version of WordPress.' ),
    900. 

  900. 											'{{{ data.name }}}'
    901. 

  901. 										);
    902. 

  902. 										if ( current_user_can( 'update_core' ) ) {
    903. 

  903. 											printf(
    904. 

  904. 												/* translators: %s: URL to WordPress Updates screen. */
    905. 

  905. 												' ' . __( '<a href="%s">Please update WordPress</a>.' ),
    906. 

  906. 												self_admin_url( 'update-core.php' )
    907. 

  907. 											);
    908. 

  908. 										}
    909. 

  909. 										?>
    910. 

  910. 									<# } else if ( ! data.updateResponse.compatiblePHP ) { #>
    911. 

  911. 										<?php
    912. 

  912. 										printf(
    913. 

  913. 											/* translators: %s: Theme name. */
    914. 

  914. 											__( 'There is a new version of %s available, but it doesn&#8217;t work with your version of PHP.' ),
    915. 

  915. 											'{{{ data.name }}}'
    916. 

  916. 										);
    917. 

  917. 										if ( current_user_can( 'update_php' ) ) {
    918. 

  918. 											printf(
    919. 

  919. 												/* translators: %s: URL to Update PHP page. */
    920. 

  920. 												' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ),
    921. 

  921. 												esc_url( wp_get_update_php_url() )
    922. 

  922. 											);
    923. 

  923. 											wp_update_php_annotation( '</p><p><em>', '</em>' );
    924. 

  924. 										}
    925. 

  925. 										?>
    926. 

  926. 									<# } #>
    927. 

  927. 								</p>
    928. 

  928. 							</div>
    929. 

  929. 						<# } #>
    930. 

  930. 					<# } #>
    931. 

  931. 

  932. 					<# if ( data.parent ) { #>
    933. 

  933. 						<p class="parent-theme">
    934. 

  934. 							<?php
    935. 

  935. 							printf(
    936. 

  936. 								/* translators: %s: Theme name. */
    937. 

  937. 								__( 'This is a child theme of %s.' ),
    938. 

  938. 								'<strong>{{{ data.parent }}}</strong>'
    939. 

  939. 							);
    940. 

  940. 							?>
    941. 

  941. 						</p>
    942. 

  942. 					<# } #>
    943. 

  943. 

  944. 					<# if ( ! data.compatibleWP || ! data.compatiblePHP ) { #>
    945. 

  945. 						<div class="notice notice-error notice-alt notice-large"><p>
    946. 

  946. 							<# if ( ! data.compatibleWP && ! data.compatiblePHP ) { #>
    947. 

  947. 								<?php
    948. 

  948. 								_e( 'This theme doesn&#8217;t work with your versions of WordPress and PHP.' );
    949. 

  949. 								if ( current_user_can( 'update_core' ) && current_user_can( 'update_php' ) ) {
    950. 

  950. 									printf(
    951. 

  951. 										/* translators: 1: URL to WordPress Updates screen, 2: URL to Update PHP page. */
    952. 

  952. 										' ' . __( '<a href="%1$s">Please update WordPress</a>, and then <a href="%2$s">learn more about updating PHP</a>.' ),
    953. 

  953. 										self_admin_url( 'update-core.php' ),
    954. 

  954. 										esc_url( wp_get_update_php_url() )
    955. 

  955. 									);
    956. 

  956. 									wp_update_php_annotation( '</p><p><em>', '</em>' );
    957. 

  957. 								} elseif ( current_user_can( 'update_core' ) ) {
    958. 

  958. 									printf(
    959. 

  959. 										/* translators: %s: URL to WordPress Updates screen. */
    960. 

  960. 										' ' . __( '<a href="%s">Please update WordPress</a>.' ),
    961. 

  961. 										self_admin_url( 'update-core.php' )
    962. 

  962. 									);
    963. 

  963. 								} elseif ( current_user_can( 'update_php' ) ) {
    964. 

  964. 									printf(
    965. 

  965. 										/* translators: %s: URL to Update PHP page. */
    966. 

  966. 										' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ),
    967. 

  967. 										esc_url( wp_get_update_php_url() )
    968. 

  968. 									);
    969. 

  969. 									wp_update_php_annotation( '</p><p><em>', '</em>' );
    970. 

  970. 								}
    971. 

  971. 								?>
    972. 

  972. 							<# } else if ( ! data.compatibleWP ) { #>
    973. 

  973. 								<?php
    974. 

  974. 								_e( 'This theme doesn&#8217;t work with your version of WordPress.' );
    975. 

  975. 								if ( current_user_can( 'update_core' ) ) {
    976. 

  976. 									printf(
    977. 

  977. 										/* translators: %s: URL to WordPress Updates screen. */
    978. 

  978. 										' ' . __( '<a href="%s">Please update WordPress</a>.' ),
    979. 

  979. 										self_admin_url( 'update-core.php' )
    980. 

  980. 									);
    981. 

  981. 								}
    982. 

  982. 								?>
    983. 

  983. 							<# } else if ( ! data.compatiblePHP ) { #>
    984. 

  984. 								<?php
    985. 

  985. 								_e( 'This theme doesn&#8217;t work with your version of PHP.' );
    986. 

  986. 								if ( current_user_can( 'update_php' ) ) {
    987. 

  987. 									printf(
    988. 

  988. 										/* translators: %s: URL to Update PHP page. */
    989. 

  989. 										' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ),
    990. 

  990. 										esc_url( wp_get_update_php_url() )
    991. 

  991. 									);
    992. 

  992. 									wp_update_php_annotation( '</p><p><em>', '</em>' );
    993. 

  993. 								}
    994. 

  994. 								?>
    995. 

  995. 							<# } #>
    996. 

  996. 						</p></div>
    997. 

  997. 					<# } #>
    998. 

  998. 

  999. 					<p class="theme-description">{{{ data.description }}}</p>
    1000. 

  1000. 

  1001. 					<# if ( data.tags ) { #>
    1002. 

  1002. 						<p class="theme-tags"><span><?php _e( 'Tags:' ); ?></span> {{{ data.tags }}}</p>
    1003. 

  1003. 					<# } #>
    1004. 

  1004. 				</div>
    1005. 

  1005. 			</div>
    1006. 

  1006. 

  1007. 			<div class="theme-actions">
    1008. 

  1008. 				<# if ( data.active ) { #>
    1009. 

  1009. 					<button type="button" class="button button-primary customize-theme"><?php _e( 'Customize' ); ?></button>
    1010. 

  1010. 				<# } else if ( 'installed' === data.type ) { #>
    1011. 

  1011. 					<?php if ( current_user_can( 'delete_themes' ) ) { ?>
    1012. 

  1012. 						<# if ( data.actions && data.actions['delete'] ) { #>
    1013. 

  1013. 							<a href="{{{ data.actions['delete'] }}}" data-slug="{{ data.id }}" class="button button-secondary delete-theme"><?php _e( 'Delete' ); ?></a>
    1014. 

  1014. 						<# } #>
    1015. 

  1015. 					<?php } ?>
    1016. 

  1016. 

  1017. 					<# if ( data.compatibleWP && data.compatiblePHP ) { #>
    1018. 

  1018. 						<button type="button" class="button button-primary preview-theme" data-slug="{{ data.id }}"><?php _e( 'Live Preview' ); ?></button>
    1019. 

  1019. 					<# } else { #>
    1020. 

  1020. 						<button class="button button-primary disabled"><?php _e( 'Live Preview' ); ?></button>
    1021. 

  1021. 					<# } #>
    1022. 

  1022. 				<# } else { #>
    1023. 

  1023. 					<# if ( data.compatibleWP && data.compatiblePHP ) { #>
    1024. 

  1024. 						<button type="button" class="button theme-install" data-slug="{{ data.id }}"><?php _e( 'Install' ); ?></button>
    1025. 

  1025. 						<button type="button" class="button button-primary theme-install preview" data-slug="{{ data.id }}"><?php _e( 'Install &amp; Preview' ); ?></button>
    1026. 

  1026. 					<# } else { #>
    1027. 

  1027. 						<button type="button" class="button disabled"><?php _ex( 'Cannot Install', 'theme' ); ?></button>
    1028. 

  1028. 						<button type="button" class="button button-primary disabled"><?php _e( 'Install &amp; Preview' ); ?></button>
    1029. 

  1029. 					<# } #>
    1030. 

  1030. 				<# } #>
    1031. 

  1031. 			</div>
    1032. 

  1032. 		</div>
    1033. 

  1033. 	</script>
    1034. 

  1034. 	<?php
    1035. 

  1035. }
    1036. 

  1036. 

  1037. /**
    1038. 

  1038.  * Determines whether a theme is technically active but was paused while
    1039. 

  1039.  * loading.
    1040. 

  1040.  *
    1041. 

  1041.  * For more information on this and similar theme functions, check out
    1042. 

  1042.  * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
    1043. 

  1043.  * Conditional Tags} article in the Theme Developer Handbook.
    1044. 

  1044.  *
    1045. 

  1045.  * @since 5.2.0
    1046. 

  1046.  *
    1047. 

  1047.  * @param string $theme Path to the theme directory relative to the themes directory.
    1048. 

  1048.  * @return bool True, if in the list of paused themes. False, not in the list.
    1049. 

  1049.  */
    1050. 

  1050. function is_theme_paused( $theme ) {
    1051. 

  1051. 	if ( ! isset( $GLOBALS['_paused_themes'] ) ) {
    1052. 

  1052. 		return false;
    1053. 

  1053. 	}
    1054. 

  1054. 

  1055. 	if ( get_stylesheet() !== $theme && get_template() !== $theme ) {
    1056. 

  1056. 		return false;
    1057. 

  1057. 	}
    1058. 

  1058. 

  1059. 	return array_key_exists( $theme, $GLOBALS['_paused_themes'] );
    1060. 

  1060. }
    1061. 

  1061. 

  1062. /**
    1063. 

  1063.  * Gets the error that was recorded for a paused theme.
    1064. 

  1064.  *
    1065. 

  1065.  * @since 5.2.0
    1066. 

  1066.  *
    1067. 

  1067.  * @param string $theme Path to the theme directory relative to the themes
    1068. 

  1068.  *                      directory.
    1069. 

  1069.  * @return array|false Array of error information as it was returned by
    1070. 

  1070.  *                     `error_get_last()`, or false if none was recorded.
    1071. 

  1071.  */
    1072. 

  1072. function wp_get_theme_error( $theme ) {
    1073. 

  1073. 	if ( ! isset( $GLOBALS['_paused_themes'] ) ) {
    1074. 

  1074. 		return false;
    1075. 

  1075. 	}
    1076. 

  1076. 

  1077. 	if ( ! array_key_exists( $theme, $GLOBALS['_paused_themes'] ) ) {
    1078. 

  1078. 		return false;
    1079. 

  1079. 	}
    1080. 

  1080. 

  1081. 	return $GLOBALS['_paused_themes'][ $theme ];
    1082. 

  1082. }
    1083. 

  1083. 

  1084. /**
    1085. 

  1085.  * Tries to resume a single theme.
    1086. 

  1086.  *
    1087. 

  1087.  * If a redirect was provided and a functions.php file was found, we first ensure that
    1088. 

  1088.  * functions.php file does not throw fatal errors anymore.
    1089. 

  1089.  *
    1090. 

  1090.  * The way it works is by setting the redirection to the error before trying to
    1091. 

  1091.  * include the file. If the theme fails, then the redirection will not be overwritten
    1092. 

  1092.  * with the success message and the theme will not be resumed.
    1093. 

  1093.  *
    1094. 

  1094.  * @since 5.2.0
    1095. 

  1095.  *
    1096. 

  1096.  * @param string $theme    Single theme to resume.
    1097. 

  1097.  * @param string $redirect Optional. URL to redirect to. Default empty string.
    1098. 

  1098.  * @return bool|WP_Error True on success, false if `$theme` was not paused,
    1099. 

  1099.  *                       `WP_Error` on failure.
    1100. 

  1100.  */
    1101. 

  1101. function resume_theme( $theme, $redirect = '' ) {
    1102. 

  1102. 	list( $extension ) = explode( '/', $theme );
    1103. 

  1103. 

  1104. 	/*
    1105. 

  1105. 	 * We'll override this later if the theme could be resumed without
    1106. 

  1106. 	 * creating a fatal error.
    1107. 

  1107. 	 */
    1108. 

  1108. 	if ( ! empty( $redirect ) ) {
    1109. 

  1109. 		$functions_path = '';
    1110. 

  1110. 		if ( strpos( STYLESHEETPATH, $extension ) ) {
    1111. 

  1111. 			$functions_path = STYLESHEETPATH . '/functions.php';
    1112. 

  1112. 		} elseif ( strpos( TEMPLATEPATH, $extension ) ) {
    1113. 

  1113. 			$functions_path = TEMPLATEPATH . '/functions.php';
    1114. 

  1114. 		}
    1115. 

  1115. 

  1116. 		if ( ! empty( $functions_path ) ) {
    1117. 

  1117. 			wp_redirect(
    1118. 

  1118. 				add_query_arg(
    1119. 

  1119. 					'_error_nonce',
    1120. 

  1120. 					wp_create_nonce( 'theme-resume-error_' . $theme ),
    1121. 

  1121. 					$redirect
    1122. 

  1122. 				)
    1123. 

  1123. 			);
    1124. 

  1124. 

  1125. 			// Load the theme's functions.php to test whether it throws a fatal error.
    1126. 

  1126. 			ob_start();
    1127. 

  1127. 			if ( ! defined( 'WP_SANDBOX_SCRAPING' ) ) {
    1128. 

  1128. 				define( 'WP_SANDBOX_SCRAPING', true );
    1129. 

  1129. 			}
    1130. 

  1130. 			include $functions_path;
    1131. 

  1131. 			ob_clean();
    1132. 

  1132. 		}
    1133. 

  1133. 	}
    1134. 

  1134. 

  1135. 	$result = wp_paused_themes()->delete( $extension );
    1136. 

  1136. 

  1137. 	if ( ! $result ) {
    1138. 

  1138. 		return new WP_Error(
    1139. 

  1139. 			'could_not_resume_theme',
    1140. 

  1140. 			__( 'Could not resume the theme.' )
    1141. 

  1141. 		);
    1142. 

  1142. 	}
    1143. 

  1143. 

  1144. 	return true;
    1145. 

  1145. }
    1146. 

  1146. 

  1147. /**
    1148. 

  1148.  * Renders an admin notice in case some themes have been paused due to errors.
    1149. 

  1149.  *
    1150. 

  1150.  * @since 5.2.0
    1151. 

  1151.  *
    1152. 

  1152.  * @global string $pagenow
    1153. 

  1153.  */
    1154. 

  1154. function paused_themes_notice() {
    1155. 

  1155. 	if ( 'themes.php' === $GLOBALS['pagenow'] ) {
    1156. 

  1156. 		return;
    1157. 

  1157. 	}
    1158. 

  1158. 

  1159. 	if ( ! current_user_can( 'resume_themes' ) ) {
    1160. 

  1160. 		return;
    1161. 

  1161. 	}
    1162. 

  1162. 

  1163. 	if ( ! isset( $GLOBALS['_paused_themes'] ) || empty( $GLOBALS['_paused_themes'] ) ) {
    1164. 

  1164. 		return;
    1165. 

  1165. 	}
    1166. 

  1166. 

  1167. 	printf(
    1168. 

  1168. 		'<div class="notice notice-error"><p><strong>%s</strong><br>%s</p><p><a href="%s">%s</a></p></div>',
    1169. 

  1169. 		__( 'One or more themes failed to load properly.' ),
    1170. 

  1170. 		__( 'You can find more details and make changes on the Themes screen.' ),
    1171. 

  1171. 		esc_url( admin_url( 'themes.php' ) ),
    1172. 

  1172. 		__( 'Go to the Themes screen' )
    1173. 

  1173. 	);
    1174. 

  1174. }
    1175. 

  1175.